SearchWiki:
Add Page:

SideBar (edit)

Associated Sites

Page History Edit Page Links to This Page

autores (bÓsic)

Aquesta caracterÝstica permet a les autores crear "rutes" per visitar una seqŘŔncia de pÓgines del wiki. NomÚs s'han d'especificar les pÓgines i el seu ordre a l'"Ýndex de la ruta", i aleshores afegir les etiquetes per a la navegaciˇ a les pÓgines que en formen part.

(No s'ha de confondre la directiva de Llistat de pÓgines amb les rutes wiki --tal i com s'explica a les PMF abaix, sˇn animals diferents.)

Creaciˇ de rutes

Abans de poder usar una ruta a un grup de pÓgines, heu de crear un "Ýndex de la ruta" separat, al qual anomenem "pÓgina de l'Ýndex de la ruta". A una pÓgina d'Ýndex de ruta, nomÚs cal crear una llista? d'enllašos numerada o de punts. (Per tant cada llista numerada o de punts crea implÝcitament una ruta.) ╔s important que immediatament desprÚs de cada punt de la llista hi hage l'enllaš? a la pÓgina desitjada; si hi ha qualsevol altre text o marca de format al davant, serÓ excl˛s de la ruta.
Si voleu donar format a la ruta (llista), podeu incloure-hi un CSS.

Una pÓgina d'Ýndex de ruta d'exemple pot contindre la llista:

La Filosofia de PmWiki
DesignNotes? (El primer enllaš estarÓ, per˛ el segon no, a la ruta definida perquŔ Ús una (definiciˇ))
  • Security? (Aquest no estarÓ a la ruta perquŔ estÓ precedit per una Óncora (oculta))
  • Enllašos (Aquest no estarÓ a la rauta perquŔ estÓ precedit per un estil %newwin% (ocult))
  • Troubleshooting (Aquest no estarÓ a la ruta perquŔ estÓ precedit per una marca d'estil cursiva (oculta))

La llista de sobre crearÓ la segŘent "ruta wiki", mostrada fent servir Llistats de pÓgines:

(:pagelist trail={$FullName}#trailstart#trailend fmt={$FullName}#traillist:)

Observacions

  1. Generalment no importa el nivell de sagnat de la llista de pÓgines -- les rutes sˇn una seqŘŔncia lineal de pÓgines.
  2. Una pÓgina forma part de la ruta nomÚs si l'enllaš a la pÓgina Ús el primer element que hi ha.
  3. Es poden fer servir ancores per a trašar la llista, permetent mÚs d'una llista per pÓgina, o l'exclusiˇ d'elements de la llista.

Tipus de rutes

PmWiki defineix 2 marques per a les rutes:

  • <<|[[PÓgina d'═ndex de la Ruta]]|>> es mostrarÓ com "<< PÓgina anterior | PÓgina d'═ndex de la Ruta | PÓgina segŘent >>".
  • <|[[PÓgina d'═ndex de la Ruta]]|> es mostrarÓ com "< PÓgina anterior | PÓgina d'═ndex de la Ruta | PÓgina segŘent >", tret que la fletxa apropiada s'omet al principi i final de la ruta.

Sintaxis de l'enllaš de la ruta

L'enllaš de la ruta te la mateixa sintaxis que l'enllašos estÓndard, aix˛ vol dir que podeu especificar, per exemple,

  • <|[[PÓgina d'═ndex de la Ruta | +]]|>

Es poden restringir els enllašos amb ancores (enllašos a una part especÝfica d'una pÓgina), aix˛ vol dir que podeu tenir mÚs d'una ruta dintre d'una pÓgina, o comenšar una ruta des d'una ubicaciˇ especÝfica d'una pÓgina.

  • <|[[PÓgina de l'═ndex de la Ruta#iniciruta#firuta]]|>

Usant la ruta

All˛ que "fa funcionar" una ruta, Ús afegir la marca (o etiqueta) de ruta a les pÓgines que hi formen part (i.e. aquelles pÓgines que estan llistades a la pÓgina d'Ýndex de la ruta).

Per a construir una ruta, afegiu la marca de ruta tal com <<|[[PaginaIndexRuta]]|>> a una pÓgina, on PaginaIndexRuta Ús la pÓgina, descrita mÚs amunt, que contÚ la llista amb les pÓgines que formen part de la ruta. PmWiki mostrarÓ la representaciˇ de la ruta amb els enllašos a la pÓgina anterior i a la pÓgina segŘent.

Podeu colĚlocar la marca de ruta a qualsevol lloc de la pÓgina, a mÚs a mÚs una pÓgina pot contenir diverses marques de ruta. Si esteu afegint una ruta a totes les pÓgines d'un grup determinat, considereu la inclusiˇ de la mateixa a les pÓgines de capšalera de grup o GroupFooter (peu de pÓgina) enlloc de fer-ho individualment a cada pÓgina.

Una ruta linial

^|[[PaginaIndexRuta]]|^ estableix una jerarquia a partir dels nivells de la llista i mostra el "camÝ" per arribar a la pÓgina actual (i.e., en forma de barra o "breadcrumb"). En la ruta de l'exemple de dalt, la marca ^|PaginaIndexRuta|^ a PaginaRuta4 es mostraria com "PaginaIndexRuta | PaginaRuta2 | PaginaRuta4".

Les administradores del wiki poden canviar el separador per defecte | de la ruta "lineal" ( ^|[[PaginaIndexRuta]]|^ ) per un altre, configurant la variable $TrailPathSep al fitxer config.php. Per exemple $TrailPathSep = ' > '; mostrarÓ "PaginaIndexRuta > PaginaRuta2 > PaginaRuta4".

Una ruta circular

Habitualment una ruta Ús una llista lineal de pÓgines amb una primera pÓgina i una ˙ltima pÓgina. Tanmateix, la ruta es pot fer "circular" repentint al final de l'Ýndex la primera pÓgina:

 * [[PaginaRuta1]]
 * [[PaginaRuta2]]
 ...
 * [[PaginaRutaN]]
 * [[PaginaRuta1]]

Si l'Ýndex de la ruta ha de ser visible al p˙blic, podeu fer invisible l'˙ltim element dintre d'un bloc (:if false:) :

 * [[RutaPagina1]]
 * [[RutaPagina2]]
 ...
 * [[RutaPaginaN]]
 (:if false:)
 * [[RutaPagina1]]
 (:ifend:)

Rutes entre grups

Abans de la versiˇ 2.2.1, si la vostra ruta contenia pÓgines de diferents grups, calia usar enllašos del tipus [[Grup.Nom]] enlloc del tipus [[Nom]].

Altres notes

  • No hi ha cap espai entre la marca <| i [[enllaš]] i |>; el mateix s'aplica a la resta de marques de ruta.
  • Noteu que les pÓgines que no existeixen apareixeran a la RutaWiki? com un enllaš.

L'estil de la ruta

PmWiki encasta la ruta dintre d'una classe css anomenada wikitrail. Aš˛ permet que l'aspecte de la ruta pugui Ússer personalitzat? mitjanšant la definiciˇ d'un estil CSS per a wikitrail al fitxer local.css.

Llistat de pÓgines de la ruta

Les rutes d'una sola pÓgina nomÚs es poden mostrar fent servir el parÓmetre ruta de la directiva Llistat de pÓgines. Per exemple

(:pagelist trail=PmWikiCa/WikiTrails fmt=PmWikiCa.WikiTrails#traillist order=random count=3:)

Un exemple simple de RutaWiki

1) A la pÓgina PaginaIndexRuta:

* [[MeuaPaginaRuta1]]
* [[MeuaPaginaRuta2]]
* [[MeuaPaginaRuta3]]

2) A les pÓgines MeuaPaginaRuta1, 2, i 3:

<<|[[PaginaIndexRuta]]|>>

Preguntes

Quina Ús la diferŔncia entre un Llistat de pÓgines i una RutaWiki?

La directiva de Llistat de pÓgines genera dinamicament una llista de pÓgines. Hi ha moltes maneres de generar la llista, fins i tot fer servir una RutaWiki com a font. La directiva mostra les pÓgines que coincideixen amb el criteri de recerca fent servir --opcionalment-- una plantilla; per exemple, la plantilla podria especificar que es mostri el nom de cada pÓgina en forma d'enllaš en una lÝnia separada, o incloent-hi el contingut de la pÓgina sencera. La directiva de Llistat de pÓgines no compta amb una marca que pugueu incloure a les pÓgines de la llista. En canvi, les RutesWiki es defineixen nomÚs amb enllašos colĚlocats a una pÓgina "Ýndex" i podeu incloure marques de navegaciˇ del tipus anterior-segŘent a cadascuna de les pÓgines. Els dos mŔtodes serveixen per a prop˛sits distints. Les RutesWiki sˇn ˙tils per a especificar canals web?, per a crear un "tour" a travÚs d'un conjunt predefinit de pÓgines, i moltes altres coses.



Traducciˇ de PmWiki.WikiTrails - PÓgina original a PmWikiCa.WikiTrails - Backlinks

Edit Page - Page History - Printable View - Recent Changes - SearchWiki
Page last modified on October 14, 2011, at 08:52 AM