Links

Um recurso chave de sistemas wiki é a facilidade de criar hyper links (ou a versão curta links) no texto de um documento. O PmWiki prevê multiplos mecanismos para criar tais links.

Links para outras páginas no wiki

Para criar um link interno para outra página, basta colocar o nome da página entre colchetes, como em [[wiki sandbox]] ou [[installation]]. Isto resulta em links para wiki sandbox e installation, respectivamente.

PmWiki cria um link usando o texto dentro dos colchetes. Ele faz isso removendo espaços entre as palavras, e automaticamente capitalizando a primeira letra de cada palavra seguindo espaços ou pontuação (como ~). Assim [[Wiki Sandbox]], [[wiki sandbox]], e [[WikiSandbox]] aprecem diferenciados mas criam o mesmo link parar a paǵina WikiSandbox. Ou em outras palavras, o PmWiki irá automaticamente criar o "link caminho nome" usando a página em CamelCase, mas o "texto do link" irá aparecer no formato que você entrou.

Alguns sites PmWiki (não o default) irão reconhecer palavras escritas em CamelCase, chamados de WikiWord, automaticamente como um as para a página de mesmo nome.

Links com texto diferente

Existem três jeitos de ter diferentes textos de link:

1. Escondendo texto do link. Texto de link entre (parênteses) não será mostrado, e então [[(wiki) sandbox]] forma um link para WikiSandbox mas mostra o texto como sandbox. Para links que contem parênteses, use %28 e %29 http://www.example.com/linkwith%28parenthese%29.
2. Mudando texto do link. Você pode especificar outro texto para o link depois da barra vertical, como em [[WikiSandbox | a play area]], ou você pode usar uma flecha (->) para mudar a ordem do texto do link e o alvo, como em [[a play area -> WikiSandbox]]. Ambos os links aparecem como a play area.
3. Mostra o título ao invés de nome da página. O uso de caracteres especiais no nome da páginanão é um problema para o PmWiki, mas as vezes o charset é diferente entre o computador servidor (que executa o PmWiki) e o computador cliente que é usado para ler o wiki. Especialmente o charset UTF-8 pode causar problemas. E então, é melhor usar somente caracteres ASCII no nome de página e ter o nome real em uma diretiva (:title Título da Página:) dentro da página. Agora o título da página pode ser mostrado ao invés do nome da página, com a marcação [[PageName|+]] , e.g. a página BasicEditing contém a diretiva (:title Edição Básica:) como o resultado de um link escrito como [[BasicEditing|+]] ir á mostrar Edição Básica.
   Desde a versão 2.2.14 do PmWiki isto também funciona para páginas técnicas que tem uma entrada no XLPage, sem a necessidade de adicionar a diretiva (:title PageTitleName:) dentro da página (para maiores detalhes veja Localization.Localization).

Além dos meios acima, um sufixo pode ser adicionado ao final de um link, que se torna parte do texto do link, mas não parte da página alvo .
Nota: Esta funcionalidade atualmente não funciona com a marcação [[PageName|+]].

[[(wiki) sandbox]],
[[(wiki) sandbox]]es\\
[[WikiSandbox|wiki sandbox]],
[[WikiSandbox|wiki sandbox]]es\\
[[BasicEditing|+]]

Links com dica

Desde a versão 2.2.14, o PmWiki pode mostrar dica de título (usando propriedade title dos links) em links com o seguinte formato:

