Viquipèdia:Finestres emergents de navegació

De Viquipèdia
Dreceres ràpides: navegació, cerca
Exemple de visualització d'una finestra emergent de navegació

Les finestres emergents de navegació o popups de navegació són una facilitat en javascript dissenyada per a ajudar els usuaris de les wikis de la Fundació Wikimedia. Bàsicament, ofereixen un accés ràpid i senzill a unes quantes funcions bàsiques mitjançant unes finestres emergents que apareixen quan deixeu el cursor sobre un enllaç intern.

Instalació ràpida:[modifica | modifica el codi]

Per a instalar la versió catalana del codi, escriviu {{subst:popups}} al vostre arxiu monobook.

Facilitats[modifica | modifica el codi]

  • Previsualitzar el principi del text d'una pàgina.
  • Previsualitzar imatges des dels seus enllaços.
  • Previsualitzar la primera imatge de cada pàgina.
  • Previsualitzar les diferències en llistes de seguiment, historials i seguiment d'enllaços.
  • Previsualitzar els "wikilinks" mentre s'està editant una pàgina (utilitzeu el cursor per a seleccionar el text de l'enllaç).
  • Revertir vandalismes des de la plana d'historial amb un sol clic.
  • Identificació de redireccions, esborranys i desambiguacions.
  • Informació de les pàgines tals com mida, nombre d'enllaços, nombre d'imatges, nombre de categories i antiguitat de la pàgina.
  • Funciona en tots els projectes de Wikimedia (Viccionari, Viquinotícies, Viquidites...)
  • Amb un sol clic s'accedeix a:
    • editar la pàgina.
    • les contribucions d'un usuari.
    • comptar les edicions d'un usuari.
    • enviar correu electrònic a un usuari.
    • l'historial.
    • afegir o treure de la llista de seguiment.
    • veure, editar i afegir un nou tema a la plana de discussió.
    • el que enllaça aquí.
    • seguiment d'enllaços.
    • per als administradors: protegir, desprotegir i esborrar planes i blocar usuaris.
    • el registre de l'usuari i el registre de blocatges.
    • la llista de subpàgines de l'espai d'usuari.
    • Cerca a la viquipèdia, global Cerca global a totes les wikipèdies i cerca a Google.
  • Dreceres de teclat (opcional).
  • Correcció automàtica d'enllaços a pàgines de desambiguació i de redireccions dobles (opcional).

Instal·lació[modifica | modifica el codi]

Heu de ser un usuari registrat per tal de poder utilitzar les finestres emergents de navegació. Si no teniu un compte a la Viquipèdia, registreu-vos i entreu amb el vostre nom d'usuari.

Si voleu instal·lar-vos la versió en català de la facilitat, escriviu el codi {{subst:popups}} a la vostra subpàginaarxiu vector.js. Això farà que s'afegeixi a la vostra plana javascript el codi:

 mw.loader.load("//ca.wikipedia.org/w/index.php?title=User:SMP/strings-ca.js&action=raw&ctype=text/javascript&dontcountme=s");
 mw.loader.load("//en.wikipedia.org/w/index.php?title=User:Lupin/popups.js&action=raw&ctype=text/javascript&dontcountme=s");

Si voleu instal·lar la versió anglesa haureu d'escriure el codi següent:

 mw.loader.load("//en.wikipedia.org/w/index.php?title=User:Lupin/popups.js&action=raw&ctype=text/javascript&dontcountme=s");

Nota: Si esteu fent servir una aparença diferent a la Vector (la que surt per defecte) en la vostra configuració d'usuari, la subpàgina al que haureu d'afegir el codi serà:

Després de guardar la pàgina haureu de esborrar la memòria cau del vostre navegador. Per a fer-ho premeu SHIFT + el botó d'actualitzar o bé cliqueu aquí. Per a que les finestres emergents de navegació apareiguin heu de tenir activat el javascript en el vostre navegador. Un cop instal·lat, una finestra emergent apareixerà quan deixeu el cursor sobre un enllaç intern de la Viquipèdia.

Per a instal·lar el script en els projectes germans (viccionari, viquinotícies, commons...) repetiu el mateix procediment. Si voleu desinstal·lar-ho simplement esborreu les línies corresponents en la mateixa pàgina i torneu a esborrar la memòria cau del vostre navegador.

Guia d'ús[modifica | modifica el codi]

Aquesta eina genera pantalles emergents quan es deixa el cursor del ratolí sobre un enllaç intern de la Viquipèdia o sobre una imatge.

