User:Remember the dot/Syntax highlighter/es



He creado un script que hace que la sintaxis resalte coloridamente en la caja de edición. A diferencia de otros scripts de resalto de sintaxis como wikEd, AceWikiEditor y CodeMirror, este:


 * Actualiza el resalto automáticamente mientras tecleas.
 * No estropea los botones Deshacer y Rehacer.
 * No estropea el corrector ortográfico.
 * Es compatible con la mayoría de scripts que afecten la caja de edición.

Instalación
Asegúrate de leer la sección "Problemas conocidos" abajo antes de instalar el script.

Para el usuario si está instalado en la wiki
Si el resaltador de sintaxis está disponible como accesorio en tu wiki, ve a tus preferencias y habilítalo.

Para el usuario si no está instalado en la wiki
Si instalación como accesorio no está disponible, añade estas líneas a tu página de common.js:

Por ejemplo, si la Wikipedia castellana no proveyera el resaltador de sintaxis como accesorio, lo añadirías a https://es.wikipedia.org/wiki/Usuario:TuNomDeUsuario/common.js

Para administradores de sitios de Wikimedia
En tu wiki, crea la página MediaWiki:Gadget-DotsSyntaxHighlighter.js‎ con el código

Entonces añade a la página MediaWiki:Gadgets-definition‎ una nueva línea *DotsSyntaxHighlighter[ResourceLoader|default]|DotsSyntaxHighlighter.js y crea la página MediaWiki:Gadget-DotsSyntaxHighlighter‎ con el texto Resaltador de sintaxis: Hace que la sintaxis resalte coloridamente en la caja de edición.

Para administradores de sitios no de Wikimedia
En tu wiki, crea la página MediaWiki:Gadget-DotsSyntaxHighlighter.js‎ y copia a ella el código fuente de User:Remember the dot/Syntax highlighter.js. Entonces añade a la página MediaWiki:Gadgets-definition‎ una nueva línea *DotsSyntaxHighlighter[ResourceLoader|default]|DotsSyntaxHighlighter.js y crea la página MediaWiki:Gadget-DotsSyntaxHighlighter‎ con el texto Resaltador de sintaxis: Hace que la sintaxis resalte coloridamente en la caja de edición.

Se require MediaWiki 1.22 o más nuevo.

Compatibilidad

 * 1) El resaltador funciona mejor en la versión actual de Firefox.
 * 2) El resaltador funciona casi todo el tiempo en las versiones actuales de Chrome, Safari y Opera, pero no funciona correctamente con texto en ciertos alfabetos, notablemente tailandés y tibetano.
 * 3) El resaltador no funciona en Internet Explorer (sus fallos son demasiado graves). El resaltador ni intenta executar si se detecta Internet Explorer.
 * 4) El resaltador no es compatible con algunos scripts que afecten la caja de edición.

Sintaxis

 * 1) Por motivos de rendimiento, el resaltador exige que todas las etiquetas sean etiquetas XML válidas. Por ejemplo, asegúrate que si empiezas una etiqueta   la termines con , y usa   en vez de.
 * 2) Por motivos de rendimiento, el resaltador no puede manejar   o  &mdash;los considera sintáxis inválida. Sugiero usar   y   en su lugar.
 * 3) Una etiqueta   creada por colocar un espacio al principio de una línea no se resaltará. Esto se debe a que el resaltador no es bastante inteligente para saber si el espacio cuenta como espacio blanco dentro de una plantilla o no.
 * 4) Opciones de comportamiento como   no se resaltan.
 * 5) Las enlaces externas creadas con   o plantilles no se resaltan. Verás   en vez de.

Misceláneos

 * 1) El resaltador no funciona rápidamente al editar artículos largos y se deshabilitará automáticamente si tarda más de 50ms. Si esto ocurre, un mensaje aparece que explica lo que pasó y sugiere cómo trabajar alrededor o augmentar el tiempo de espera.
 * 2) El resaltador no funciona al subir archivos.
 * 3) El resaltador puede anular tus estilos personales relacionados a la caja de edición.

Colores
Es fácil cambiar los colores de resalto o hacer que no se resalten ciertos sintaxis. Se disponen las siguientes personalizaciones de color:

Por ejemplo, para hacer cian los enlaces wiki y anaranjados los enlaces externos, pon lo siguiente en tu common.js (si has instalado el resaltador como accesorio, omite las primeras dos líneas):

Para no resaltar un sintaxis, haz su color. Por ejemplo, para deshabilitar el resalto de enlaces externos:

Para no resaltar ninguna sintaxis aparte de los que explícitamente quieras, haz que  sea   y especifica el color de cada sintaxis que quieras resaltado. Si solo quieres el color usual, pon. Por ejemplo, para solo resaltar las etiquetas:

Tiempo de espera
Puedes especificar un  que reemplace el tiempo de espera por defecto de 50ms. Por ejemplo, si no te molesta la lentitud al teclear y quieres deshabilitar el resalto de sintaxis solo si tarda más de 75ms, pon lo siguiente en tu common.js:

Reportación de errores

 * Nota: Acuérdate de comprobar si el error que quieres reportar ya es un problema conocido.

Al reportarme un error, por favor incluye:
 * Una descripción detallada del problema.
 * Una enlace a una página donde se ve el error, o una mostra de wikitexto que provoca el problema.
 * La información User-Agent de tu navegador.
 * La skin de MediaWiki que usas.
 * Una lista de los accesorios que tienes habilitados.
 * Una lista de todo el JavaScript o CSS personalizado que tienes habilitado.
 * Una lista de todas las extensiones de navegador que tienes habilitados.

Más información
Para más información, incluso cómo obtener el código fuente y un resumo del método del script, véase ../.