Diretivas de Página

O PmWiki usa um número de diretivas para especificar títulos de página, descrições, palavras-chave de páginas, e controlar a exibiçãode vários componentes. Palavras-chave não são sensíveis a maiúsculas.

(:attachlist:)

Mostra uma lista de arquivos anexos ao grupo ou página atual, dependendo em como os anexos foram organizados, por grupo ou por página. A lista de anexos (attachlist) é exibida ao pé da página de formulário de uploads.

O parâmetro para (:attachlist:) sempre acaba devolvendo um nome de página (pagename). A diretiva então exibe todos os anexos atualmente disponíveis para aquela página.

Opções: (:attachlist NOME:) Mostra a lista de anexos do grupo ou página NOME.

(:attachlist ext=xxx:) especifica uma extensão para filtragem por tipo de arquivo.

(:attachlist *:) mostra o diretório de uploade permit navegação de todos os anexos naquele diretório (não funcionará caso $EnableDirectDownload está definido como 0).

(:description texto:): Texto descritivo associado com a página. (Gera um elemento <meta name='description' content='...' /> na exibição da página.)

(:keywords palavra1, palavra2, ...:): Identifica palavras-chave associadas com a página. estas não são exibidas em qualquer lugar, mas são úteis para ajudar search engines para localizar a página. (Essencialmente, gera um elemento <meta name='keywords' content='...' /> na saída.)

(:linebreaks:), (:nolinebreaks:): Honra qualquer nova linha no texto; i.e., texto escrito em linhas separadas aparecerão como linhas separadas na saída. Use (:nolinebreaks:) para fazer com que as linhas se unam novamente.

(:linkwikiwords:), (:nolinkwikiwords:): habilitam/desabilitam links WikiWord no texto.

(:markup:) ... (:markupend:) or (:markup:)[=...=]

pode ser usado como para fazer exemplos para marcas (markup), mostrando primeiro a marca e depois seus resultados.

Opções: (:markup class=horiz:) Mostrará a marca e sua saída lado-a-lado ao invés de um sobre o outro.

(:markup caption='...':) adiciona uma legenda a saida do exemplo de markup.

(:markupend:) não é requerido quando usando (:markup:) [=...=].

Nota: Observe a colocação de nova-linha (newlines) pois é muito importante para marcação (markup). Se você está usando a opção [=...=] então a [= de abertura DEVE ocorrer na mesma linha assim como a (:marca:). Caso esteja usando a forma (:markup:) ... (:markupend:) então o código de marca deve aparecer DEPOIS da nova-linha depois da (:markup:) inicial.

(:mensagem:): Mostra mensagens do PmWiki ou receitas, como na edição de páginas.

(:noaction:): Remove a seção da skin marcada com  até . Na skin do pmwiki, isso remove da página as ações descritas no topo e lado direto (outras skins podem colocar esta seção em outro lugar).

(:nogroupheader:)
(:nogroupfooter:): Remove da página a seção groupheader ou groupfooter para a página. (Veja GroupHeaders ?.)

(:noheader:), (:nofooter:)
(:noleft:), (:noright:), (:notitle:): Caso seja suportado pela skin ?, cada um desses, desliga uma seção correspondente na página.

(:redirect PageName:): Redireciona para outra página wiki.
(:redirect PageName#anchor:): Redireciona para uma âncora dentro de uma página
(:redirect PageName status=301 from=name quiet=1:): Redireciona o browser para outra página, junto com uma mensagem de redireção. Por razões de segurança só acontecem redireções para para outras páginas dentro do wiki e não redireções para urls externas. A opção de status= pode ser usada para retornar um status de redireção HTTP diferente como parte da redireção. A opção from= limita redireções para páginas que contenham em parte ou todo o nome especificado (de ajuda quando (:redirect:) está em outra página ?). A opção quiet=1 permite que na página alvo não seja mostrada um link de volta para a página inicial (a variável $EnableRedirectQuiet deve estar designada como 1).

(:spacewikiwords:), (:nospacewikiwords:)

habilita/desabilita espaçamento automático de WikiWords no texto.

(:title text:): Designa um título para a página que pode ser outro além do nome-de-página (pagename). O título pode conter apóstrofes e outros caracteres especiais. caso existe mais de uma diretiva de título em uma página a última vence (Veja também $EnablePageTitlePriority sobre como mudar isso).

(:nl:): Cria uma nova linha caso já não exista uma. Veja este thread para maiores informações.
: É similar a [[<<]]

POsso ter um (:redirect:) que retorne "moved permanently" (HTTP 301) status code?

Use (:redirect PageName status=301:).

Existe como previnir que a mensagem "redirected from" apareça no topo da página alvo quando eu uso o (:redirect:)?

Desde a versão 2.2.1 em diante, coloque no config.php $EnableRedirectQuiet=1; e na página (:redirect OutraPagina quiet=1:) para uma redireção quieta.

Existe algum método para redirecionar para uma página equivalente em grupo diferente , i.e. from MauGrupo/EstaPagina => BomGrupo/EstaPagina usando uma marcação similar a(:redirect BomGrupo.{Name}:)?

(:redirect Goodgroup.{$Name}:) funciona se você colocar em uma página.

Caso queira que funcione para um grupo inteiro, coloque (:redirect BomGrupo.{*$Name}:) em MauGrupo.GroupHeader - Só irá funcionar para páginas que realmente existam em Bom Grupo; Se você visitar uma página em MauGrupo sem uma página correspondente em BomGrupo, ao invés de ser redirecionado para uma página não existente, você terá a diretiva de redireção no topo da página.

Com (:if exists BomGrupo.{*$Name}:)(:redirect BomGrupo.{*$Name}:)(:ifend:) em MauGrupo.GroupHeader você será redirecionadopara BomGrupo.Name caso exista, caso contrário você terá MauGrupo.Name sem o código.

Essa é possivelmente a tradução do original em : PmWiki.PageDirectives - Retroenlaces
Essa tradução se encontra em : PmWikiPtBr.PageDirectives - Retroenlaces
Últimas modificações da tradução feitas em : 10 de septiembre de 2011 a las 11h00
Últimas modificações feitas no original em : 19 de abril de 2024 a las 16h24