En els historials, en la pàgina de canvis recents, en les llistes de seguiment i en moltes pàgines especials tindreu aquestes facilitats:

  • Si deixeu el cursor sobre un enllaç que mostri les diferències entre dues versions d'una pàgina podreu visualitzar aquests canvis.
  • Si deixeu el cursor sobre un enllaç a una versió antiga d'una plana podreu veure les característiques d'aquella versió.

A més, tindreu alguns "enllaços de navegació" que us permetran accedir a diferents funcions com per exemple reversions amb un sol clic, editar directament aquella plana i similars. Aquests enllaços us apareixeran en la mateixa finestra emergent o bé estaran ocults en un menú d'accions depenent del vostre navegador i de la configuració dels popups.

En el text dels pàgines normals podreu fer:

  • Si deixeu el cursor sobre un enllaç intern veureu el seu començament. A més, podreu entrar al menú d'accions per a veure més comandaments.
  • Si premeu el botó "Maj." (Shift) podreu moure la finestra emergent.

Configuració (opcional)[modifica | modifica el codi]

Canviar l'aparença de les finestres[modifica | modifica el codi]

Editant el vostre arxiu CSS, podreu canviar l'aparença de les vostres finestres emergents. L'arxiu CSS que haureu de modificar tindrà exactament el mateix nom que l'ariu javascript, però amb "css" en lloc de "js" al seu final. Per això, per a la majoria de gent l'arxiu que s'haurà d'editar es dirà monobook.css.

Aquí teniu un exemple de com configurar-ho. El codi que ve a continuació us mostrarà unes finestres de color taronja amb un requadre exterior i amb canvis en la font de la lletra. Aquest codi faria que les vostres finestres tiguessin un estil bastant lleig, però us pot ajudar a entendre com s'ha de fer per a modificar l'aparença de les vostres finestres emergents.

.navpopup { 
  background-color: #FFBE20  !important;
  font-family:      serif    !important;
  color:            #404     !important;
  font-size:        medium   !important;
}

Opcions[modifica | modifica el codi]

Hi ha un bon nombre d'opcions que poden ésser modificades. Per a fer-ho, editeu el vostre arxiu javascript (normalment monobook.js) i afegiu-hi una línia amb la forma:

opció = valor;

on l'opció i el valor s'han escollit de la taula que hi ha a sota. Per exemple, per a utilitzar la opció de popups simples i activar les opcions d'administrador, hauríeu de tenir en el vostre arxiu javascript:

 document.write('<script type="text/javascript" src="' 
    + 'http://ca.wikipedia.org/w/index.php?title=User:SMP/strings-ca.js' 
    + '&action=raw&ctype=text/javascript&dontcountme=s"></script>');
 document.write('<script type="text/javascript" src="' 
    + 'http://en.wikipedia.org/w/index.php?title=User:Lupin/popups.js' 
    + '&action=raw&ctype=text/javascript&dontcountme=s"></script>');

