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 y AceWikiEditor, 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 Hace que la sintaxis resalte coloridamente en la caja de edición.

MediaWiki 1.22 o más nuevo
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 Hace que la sintaxis resalte coloridamente en la caja de edición.

MediaWiki 1.21 o más antiguo
En adición a los pasos para MediaWiki 1.22, añade lo siguiente a MediaWiki:common.js:

Asegúrate de quitar este código después de actualizar al 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 i Opera, pero no funciona correctamente con texto en ciertos alfabetos, notablemente tailandés y tibetano.
 * 3) No he podido probar Safari, pero debe funcionar igual que Chrome.
 * 4) El resaltador no funciona en Internet Explorer (sus fallos son demasiado graves).
 * 5) Puede que el resaltador se erra si no visualizas la página a la ampliación normal.
 * 6) El resaltador no es compatible con algunos scripts que afecten la caja de edición.

Sintáxis

 * 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   creado 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)   etcétera no se resaltan.

Misceláneo

 * 1) El resaltador no funciona rápidamente al editar artículos largos y se deshabilitará automáticamente si tarda más de 100ms.
 * 2) El resaltador no funciona al subir archivos.
 * 3) El resaltador puede anular tus estilos personales relacionados a la caja de edición.
 * 4) Puede que los colores que eligí no sean muy atractivos. Feedback de un diseñador gráfico se apreciaría ;-)

Personalización
Es fácil cambiar los colores de resalto o hacer que no se resalten ciertos sintaxis. Por ejemplo, para hacer cian los enlaces wiki y anaranjados los enlaces externos, podrías poner:

Si has instalado el resaltador como accesorio, no hacen falta 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 ningúna 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:

Además, puedes especificar un  que reemplace el tiempo de espera por defecto de 100ms. Por ejemplo:

Lista de colores
Se disponen las siguientes personalizaciones:

Reportación de errores
Al reportarme un error, por favor incluye:
 * Mucha detalle sobre las circunstancias en que se ocurre el problema.
 * La información User-Agent de tu navegador.
 * La skin de MediaWiki que usas.

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