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 de altres scripts de ressalt com a wikEd i AceWikiEditor, 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 de instal·lar el script.

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

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

Per exemple, si la Wikipedia castellana no proporcionés el ressaltador com giny, el afegiries a https://es.wikipedia.org/wiki/Usuario:ElTeuNomDeUsuari/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 Fa que la sintaxi ressalti coloridament en la caixa d'edició.

MediaWiki 1.22 o més nou
En la teva wiki, crea la pàgina MediaWiki:Gadget-DotsSyntaxHighlighter.js‎ i copia-li el codi font de 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 Fa que la sintaxi ressalti coloridament en la caixa d'edició.

MediaWiki 1.21 o més vell
En adició als passos per MediaWiki 1.22, afegeix el següent a MediaWiki:common.js:

Assegura't de treure aquest codi deprés d'actualitzar al 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 Chrome i Opera, però no funciona correctament amb text en certs alfabets, notablement tailandès i tibetà.
 * 3) No he pogut provar Safari, però ha de funcionar igual que Chrome.
 * 4) El ressaltador no funciona en Internet Explorer (les seves fallades són massa greus).
 * 5) Pot que el ressaltador se erra si no visualitzes la pàgina a la ampliació normal.
 * 6) 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 etiquetas siguin etiquetas vàlides XML. Per exemple, assegura't que si comences una etiqueta   que la terminis amb , i utilitza   en lloc de.
 * 2) Per motius de rendimient, el ressaltador no pot manecar   o  &mdash;els considera sintáxis inválida. Suggereixo utilitzar   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 suficientment intel·ligent per saber si l'espai compta com a espai en blanc dins d'una plantilla o no.
 * 4)   etcètera no es ressalten.

Misceláneo

 * 1) El ressaltador no funciona ràpidament al editar articles llargs i es desactivarà automàticament si triga més de 100ms.
 * 2) El ressaltador no funciona al pujar fitxers.
 * 3) El ressaltador pot anular els teus estils personals relacionats a la caixa de edició.
 * 4) Potser els colors que vaig escollir no són gaire atractius. Feedback d'un dissenyador gràfic seria apreciat ;-)

Personalització
És fàcil canviar els colors de ressalt o fer que no es ressalten certs sintaxis. Per exemple, per a fer cians els enllaces wiki i taronjes els enllaces externs, podries posar:

Si has instal·lat el ressaltador com giny, les primeres dos línies no són necessàries.

Per no ressaltar un sintaxi, fes el seu color. Per exemple, per desactivar el ressalt de enllaces externs:

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

A més a més, pots especificar un  que reemplaça el temps d'espera per defecte de 100ms. Per exemple:

Llista de colors
Els següents personalitzacions estan disponibles:

Reportació de errors
Al reportar-me un error, si's plau inclou:
 * Molts detalls sobre en quines circumstàncies es succeeix el problema.
 * La informació User-Agent del teu navegador.
 * El skin de MediaWiki que utilitzes.

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