Codex

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:

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:

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:):

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:

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

Questões

Qual a diferença entre um PageList e um WikiTrail?

A diretiva de pagelist gera dinamicamente uma lista de páginas. Existem várias maneiras de gerar a lista, incluindo usar um WikiTrail como fonte. A diretiva do pagelist, então, mostra as páginas que correspondem aos critérios usando um template opicional - por exemplo, exibindo o nome de cada página em uma linha separada como um link ou inclusive todo o conteúdo. A diretiva do pagelist atualmente não tem built-in de navegação de marcação que você pode colocar nas páginas na lista. Por contraste, WikiTrails são simplesmente especificados por links em uma página "índice" e você pode colocar markup de navegação prev-prox em cada página. Os dois servem propósitos diferentes. WikiTrails são úteis para especificar páginas em web feeds, Para criar um "tour" através de um seleção predefinida de páginas, e muitas outras coisas.


Essa é possivelmente a tradução do original em : PmWiki.WikiTrails - Links de retorno
Essa tradução se encontra em : PmWikiPtBr.WikiTrails - Links de retorno
Últimas modificações da tradução feitas em : 06 de janeiro de 2012, às 14:35
Últimas modificações feitas no original em : 09 de março de 2015, às 19:48