• Link externo: [[http://pmwiki.org"Dica de título" | Link externo ]]
• Link InterMap: [[Wikipedia:Wiki"Dica de título"| Link InterMap ]]
• Link de imagem: [[Attach:000962.png"Dica de título" | Link Attach: ]]
• Imagem inline: Attach:000962.png"dica de título"

PmWiki não dá suporte a dicas-título para links internos!

Links para páginas não existentes

Links para Páginas inexistentes são mostradas especialmente para convidar outros para criar a página. Veja Criando novas páginas para aprender mais.

Links para páginas em outros grupos dentro do wiki

Links como os acima são links entre páginas do mesmo grupo. Para criar um link para uma página em outro grupo, adicione o nome deste grupo juntamente com a página separados por um ponto ou barra diagonal. Por exemplo, links para Main/WikiSandbox poderiam ser escritos como :

* [[Main.WikiSandbox]]
* [[Main/WikiSandbox]]
* [[(Main.Wiki)Sandbox]]
* [[Main.WikiSandbox | texto do link]]
* [[Main.WikiSandbox | +]]

Para formar link para a "Página Inicial padrão" de um grupo, o nome da página pode ser omitido:

* [[Main.]]
* [[Main/]]

Veja Grupo para aprender mais sobre grupos no PmWiki.

Links de Categorização

Categorias são um meio para encontrar páginas relacionadas. A idéia é que para cada página que cai em um determinado assunto deveria existir um link para uma página contendo links para outras páginas sobre o mesmo assunto. Estas páginas são criadas no grupo especial chamado Category, e assim estes assuntos são chamados de categorias.

Adicionar uma página na categoria Assunto é simples como adicionar a marca [[!Assunto]] em algum lugar da paǵina. Isso irá criar um link para a página Category.Assunto. E então [[!Assunto]] é tipo um link de atalho para a página Category.Assunto. Veja Categories para aprender mais.

Links para página de usuário

Similarmente é [[~Autor]] um link atalho para a página Autor no grupo especial chamado Profiles. O PmWiki cria automaticamente este tipo de link para autor atual, quando ele encontra três caracteres de til (~) em uma linha (~~~) no texto da página. O autor atual é o nome encontrado no campo "Author", quando você cria ou modifica uma página. Quando quatro caracteres de til são encontrados em uma linha (~~~~), a data atual incluindo horas são adicionados.

Então, quando o campo Autor contém "Autor":
A marca ~~~ será substituida por : Autor
A marca ~~~~ Será substituida por : Autor Outubro 10, 2010, as 16:50

Links Atalho

[[PageName|#]] cria um link referência como mostrado abaixo^[1].

Links para lugares específicos dentro de uma página -- "âncoras"

Para definir um local na página para o qual você pode ir, use a marca [[#name]]. Isso cria uma âncora "anchor" que define unicamente aquele localna página. Para ter um link que vá direto para a âncora, use um dos:

• [[#nome| texto ]] dentro da mesma página , ou
• [[NomeDaPágina#nome]] ou [[NomeDaPágina#nome|texto]] para um local em outra página
• A forma [[NomeDaPágina(#name)]] pode ser de útil para esconder o texto de uma âncora em um link.

Por exemplo, aqui está um link para a seção do Intermaps abaixo.

• A âncora deve iniciar com uma letra , não um número
• Um link para uma âncora deve possuir a mesma capitalizaçãoda âncora.
• Espaços não são permitidos em uma âncora: "[[#minha âncora]]" não funcionará, "[[#minhaâncora]]" irá.

Links para ações

Para formar link para uma ação específica paraa página atual, use

[[{$FullName}?action=actionname|linkname]].

• [[{$FullName}?action=edit|Editar]] para editar ou
• [[{$FullName}?action=diff|Histórico]] para ver o histórico.

Links fora do wiki

Links para sites externos (URLs)

Links para sites externos iniciam simplesmente com um prefixo como 'http:', 'ftp:', etc. Assim, http://google.com/ e [[http://google.com/]] , ambos são links para o Google. Assim como acima, um autor pode especificar o texto do link usando a sintaxe de barra vertical ou de flecha, como em [[http://google.com/ | Google]] e [[Google -> http://google.com]].

É possível definir um "dica de título" do link para o site externo adicionando entre aspas duplas depois do endereço do site:

[[http://www.pmwiki.org/"Home of PmWiki"|link]]

Se o link externo inclui (parênteses), use %28 para "(" e %29 para ")" :

[[http://en.wikipedia.org/wiki/Wiki_%28disambiguation%29 | link to "Wiki (disambiguation)" ]]

Links para arquivos (locais) intranet

Nem todos os browsers seguirão estes links (algumas versões do Internet Explorer os seguem). Você pode fazer um link para o sistema de arquivos incluindo o prefixo 'file:///'. Então file:///S:\ProjPlan.mpp e [[Shared S drive->file:///S:\]] são ambos links válidos. No sistema de arquivos do windows você talvez use network locations (eg \\server1\rootdirectory\subdirectory) ao invés de letra de disco que podem não ser consistentes para todos os usuários. Nem todos os browsers sseguirão esses links.

Características dos links

#referênciaLinks como Referências

Links podem ser especificados como Referências, para que o alvo apareça como uma referência anônima e numérica, ao invés de uma referência textual. A marca a seguir é fornecida para produzir números referênciais em sequência em um página do PmWiki:

Formatando link como : [[http://google.com |#]] produz: [2] como link.

A susequente ocorrência do formato do link de referência na mesma página será incrementado automaticamente como no seguinte exemplo: Entrando [[http://pmwiki.com |#]] produz [3], [[#intermaps |#]] produz [4], e assim em diante para os próximos links de referência.

Intermaps

Links Inter Map também são suportados (veja Inter Map). Em particular, a entrada InterMap Path: pode ser usada para criar links com caminhos absolutos ou relativos no site atual (e.g., Path:../../umdir/foo.html or Path:/dir/arquivo.gif).

Links que abrem uma nova janela de browser

Para ter um link abrindo em uma nova janela, use %newwin%...%%:

• %newwin% http://pmichaud.com %% produz http://pmichaud.com
• %newwin% [[http://google.com/ | Google]] %% produz Google
• %newwin% [[Main.WikiSandbox]] %% produz Main.WikiSandbox

Você pode especificar também que devem abrir em uma nova janela via %target=_blank%...%% atributo:

O link seguinte  %target=_blank% http://pmichaud.com %%
abrirá em uma nova janela.

Links que não são seguidos por robots

Ponha prefixo em um link como %rel=nofollow% para aconselhar robôs e Checadores de links a não seguí-los.

Links e classes CSS

O PmWiki automaticamente dá classes para vários tipos de links. Dentre outras coisas, isso permite à você formatar cada tipo diferentemente.

.selflink

Um link para a página atual. Útil em barras laterais para mostrar onde você está.

.wikilink

Um link para outra página dentro do wiki.

.urllink

Um link para a página fora do wiki.

Notas

Nota: O comportamento padrão do "+" acima, pode ser anulado para mostrar o título espaçado "spaced title", ao invés de simplesmente o título, adicionandoo seguinte ao config.php:

## [[alvo |+]] Links de título
Markup('[[|+', '<[[|',
  "/(?>\\[\\[([^|\\]]+))\\|\\s*\\+\\s*]]/e",
  "Keep(MakeLink(\$pagename, PSS('$1'),
                 PageVar(MakePageName(\$pagename,PSS('$1')), '\$Titlespaced')
                ),'L')");

%newwin% http://exemplo.com/ %%

* mailto:meuendereco@example.com
* [[mailto:meuendereco@example.com]]
* [[mailto:meuendereco@example.com | mande email]]
* [[mailto:meuendereco@example.com?subject=Assunto |mande email ]]

[[http://example.com/ | WikiWord]]
[[WikiWord -> http://example.com/]]

(:pagelist link=UmaPágina list=all:)   -- Mostra todos os links para UmaPágina
(:pagelist link={$FullName} list=all:)  -- Mostra todos os links para a página atual