simplePopups=true;
popupAdminLinks=true;
Opcions de configuració
Opció Valors* Descripció
popupDelay un nombre decimal (amb un . com a coma decimal), 0.5 El temps en segons abans de que emergeixi la finestra.
popupHideDelay un nombre decimal (amb un . com a coma decimal), 0.5 El temps en segons per a que desapareixi la finestra després d'haver retirat el cursor.
simplePopups true (sí), false (no) Opció de popups simples. Només us apareixeran els enllaços a les opcions i no previsualitzareu la pàgina ni la seva imatge.
popupStructure 'original', 'fancy', 'fancy2', 'menus', 'shortmenus', 'lite' Selecciona l'estructura de les finestres. La versió 'original', per defecte si useu els popups simples, (o si el vostre navegador no accepta menús), té tots els enllaços en la mateixa finestra; 'fancy' i 'fancy2' són variants d'aquesta versió. La versió 'menus', per defecte si no teniu popups simples, insereix els enllaços de navegació dins uns menús que apareixeran quan deixeu el cursor sobre el seu títol. 'shortmenus' és una versió de 'menus' amb menys enllaços. Per últim, la versió 'lite' és molt simple i no conté enllaços de navegació. Fixeu-vos que aquesta variable ha d'anar entre apòstrofs (per exemple: popupStructure='fancy';).
popupActionsMenu true (sí), false (no) When using menus, you can either have the title link in the popup generating a menu (if this is set to false) or a separate "actions" menu (if this is set to true, the default).
popupImages true (sí), false (no) Si està desactivat (false) no es mostraran les imatges.
popupSubpopups true (sí), false (no) Si està activat (true) es generaran les finestres en enllaços de previsualitzacions.
popupOnEditSelection true (sí), false (no) Si està activat (true) es generaran les finestres en els codis d'enllaços seleccionats mentre s'està editant.
popupAdminLinks true (sí), false (no) Si està activat (true) apareixeran enllaços on els administradors poden blocar usuaris, esborrar pàgines i protegir o desprotegir pàgines. Aquests enllaços apareixeran però no tindran cap utilitat si no sou administrador.
popupShortcutKeys true (sí), false (no) Si està activat (true) podreu marcar alguns enllaços de la finestra emergent mitjançant dreceres del teclat. La drecera corresponent apareixerà amb el comentari d'ajuda de quan deixeu el cursor sobre un enllaç.
popupFixRedirs true (sí), false (no) Si està activat (true) podreu "arreglar" enllaços a redireccions clicant sobre "Redirects". Nota: No editeu mai una pàgina només per a arreglar un enllaç! A més, no tots els enllaços cap a una redireccio s'haurien d'arreglar. N'hi ha molts que és preferible que enllaçin cap a la redirecció.
popupWatchRedirredPages true (sí), false (no), null (nul) Si està activat (true) s'afegiran a la vostra llista de seguiment aquelles redireccions que hàgiu arreglat; si està desactivat (false), s'esborraran de la llista. Si teniu l'opció nul·la (null), dependrà de les vostres preferències.
popupRedirAutoClick 'wpSave' (guardar), 'wpPreview' (previsualitzar), 'wpDiff'(canvis) L'opció que es clicarà automàticament quan arregleu redireccions.
popupRedlinkRemoval true (sí), false (no) Si està activat (true) us apareixerà una opció per esborrar els enllaços en vermell cap a pàgines inexistents (això no és gaire recomanable en la majoria d'enllaços).
popupFixDabs true (sí), false (no) Si està activat (true), us apareixerà una opció per arreglar els enllaços cap a pàgines de desambiguació. Recordeu que no tots els enllaços cap a una plana de desambiguació han de ser canviats.
popupWatchDisambiggedPages true (sí), false (no), null (nul) Si està activat (true) s'afegiran a la vostra llista de seguiment aquelles desambiguacions que hàgiu arreglat; si està desactivat (false), s'esborraran de la llista. Si teniu l'opció nul·la (null), dependrà de les vostres preferències.
popupNavLinks true (sí), false (no) Si està activat (true) els enllaços de navegació estaran activats.
popupLastEditLink true (sí), false (no) Per escollir si voleu un enllaç de navegació cap a l'última edició.
popupHistoricalLinks true (sí), false (no) Si està activat (true) tindreu més opcions en els enllaços a versions antigues quan estigueu en un historial, en una pàgina de canvis, en la llista de seguiment o en els canvis recents.
popupPreviews true (sí), false (no) Si està activat (true) i no utilitzeu l'opció de popups simples, podreu visualitzar el principi de cada pàgina al deixar el cursor sobre un enllaç.
popupSummaryData true (sí), false (no) Si està activat (true) se us mostrarà el resum d'edició.
popupLastModified true (sí), false (no) Si està activat (true) a dalt de la finestra emergent us sortirà la informació de quan va ser l'última modificació de la pàgina.
popupDiffDates true (sí), false (no) Si està activat (true)se us mostraran les dades de les revisions que estigueu comparant quan previsualitzeu la diferència entre dues revisions.
popupImageLinks true (sí), false (no) Si està activat (true) se us mostraran les pàgines que contenen la imatge quan n'estigueu previsualitzant una. Actualment aquesta opció no funciona per a imatges de commons.
popupOnlyArticleLinks true (sí), false (no) Si està activat (true), només apareixeran popups en els enllaços de la pàgina. En cas contrari (molt recomanat), també n'apareixeran en els altres enllaços (com Historial).
imagePopupsForImages true, false By default, preview images are loaded even when hovering over visible images. Setting this to false turns that off.
popupMaxWidth 350, an integer or false The maximum width of the popup in pixels. Setting this to false means the popup will expand to accommodate its contents.
popupInitialWidth an integer or false The initial width of the popup in pixels. Setting this to false means the popup will initially be the size needed to accommodate its initial contents.
popupEditCounterTool "kate", "interiot", "custom" Podeu triar quina web externa es farà servir quan vulgueu comptar les edicions d'usuaris. Si escolliu "custom" s'utilitzarà la que hàgiu definit a popupEditCounterUrl.
popupEditCounterUrl "" La direcció URL de la pàgina web amb la que vulgueu contar les edicions d'usuari si el paràmetre popupEditCounterTool està definit com a "custom". En la direcció podeu usar els paràmetres: $1 per al nom d'usuari i $2 per a la base de dades (cawiki_p per a la Viquipèdia).
Editar resums d'edició
popupRevertSummary una línia de text entre apòstrofs (') El camp "resum d'edició" que apareixerà automaticament quan revertiu. El primer codi %s que hi escriviu serà substituït pel nombre de la versió a la que esteu revertint.
popupRevertSummaryPrompt true (sí), false (no) Si està activat (true) podreu canviar el resum d'edició que surt per defecte en cada reversió.
popupFixRedirsSummary una línia de text entre apòstrofs (') El camp "resum d'edició" que apareixerà automaticament quan arregleu redireccions. El primer codi %s que hi escriviu serà substituït pel títol de la pàgina redirigida. En el segon %s hi apareixerà la pàgina destí.
popupFixDabsSummary una línia de text entre apòstrofs (') El camp "resum d'edició" que apareixerà automaticament quan desambigueu enllaços. El primer codi %s que hi escriviu serà substituït pel títol de la pàgina de desambiguació. En el segon %s hi apareixerà la pàgina destí.
popupRedlinkSummary una línia de text entre apòstrofs (') El camp "resum d'edició" que apareixerà automaticament quan esborreu enllaços en vermell. El primer codi %s que hi escriviu serà substituït pel títol de l'enllaç esborrat.
Opcions de visualització
popupPreviewKillTemplates true (sí), false (no) Si està activat (true), Les plantilles dins una pàgina no es mostraran en les finestres emergents. En cas contrari apareixeran com a text simple.
popupPreviewRawTemplates true (sí), false (no) Si està activat (true), en els enllaços a plantilles, aquestes es mostraran amb el text del seu codi. En cas contrari, s'intentarà mostrar una visualització del seu aspecte.
popupPreviewFirstParOnly true (sí), false (no) Si està activat (true), només visualitzareu el primer paràgraf d'una pàgina en la finestra emergent.
popupMaxPreviewSentences un nombre enter, 4 El nombre màxim de frases que contindrà la previsualització de la pàgina en la finestra emergent.
popupMaxPreviewCharacters un nombre enter, 600 El nombre màxim de caràcters que contindrà la previsualització de la pàgina en la finestra emergent.
Opcions tècniques
popupNavLinkSeparator string,
' &sdot; '
Codi HTML situat entre els enllaços de navegació. S'hauria de posar ' &bull; ' al Konqueror i ' &#183; ' als navegadors de Microsoft, ja que sembla que no accepten el caràcter &sdot;.
popupAppendRedirNavLinks true (sí), false (no) Si està activat (true), es generaran nous enllaços de navegació per a la pàgina destinació d'una redirecció. Si teniu desavtivat el popupNavLinks aquesta opció no farà res.
removeTitles true, false Els títols de les finestres seran enllaços cap a la pàgina corresponent.
Opcions en fase experimental
Les següents opcions encara no s'han acabat de provar: popupLiveOptions, popupCookies, popupUnsimplifyLink, popupExtraUserMenu, popupLinksNewWindow, popupHistoryLimit, popupDiffDatePrinter, popupExtendedRevertSummary, popupTimeOffset. Una manera fàcil de provarles és ajustant popupLiveOptions=true.

*En negreta apareixen els valors que es prendran per defecte si no poseu aquesta opció.

Problemes amb navegadors[modifica | modifica el codi]

Safari[modifica | modifica el codi]

Sembla que el navegador Safari té força problemes si s'utilitza aquest script. En aquests moments s'està intentant arreglar-ho.

Opera[modifica | modifica el codi]

Les versions actuals del navegador Opera tenen defectes que impedeixen que els submenús de les finestres emergents funcionin correctament. Això força a que es vegin amb l'estructura 'original'. Utilitzar la versió 9 beta hauria de permetre que funcionin millor, tot i que encara poden mantenir errors.

Traduccions[modifica | modifica el codi]

Aquesta utilitat és fàcilment traduïble a altres idiomes. Si voleu consultar la llista de totes les traduccions o bé en voleu començar una de nova, llegiu la pàgina corresponent en la Viquipèdia anglòfona.

Contacte[modifica | modifica el codi]

Per a qualsevol suggeriment, problema o dubte en relació amb aquesta facilitat contacteu amb l'usuari Lupin de la wikipedia anglòfona. Hi ha una pàgina on es poden llistar els llocs on falla el script.

Per a qualsevol suggeriment, problema o dubte amb la traducció al català de les finestres, contacteu amb l'usuari SMP o bé comenteu-ho en la plana Usuari Discussió:SMP/strings-ca.js.

Vegeu també[modifica | modifica el codi]