Ajuda:Enllaços

(S'ha redirigit des de: Ajuda:Enllaços interns)


Els hiperenllaços permeten als usuaris moure's fàcilment entre pàgines. Per a informació bàsica sobre el codi wiki en general, vegeu Ajuda:Editar.

Amb MediaWiki no és possible codificar hiperenllaços utilitzant HTML. En el seu lloc hi ha tres tipus generals d'hiperenllaços, cada un amb la formatació CSS associada per distingir-los: enllaços wiki, enllaços interwiki i enllaços externs. A més a més d'enllaçar, cada un proporciona trets addicionals importants específics pels wikis, com la detecció automàtica d'enllaç trencat per a enllaços wiki i la numeració automàtica d'enllaços externs quan s'utilitzen com a referències.

Enllaç wiki modifica

Un enllaç wiki és un enllaç intern a una altra pàgina o secció de pàgina dins del mateix wiki. El MediaWiki comprova automàticament si la destinació de l'enllaç intern existeix. Si la pàgina no existeix, l'enllaç porta a la pàgina d'edició i se li assigna la classe «new». Aquests tipus d'enllaços s'anomenen «enllaços vermells» ja que és el color per defecte en el full d'estil d'una instal·lació típica del MediaWiki. Els «enllaços vermells» són útils per a determinar si una pàgina existeix o no, creen enllaços a pàgines futures, i faciliten i fomenten la creació de pàgines noves. A més, amb «Què hi enllaça» aplicat a la pàgina no existent es proporcionen els enllaços indirectes a altres pàgines que tenen el mateix enllaç vermell.

Un enllaç a una pàgina no existent en l'espai de noms MediaWiki per a un missatge de sistema existent es considera com un enllaç a una pàgina existent.

Podeu utilitzar l'ordre  / / , de la barra d'eines. Que obrirà una finestra amb els paràmetres del text a incloure en el cas de la barra d'eines millorada o posarà entre claudàtors el text seleccionat en les altres barres.

Sintaxi modifica

MediaWiki defineix un enllaç wiki com un conjunt tancat per un parell de claudàtors dobles '[[ ]]'. La destinació de l'enllaç és la seqüència de caràcters que segueixen al primer parell de claudàtors fins a la barra '|' o el parell de claudàtors de tancament ']]'. La destinació de l'enllaç pot ser una altra pàgina del wiki, una secció en la mateixa pàgina o una secció en una altra pàgina del wiki.

  • Enllaços entre pàgines: els enllaços amb el format [[nom_de_pàgina]] connecten amb la pàgina que concordi exactament amb «nom_de_pàgina».
  • Enllaços a seccions internes: els enllaços amb el format [[#nom_d'enllaç]] connecten amb la primera secció d'aquella mateixa pàgina que tingui un encapçalament (o àncora -- vegeu més avall) que concordi exactament amb «nom_d'enllaç».
  • Enllaços a seccions entre pàgines: el enllaços amb el format [[nom_de_pàgina#nom_d'enllaç]] connecten amb la secció que concordi de la pàgina que concordi. Vegeu Ajuda:Seccions.

La sintaxi d'enllaços wiki també inclou diverses opcions de format per controlar com apareixen l'enllaç i el seu text.

Sintaxi bàsica d'enllaç wiki
Codi  Resultat    Destinació      Descripció   
[[a]]  a    a     L'enllaç wiki més simple  
[[a b]]  a b    a b     Paraules múltiples  
[[a b|c d]]  c d    a b     Enllaça 'a b' però mostra 'c d' *  
[[a b]]c  a bc    a b     L'enllaç és el que està etiquetat, però es mostra amb l'última paraula sencera  
<nowiki>[[a]]</nowiki>  [[a]]    Ø     El text es mostra sense interpretar com a enllaç  
escrit: [[a (b)|]],

convertit: [[a (b)|a]]

 a    a (b)     Una barra '|' immediatament abans dels claudàtors de tancament ']]' crea un enllaç conduït que amaga la part entre parèntesis i no la mostra *,***  
escrit: [[a, b|]],
convertit: [[a, b|a]]
 a    a, b     Una barra '|' immediatament abans dels claudàtors de tancament ']]' crea un enllaç conduït que amaga la coma i el que li segueix i no ho mostra *,***  
escrit: [[w:a|]],
convertit: [[w:a|a]]
 a    w:a     Una barra '|' immediatament abans dels claudàtors de tancament ']]' crea un enllaç conduït que amaga el primer prefix de l'enllaç i no el mostra *,**,***  
escrit: [[w:a (b)|]],
convertit: [[w:a (b)|a]]
 a    w:a (b)     Una barra '|' immediatament abans dels claudàtors de tancament ']]' crea un enllaç conduït que amaga el primer prefix de l'enllaç i la part entre parèntesis i no els mostra *,***  
[[mediawiki:addsection]]  mediawiki:addsection    Mediawiki:addsection     Encara que la pàgina no existeix, l'enllaç no és vermell perquè sí que existeix el missatge del sistema  
[[mediawiki:addpage]]  mediawiki:addpage    Mediawiki:addpage     L'enllaç és vermell perquè no existeix el missatge del sistema  


Trucs i exemples d'enllaços wiki
Codi  Resultat    Destinació      Descripció   
[[a|b|c]]  b|c    a     El codi wiki tracta la segona barra '|' com a text normal *  
[[a|b]]c  bc    a     La 'c' és afegida al final del text i enllaça a 'a' -- (útil per afegir una s dels plurals) *  
a[[b]]  ab    b     'a' precedeix immediatament el text d'enllaç però no hi és inclosa  
[[a]]<nowiki>b</nowiki>  a   a     'b' segueix immediatament el text d'enllaç però no hi és inclosa  
[[a]]''b''  ab    a     En utilitzar dos apòstrofs '' a 'b' per fer-la cursiva l'exclou del text d'enllaç  
[[a]]'''b'''  ab    a     En utilitzar tres apòstrofs ''' a 'b' per fer-la negreta l'exclou del text d'enllaç  
[[a|b]]c<nowiki>d</nowiki>  bc   a     Es tradueix com [[a|bc]]<nowiki>d</nowiki> *  
[[a]][[b]]  ab    a , b     Dos enllaços junts es mostren com ab si no es passa el cursor per damunt  

* Els enllaços amb paràmetres (el nom de l'enllaç) s'anomenen «conduïts» per la utilització del símbol de barra vertical, pipe (tub) en anglès. Vegeu Ajuda:Enllaç conduït.

** Independentment de si és un prefix interwiki, un prefix d'espai de noms o simplement un text seguit de dos punts.

*** No funciona amb enllaços a seccions (amb #); tracta [[#xxxx|]] com a pur text.

Fixeu-vos que per a imatges, categories i enllaços entre llengües la sintaxi és la mateixa que per a enllaços wiki. En afegir un enllaç normal es posarà la imatge a la pàgina, s'afegirà la pàgina a la categoria i es crearà un enllaç entre llengües en el marge de la pàgina. Això es pot evitar afegint dos punts com a prefix i així no s'interpretarà la sintaxi específica. Per exemple, [[:Categoria:Ajuda]], [[:fr:Aide:Lien]] i [[:Fitxer:Mediawiki.png]].

En el cas d'un enllaç local a una pàgina de descripció d'imatge de Commons, que es genera dinàmicament però no existeix localment, aquesta pàgina es tracta com a existent per a enllaços en pàgines, p. ex. File:Cow-on pole, with horns.jpeg, però no per a enllaços en resums d'edició i registres.

L'existència d'un enllaç intern des d'una pàgina a una altra pàgina, existent o no, s'enregistra a la taula d'enllaços.

Funció esborrany modifica

Un enllaç wiki a una pàgina existent tindrà la classe 'stub' (esborrany) si la pàgina és de l'espai principal, no és una redirecció i el nombre de bytes del text wiki és menys del que el «límit per a formatar l'enllaç com esborrany» establert a les preferències de l'usuari.

Això permet als usuaris identificar immediatament enllaços a pàgines molt curtes que probablement necessiten ser ampliades. Alternativament, un usuari pot posar un límit molt alt per aconseguir:

  • Identificar enllaços a pàgines molt grans. Tanmateix, el criteri és la mida del text wiki; la possible inclusió de plantilles i imatges pot fer que la pàgina mostrada sigui gran, fins i tot si la quantitat de text wiki és petita.
  • Determinar d'una ullada si un enllaç porta a l'espai de noms principal o no. Tanmateix, això no té en compte redireccions a l'espai principal (fins i tot si la redirecció mateixa és en l'espai principal).
  • Identificar enllaços a redireccions per a tasques de manteniment com corregir redireccions.

Tanmateix, no funciona amb un enllaç a una secció. Encara que normalment això és un assumpte menor, això pot provocar problemes als usuaris que posin un límit molt alt.

Enllaços entre wikis modifica

Un enllaç entre wikis (interwiki) connecta amb una pàgina d'un altre lloc web. A pesar del que suggereix el nom, el lloc web enllaçat no cal que sigui un wiki, però ha de ser en el mapa interwiki especificat en el wiki origen. Aquests enllaços tenen la classe CSS associada "extiw". Tenen el mateix format que els enllaços wiki explicats més amunt però amb un prefix que especifica el lloc destinació. Per exemple, en els projectes de Wikimedia (excepte les Viquipèdies) i molts altres wikis [[wikipedia:Main Page]] enllaça a la portada de la Viquipèdia en anglès. El prefix es pot amagar utilitzant la mateixa sintaxi amb una barra vertical que els enllaços wiki.

Un interwiki també pot connectar amb una secció o altre àncora, vegeu Ajuda:Secció.

Enllaços interwiki circulars al mateix projecte modifica

Encara que els enllaços interwiki es poden utilitzar per apuntar al propi wiki, generalment això no es recomanable. El MediaWiki no detecta si la pàgina destinació d'un interwiki existeix o no, així no hi ha cap formatació especial i l'enllaç és sempre a la pàgina de lectura. A més, el MediaWiki no comprova si la pàgina s'està enllaçant a ella mateixa. Un autoenllaç wiki es mostra en negreta (com Ajuda:Enllaços), mentre que un autoenllaç interwiki és normal (w:ca:Ajuda:Enllaços).

Pros:

  • Una còpia del text wiki en un projecte germà encara pot assenyalar a la mateixa pàgina. A vegades es necessiten dos prefixos per a aquest propòsit, p. ex. w:de:a.

Contres:

  • L'enllaç no té una aparença estàndard
  • No es detecta l'existència de la pàgina enllaçada

Enllaços externs modifica

Els enllaços externs utilitzen URL complets per enllaçar directament a qualsevol pàgina web. Aquests enllaços tenen associada la classe CSS «external». Els enllaços externs tenen el format [http://www.example.org nom de l'enllaç] (resultant nom de l'enllaç), amb el nom de l'enllaç separat de l'URL per un espai. Els enllaços sense nom d'enllaç són numerats automàticament: [http://www.example.org] es converteix en [1]. Els enllaços sense claudàtors es mostren en la seva totalitat: http://www.example.org.

Per mostrar un URL sense enllaç utilitzeu p. ex. <nowiki>http://www.example.org</nowiki> que dóna http://www.example.org.

A diferència dels enllaços interns, els caràcters immediatament després del claudàtor de tancament no són afegits a l'etiqueta d'enllaç: [http://www.example.org a]s dóna as.

Podeu utilitzar l'ordre  / / , de la barra d'eines. Que obrirà una finestra amb el text a incloure.

Vegeu Ajuda:URL per a més informació.

Enllaços de correu electrònic modifica

Els enllaços a una adreça de correu electrònic funcionen de la mateixa manera que els enllaços externs, excepte que han de menester el prefix mailto:. Els enllaços de correu electrònic són amb el format [mailto:quisigui@example.org nom de l'adreça] (resultant nom de l'adreça), amb el nom separat de l'adreça per un espai. Les adreces sense nom són numerades automàticament: [mailto:quisigui@example.org] que es converteix en [2]. Les adreces sense el prefix «mailto:» no es converteixen en enllaç, p. ex. quisigui@example.org. És possible afegir còpies amb [mailto:quisigui@example.org?cc=quisigui2@example.org nom de l'adreça] (resultant nom de l'adreça).

Pàgines especials del mateix projecte modifica

Els enllaços externs poden tenir diversos paràmetres d'URL opcionals. Això permet enllaçar directament a l'historial d'una pàgina, a la pàgina d'edició, a la pàgina de diferències entre dues versions, etcètera. També es poden utilitzar per crear una imatge de navegació.

Per a la portabilitat, utilitzeu "fullurl" quan l'URL depengui del projecte.

Fletxa d'icona modifica

L'aparença MonoBook produeix una icona amb una fletxa després de cada enllaç extern. Això es pot suprimir amb class="plainlinks":

  • [http://a a] dóna a
  • <span class="plainlinks">[http://a a]</span> dóna a

Amb algun codi especial a MediaWiki:Common.css els enllaços externs a fitxers PDF poden tenir la seva pròpia icona, com   definit a m:MediaWiki:Common.css. En aquest lloc amb la vostra configuració actual http://a.pdf dóna http://a.pdf

Saltar-se un número modifica

Per saltar-se un número en els enllaços externs numerats automàticament (pel motiu que sigui), utlitzeu p. ex. <span style="display:none">[http://a]</span>: [3][4][5].

Fixeu-vos que una condició falsa d'una ParserFunction, o una plantilla com m:template:x0, no funciona perquè la numeració d'enllaços es fa després de l'expansió de plantilles i funcions parser.

Cercar enllaços web modifica

Especial:Enllaços web (una extensió instal·lada en els wikis de Wikimedia, [6]) cerca totes les pàgines que enllacen a un URL donat. Utilitzant la taula d'enllaços externs proporciona per un patró d'enllaç extern donat una llista (enllaçada) de pàgines del wiki amb l'enllaç complet en cadascuna (també com a enllaç). Es pot cercar en tots els espais de noms o en un seleccionat. Es pot utilitzar un asterisc (*) de comodí al davant per cercar enllaços a un domini de primer nivell sencer (p. ex. [7]), o un domini de segon nivell (p. ex. [8]), etc. En el cas que s'especifiqui un nom de domini complet, es pot especificar addicionalment la resta de l'URL, o la seva primera part (se suposa un comodí al final), p. ex. [9].

Comentaris:

  • No poseu "http://".
  • Els dos punts de l'URL poden provocar que el programari no doni cap resultat.
  • L'URL d'una pàgina MediaWiki té guions baixos en lloc d'espais. Igualment, l'URL especificada a la cerca d'enllaços web s'ha d'escriure amb guions baixos.
  • Encara que múltiples URL condueixin a la mateixa pàgina, modificant les majúscules, els guions baixos o afegint o no «index.php», la cerca d'enllaços és sensible a les majúscules i no troba URL amb escriptures alternatives. Per això, en crear un enllaç extern, per a l'ús òptim de la cerca d'enllaços, utilitzeu una forma estàndard per l'URL. En particular, si després de seguir un enllaç la barra d'adreces mostra un URL modificat, canvieu-lo a aquest.
  • La llista és ordenada alfabèticament. Fixeu-vos que un guió baix, a diferència d'un espai, alfabèticament està entre «Z» i «a».

Retroenllaços modifica

Comunament, un enllaç a una pàgina normal del mateix projecte és en l'estil d'enllaç intern. Un avantatge és la detecció d'existència. A més a més, si alguns enllaços són d'estil intern i altres extern, llavors necessitem tant «Què hi enllaça» com la cerca d'enllaços web per trobar tots els retroenllaços. Tanmateix, especialment per a un enllaç a una secció o àncora posada explícitament, un podria posar un enllaç intern i també un d'extern amb l'estil CSS "display=none", per proporcionar tots els retroenllaços.

L'avantatge de l'estil d'enllaç extern sobre el d'enllaç entre wikis és que l'URL especificat a la cerca pot contenir una àncora (vegeu més avall), o la primera part d'una àncora. Així la cerca d'enllaços pot trobar retroenllaços de seccions i àncores explícites. En aquest sentit els enllaços externs també tenen avantatge sobre els interns. Es poden combinar els avantatges d'ambdós posant-los tots dos, però amagant els enllaços externs: <span style="display:none">http://...</span>

Àncores modifica

Enllaços a àncores modifica

Els enllaços amb el format [[#nom_d'àncora]] connecten a la primera àncora de la pàgina que concordi amb el «nom_d'àncora», normalment el primer encapçalament de secció idèntic.

Un #nom_d'àncora també es pot afegir al nom de pàgina en qualsevol tipus d'enllaç, connectant així amb el primer encapçalament de secció idèntic (o àncora) de la pàgina anomenada:

[[Ajuda:Redirecció#Reanomenament]], [[m:Help:Editing#Links]],

http://meta.wikimedia.org/wiki/Help:Editing#Links

Àncores automàtiques modifica

Els encapçalaments de secció actuen automàticament com a àncores, amb el text d'encapçalament com a «nom_d'àncora». En cas de múltiples seccions amb encapçalaments idèntics, s'afegeix una numeració al nom d'àncora de cada un, començant pel segon: «_2», «_3», etc.

L'àncora #toc connecta amb la taula de continguts de la pàgina, llevat que hi hagi una secció titulada «toc».

Àncores manuals modifica

Les àncores definides manualment són útils per enllaçar a llocs no previstos com una taula (títol o cel·la), una secció de text net, etc. Per exemple, en la taula de Trucs i exemples d'enllaços wiki, encara que el títol «Trucs i exemples d'enllaços wiki» aparegui com un encapçalament (menor), no ho és, i altrament l'enllaç wiki perfectament normal [[#Trucs i exemples d'enllaços wiki]] no funcionaria.

Hi ha un diferents maneres de posar una àncora en una posició arbitrària:

  • Àncora genèrica: <span id="nom_d'àncora">un text</span>. Per a una àncora oculta, ometeu el text.
  • Encapçalaments HTML manuals (desaconsellat): <h2>Com s'edita</h2>. El text és el nom_d'àncora.

!colspan="5" align="left" id="Trucs d'enllaços"|Trucs i exemples d'enllaços wiki

Vegeu també Ajuda:Secció.

Cerca d'enllaços amb àncora modifica

Tal com s'explica més amunt, si s'utilitza l'estil d'enllaç extern, p. ex. [10], es pot cercar Especial:Enllaços web: [11].

Com que la cerca d'enllaços permet especificar la primera part d'una àncora, és útil utilitzar zeros al davant si els noms d'àncora són numèrics o acaben en números. Altrament, si es cerquen enllaços per exemple a "1", també donarà a "10", etc. Més generalment, si hi ha àncores "a" i "ab", una cerca d'enllaços a "a" donarà també els enllaços a "ab". Per evitar-ho es pot utilitzar com a àncora "_a".

Àncores indexades modifica

Si els noms d'àncora tenen components múltiples, és útil posar primer el component més significatiu, p. ex. si les àncores indiquen dates podríem tenir el format AAAA-MM, o AAAA-MM-DD. En el cas de seccions, si es desitja fer enllaços amb un nom diferent a l'encapçalament de la secció, es poden posar explícitament àncores.

Àncores en enllaços externs modifica

En un enllaç extern, una àncora es pot crear convenientment amb la funció parser anchorencode. Per exemple, "{{anchorencode:Àncores en enllaços externs}}" dóna "Àncores_en_enllaços_externs" que es pot utilitzar per fer l'enllaç //ca.wikipedia.org/wiki/Enlla%C3%A7os#Àncores_en_enllaços_externs

Funció de subpàgina modifica

El MediaWiki té una funció de subpàgina que es pot activar per projecte i espai de noms. El que segueix a continuació és aplicable si està activada, si no "A/b" és simplement una pàgina amb aquest nom.

S'estableix una estructura arbòria de pàgines utilitzant barres inclinades en els noms de pàgina: A/b és filla de A, i A és la pàgina mare de A/b; també A/b/c és filla de A/b; mentre que A/a, A/b i A/c són pàgines germanes.

En la part superior del cos de la subpàgina es mostren automàticament els enllaços a totes les pàgines ascendents. Els enllaços apareixen fins i tot si la pàgina mare no existeix, però la seqüència d'ascendents s'atura en la pàgina no existent (p. ex., si la pàgina de grandparent no existeix, la pàgina de pare no es mostra tampoc). Com la majoria de caràcters d'un nom de pàgina, el primer caràcter després de la barra inclinada és sensible a les majúscules: "/subpàgina" i "/Subpàgina" són pàgines diferents.

Què hi enllaça i Seguiment d'enllaços ignoren aquests enllaços automàtics.

Variables modifica

En la pàgina A:B/c/d, on A és un nom d'espais que la funció de subpàgina activada, {{BASEPAGENAME}} dóna B/c i {{SUBPAGENAME}} dóna d.

Enllaços relatius modifica

En una jerarquia de subpàgines es poden utilitzar els següents enllaços relatius:

  • [[../]] enllaça a la pàgina mare de la subpàgina actual, p. ex. a A/b enllaça a A, a A/b/c enllaça a A/b.
  • [[../../]] enllaça a la pàgina àvia de la subpàgina actual, p. ex. a A/b/c enllaça a A.
  • [[../s]] enllaça a una pàgina germana de la subpàgina actual, p. ex. a A/b enllaça a A/s.
  • [[../../s]] enllaça a una pàgina "tieta" de la subpàgina actual, p. ex. a A/b/c enllaça a A/s.
  • [[/s]] enllaça a una subpàgina filla, p. ex. a A és el mateix que [[A/s]]. Per aquest motiu, per enllaçar des d'un espai de noms on la funció subpàgina està activada a una pàgina de l'espai principal amb un nom que comenci amb "/", és necessària una solució temporal: posar dos punts abans del nom de la pàgina.

No es pot enllaçar a una àncora d'un ascendent. En intentar-ho dóna un enllaç a una pàgina amb un nom que consta del nom de l'ascendent seguit de "/".

Els enllaços relatius continuen funcionant si totes les pàgines de l'arbre es reanomenen seguint un canvi de nom de la pàgina arrel, incloent-hi fer-la una subpàgina d'una nova arrel.

Vegeu les pàgines de demostració m:Link/a/b i m:Help:Link/a/b.

Activació de subpàgines modifica

La Viquipèdia té aquesta funció activada en tots els espais de noms de discussió i els espais d'usuari i de projecte. Meta-Wiki també la té en l'espai principal. La configuració per defecte és a DefaultSettings.php[12]. La configuració per projecte es defineix a LocalSettings.php[13].

Vegeu també mw:Manual:$wgNamespacesWithSubpages.

Espai d'usuari modifica

Les subpàgines d'una pàgina d'usuari ([[Usuari:Nom_d'usuari/Subpàgina]]) es consideren que són de l'espai d'aquell usuari.

Conversió de caràcters modifica

D'acord amb les regles explicades a Ajuda:Nom de pàgina, en els enllaços wiki i interwiki es converteixen automàticament els caràcters especials. Per exemple, «[[Ajuda:Nom%20de%20p%C3%A0gina]]» es converteix en «Ajuda:Nom de pàgina». Tanmateix, el contrari és cert per als enllaços externs: els caràcters literals es converteixen en caràcters no literals. Per exemple, la majoria dels navegadors convertiran ".../wiki/"! a ".../wiki/%21".

Efectes addicionals dels enllaços modifica

Text emergent en enllaços modifica

En alguns navegadors, passant el cursor sobre l'enllaç es mostra una caixa emergent amb el text de l'atribut de títol HTML de l'enllaç. El MediaWiki ho fa amb el nom de la pàgina enllaçada (sense indicació de secció) si és un enllaç wiki (amb el missatge de red-link-title si la pàgina no existeix), el nom de pàgina amb prefix si és un enllaç entre wikis, i l'URL si és un enllaç extern.

Això es pot desactivar en les preferències d'usuari. El navegador por mostrar informació similar en la barra d'estat, però amb la indicació de secció.

Aquests efectes són útils per un enllaç conduït encara que no es segueixi; per exemple, per mostrar el significat d'un acrònim (p. ex. PVN) o qualsevol altre comentari. És possible produir un text emergent sense un enllaç, vegeu m:Template:H:title. També és possible canviar el contingut del text emergent utilitzant un codi com [[Títol d'enllaç|<span title="hoverbox">Text mostrat</span>]], p. ex.

[[Peu (unitat de longitud)|<span title="30.48 cm">ft</span>]] dóna ft

Enllaços d'una pàgina modifica

Els enllaços d'una pàgina es poden obtenir amb una consulta API: {{SERVER}}{{SCRIPTPATH}}/api.php?action=query&prop=links&titles=pàgina, p. ex. //ca.wikipedia.org/w/api.php?action=query&prop=links&titles=Ajuda:Enllaços .

Vegeu també modifica


[modifica] Ajuda específica de la Viquipèdia


Vegeu Viquipèdia:Ajuda