Wiki Trails

As TrilhasWiki permitem aos autores criarem "trilhas" através de sequências de páginas no wiki. Você simplesmente especifica páginas e sua ordem em um "índice de trilha", e então colocar o markup de navegação nas páginas que irá navegar.

(Não confunda o pagelist com TrilhasWiki - estes são animais diferentes como explicado em Q e R abaixo.)

Criando uma trilha

Antes de poder usar uma trilha através de um grupo de páginas, você deve criar um "índice de trilha" em uma página em separado, que chamaremos de "página de índice de trilha". Na página de índice de trilha, você seimplesmente cria listas numeradas ou comuns de links. (Assim cada item da lista cria implicitamente uma trilha.) É importante que cada nome de página (link) seja o primeiro item depois do início de cada item de lista; pois qualquer formatação anterior ao link do nome de página irá excluir o item da trilha.
Se quiser formatar sua trilha (lista), você pode incluir um CSS.

Um exemplo de página de índice de trilha poderia conter a lista:

• Instalação do PmWiki Como instalar
• Página de customização
• PmWiki texto extra Filosofia do PmWiki (O último link não seria incluido pois está precedido por texto)
• Mais texto. WikiStyles (Não seria incluido poispois texto precedente)
• Uploads (Não seria incluido pois é precedido pelo estilo de %center%.)
• Texto (Não seria incluido por não ser um link)
• PageLists Searching and listing pages by multiple criteria with templated output
• http://pmwiki.org (Não seria incluido pois não é um link oara uma página)
  • PmWiki:InterMap (Não seria incluido pois é um link de InterMap)
• Cookbook:Cookbook Não seria incluido pois é um link de InterMap)

PmWiki philosophy

Design notes (O primeiro link seria incluso, já o segundo não , pois está em uma (Lista de definição))

• Security (não seria incluso pois está precedido por um link (escondido) de âncora)
• Links (Não seria incluido pois está precedido de um estilo ,%newwin%
• Troubleshooting (Não seria incluido pois está precedido de de um estilo de markup (escondido) itálico

A lista acima cria a seguinte TrilhaWiki, mostrada usando-se um pagelist:

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

Observações

1. Em geral, níveis de identação na lista de páginas não importam -- trails são uma sequência linear de páginas.
2. Uma página é parte de um trail, somente se o link de página segue imediatamente o markup de lista.
3. A própria lista pode ser delineada pelo uso de âncoras, permitindo múltiplas listas em uma página, ou que algums items de lista seja, excluídos.

Tipos de Trilha

O PmWiki define 2 markups de trilha:

• <<|[[página índice de trilha]]|>> mostrado como "<< PáginaPrévia | Página ìndice de Trilha | PróximaPágina >>".
• <|[[Página ìndice de Trilha]]|> mostrado como "< PáginaPrévia | Página ìndice de Trilha | PróximaPágina >", exceto as flechas apropriadas são omitidas no início e fim da trilha.

Sintaxe de link de trilha

O link de trilha tem a mesma sintaxe de links normais link, isso significa que por exemplo, você pode específicar

• <|[[PáginaÌndiceDeTrilha | +]]|>

Links de trilha podem ser restringidos por âncoras (links para uma parte específica dentro de uma página), Isso significa que você pode ter mais de uma trilha por página, ou iniciar uma trilha de uma localização específica de uma página.

• <|[[Página ìndice de Trilha#trailstart#trailend]]|>

Usando a trilha

O que faz uma trilha "funcionar", é adicionar o markup de trilha nas páginas da trilha (i.e. As páginas que são listadas na lista numerada/comum da página índice de trilha).

Para construir uma trilha, adicione o markup de trilha como <<|[[PáginaìndiceDeTrilha]]|>> em uma página, onde `PáginaìndiceDeTrilha é a página, descrita acima, contendo a lista normal de páginas na trilha. O PmWiki irá mostrar o markup de trilha com links para qualquer página prévia ou próxima página na trilha.

O markup de trilha pode ser colocado em qualquer parte da página, e uma página pode conter múltiploas markups de trilha. Se você está adicionando uma trilha em todas as páginas de um grupo, considere colocar o markup de trilha nas páginas GroupHeader ou GroupFooter, ao invés de cada página individual do grupo.

Trilha de caminho

^|[[PáginaìndiceDeTrilha]]|^ trata os níveis de lista como hierarquia e mostra o "caminho" para alcançar a página atual (i.e., uma trilha "breadcrumb"). Na trilha exemplo acima, o markup ^|PáginaÌndiceDeTrilha|^ em PáginaDeTrilha4 apareceria como "PáginaÌndiceDeTrilha | PáginaDeTrilha2 | PáginaDeTrilha4".

Administratoderes wiki podem mudar o separador de trilha do "caminho" da trilha ( ^|[[PáginaìndiceDeTrilha]]|^ ) do padrão "|" preenchendo a variável de nome $TrailPathSep no arquivo config.php. Por exemplo $TrailPathSep = ' > '; mostrará "PáginaÌndiceDeTrilha > PáginaDeTrilha2 > PáginaDeTrilha4".

Trilhas Circulares

Tipicamente, uma trilha é uma lista linear, com uma págna inicial e final. De outra forma, a trilha pode ser feita "circular" repetindo a primeira página como último item no índice de trilha:

 * [[PáginaDeTrilha1]]
 * [[PáginaDeTrilha2]]
 ...
 * [[PáginaDeTrilhaN]]
 * [[PáginaDeTrilha1]]

Se a página índice de trilha pode ser lida por outros, o último item pode estar invisível dentro de um bloco (:if false:):

 * [[PáginaDeTrilha1]]
 * [[PáginaDeTrilha2]]
 ...
 * [[PáginaDeTrilhaN]]
 (:if false:)
 * [[PáginaDeTrilha1]]
 (:ifend:)

Trilhas entre grupos

Antes da versão 2.2.1, se a sua trilha contém páginas em grupos distintos, você deve usar links completos como [[Group.Name]], ao invés de [[Name]].

Outras notas

• Não existe espaço entre e [[link]] e ; o mesmo acontece para outras markups de trilha.
• Note que páginas inexistentes irão aparecer na trilha como links.

Estilo de trilha

O PmWiki encapsula a trilha com o nome de classe wikitrail. Isso permite que a trilha wiki seja customizada ao definir propriedades CSS para o seletor wikitrail no arquivo local.css.

Trilhas do pagelist page lists

Trilhas de um página só podem ser mostradas usando o parâmetro trail do pagelist. Por exemplo

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

Um exemplo simples de Trilhas wiki

1) Na PáginaÌndiceDeTrilha:

* [[MinhaPáginaDeTrilha1]]
* [[MinhaPáginaDeTrilha2]]
* [[MinhaPáginaDeTrilha3]]

2) Nas páginas MinhaPáginaDeTrilha 1, 2 e 3:

<<|[[PáginaÌndiceDeTrilha]]|>>

Questões