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 en español no proveyera el resaltador de sintaxis como accesorio, lo añadirías a https://es.wikipedia.org/wiki/Usuario:Tu_Nombre_de_Usuario/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|dependencies=jquery.client]|DotsSyntaxHighlighter.js y crea la página MediaWiki:Gadget-DotsSyntaxHighlighter‎ con el texto Resalto 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|dependencies=jquery.client]|DotsSyntaxHighlighter.js y crea la página MediaWiki:Gadget-DotsSyntaxHighlighter‎ con el texto Resalto de sintaxis: Hace que la sintaxis resalte coloridamente en la caja de edición.

Se requiere 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 siempre 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 ni Edge (sus fallos son demasiado graves). El resaltador ni intenta ejecutar si se detecta uno de estos navegadores.
 * 4) El resaltador no es compatible con algunos accesorios, extensiones de navegador y otras personalizaciones.

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) Los enlaces externos creados con   o plantillas 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:

Si has instalado el resaltador como accesorio, omite las primeras dos líneas.

Etiquetes no de wikitexto
Varias etiquetas, como  i , no usan wikitexto y, por tanto, no se resalta ninguna sintaxis dentro de estas etiquetas. Puedes personalizar la lista de etiquetas como source por establir  a un vector de nombres de etiquetas. Por ejemplo, para deshabilitar el resalto de sintaxis dentro de la etiqueta hipotética  además de las por defecto, pon lo siguiente en tu common.js:

Otras etiquetas, como  y , no usan wikitexto pero sí procesan entidades de carácter (  por ejemplo). La propiedad  controla la lista de etiquetas como nowiki. Por ejemplo, para resaltar solo las entidades de carácter dentro de la etiqueta, pon lo siguiente en tu common.js:

En ambos ejemplos, has instalado el resaltador como accesorio, omite las primeras dos líneas.

Valores por defecto del sitio
Todas las propiedades que se pueden especificar en la variable  también se pueden especificar en la variable. es para los valores por defecto del sitio y  para las preferéncias del usuario. Las propiedades de  prevalecen sobre las propiedades de , y las propiedades de   prevalecen sobre los valores por defecto internos.

Por ejemplo, si tu sitio no tiene instalada ninguna extensión de MediaWiki, tal vez quieres quitar el soporte para etiquetas como source. Para hacer eso, añade lo siguiente al final de MediaWiki:Gadget-DotsSyntaxHighlighter‎:

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 ../.