User:Remember the dot/Syntax highlighter/ca



He creat un script que fa que la sintaxi ressalti coloridament en la caixa d'edició. A diferència d'altres scripts de ressalt com a wikEd, AceWikiEditor i CodeMirror, aquest:
 * Actualitza el ressalt automàticament mentre escrius.
 * No espatlla els botons Desfés i Refés.
 * No espatlla la correcció ortogràfica.
 * És compatible amb la majoria de scripts que afecten la caixa d'edició.

Instal·lació
Assegura't de llegir la secció "Problemes coneguts" abaix abans d'instal·lar el script.

Per l'usuari si està instal·lat en la wiki
Si el ressaltador de sintaxi ja està disponible com a giny en la teva wiki, vés a les teves preferències i activa-ho.

Per l'usuari si no està instal·lat en la wiki
Si instal·lació com a giny no està disponible, afegeix aquestes línies a la teva pàgina de common.js:

Per exemple, si la Wikipedia catalana no proporcionés el ressaltador com a giny, el afegiries a https://ca.wikipedia.org/wiki/Usuari:El_teu_nom_d'usuari/common.js

Pels administradors de sitis de Wikimedia
En la teva wiki, crea la pàgina MediaWiki:Gadget-DotsSyntaxHighlighter.js‎ amb el codi

Llavors afegeix a la pàgina MediaWiki:Gadgets-definition‎ una nova línia *DotsSyntaxHighlighter[ResourceLoader|default]|DotsSyntaxHighlighter.js i crea la pàgina MediaWiki:Gadget-DotsSyntaxHighlighter‎ amb el text Ressalt de sintaxis: Fa que la sintaxi ressalti coloridament en la caixa d'edició.

Pels administradors de sitis no de Wikimedia
En la teva wiki, crea la pàgina MediaWiki:Gadget-DotsSyntaxHighlighter.js‎ i copia-hi el codi font d'User:Remember the dot/Syntax highlighter.js. Llavors afegeix a la pàgina MediaWiki:Gadgets-definition‎ una nova línia *DotsSyntaxHighlighter[ResourceLoader|default]|DotsSyntaxHighlighter.js i crea la pàgina MediaWiki:Gadget-DotsSyntaxHighlighter‎ amb el text Ressalt de sintaxis: Fa que la sintaxi ressalti coloridament en la caixa d'edició.

Cal MediaWiki 1.22 o més nou.

Compatabilitat

 * 1) El ressaltador funciona millor en la versió més actual de Firefox.
 * 2) El ressaltador funciona casi tot el temps en el Chrome, el Safari i l'Opera, però no funciona correctament amb text en certs alfabets, notablement tailandès i tibetà.
 * 3) El ressaltador no funciona en l'Internet Explorer (les seves fallades són massa greus). El ressaltador ni intenta executar si se detecta l'Internet Explorer.
 * 4) El ressaltador no és compatible amb alguns scripts que afecten la caixa d'edició.

Sintaxis

 * 1) Per motius de rendiment, el ressaltador exigeix que totes les etiquetes siguin etiquetes vàlides XML. Per exemple, assegura't que si comences una etiqueta   que la terminis amb , i usa   en lloc de.
 * 2) Per motius de rendimient, el ressaltador no pot manecar   o  &mdash;els considera sintaxis invàlida. Suggereixo usar   y   en lloc.
 * 3) Una etiqueta   creada per col·locar un espai al principi d'una línia no es ressaltarà. Això es deu a que el ressaltador no es prou intel·ligent per a saber si l'espai compta com a espai en blanc dins d'una plantilla o no.
 * 4) Controladors de comportament com   no es ressalten.
 * 5) Els enllaços externs creats amb   o plantilles no es ressalten. Veuràs   en lloc de.

Miscel·lània

 * 1) El ressaltador no funciona ràpidament al editar articles llargs i es desactivarà automàticament si triga més de 50ms.
 * 2) El ressaltador no funciona en pujar fitxers.
 * 3) El ressaltador pot anular els teus estils personals relacionats a la caixa d'edició.

Llista de colors
És fàcil canviar els colors de ressalt o fer que no es ressaltin certs sintaxis. Els següents personalitzacions de color estan disponibles:

Per exemple, per a fer cians els enllaces wiki i taronges els enllaces externs, posa ho següent en el teu common.js (si has instal·lat el ressaltador com a giny, omet les primeres dos línies):

Per a no ressaltar un sintaxi, fes el seu color. Per exemple, per a desactivar el ressalt d'enllaços externs:

Per a no ressaltar cap sintaxi a més dels que explícitament vulguis, fes que  sigui   i especifica el color de cada sintaxi que vulguis ressaltar. Si només vols el color usual, posa. Per exemple, per a només ressaltar les etiquetes:

Temps d'espera
Pots especificar un  que reemplaça el temps d'espera per defecte de 50ms. Per exemple, si no et molesta la lentitud en teclejar i vols inhabilitar el ressalt només si triga més de 75ms, posa ho següent en el teu common.js:

Altra vegada, si has instal·lat el ressaltador com a giny, omet les primeres dos línies.

Reportació d'errors

 * Nota: Acorda't de comprovar si el error que voleu reportar ja és un problema conegut.

En reportar-me un error, si's plau inclou:
 * Una descripció detallada del problema.
 * Un enllaç a una pàgina on es veu l'error, o una mostra de wikitext que provoca el problema.
 * La informació User-Agent del teu navegador.
 * El skin de MediaWiki que uses.
 * Una llista dels ginys que tens habilitats.
 * Una llista de tot el JavaScript o CSS personalitzat que tens habilitat.
 * Una llista de totes les extensions de navegador que tens habilitat.

Més informació
Per més informació, incloent com obtenir el codi font i un resum del mètode del script, veges ../.