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 Camel Case?, 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 Camel Case?, 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:
- 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. - 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. - 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áginaBasicEditing
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 XL Page, 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|+]]
.
Como escrever |
Como aparece |
[[(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 :
Como escrever |
Como aparece |
* [[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.
Notas:
- 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]]
.
Exemplos:
[[{$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 Inter Map 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. | O link seguinte 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.
Nota: Esta é uma lista incompleta.
- .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')");
Q Como eu crio um link que abrirá uma nova janela?
Use o wikistyle %newwin%
, como em:
%newwin% http://exemplo.com/ %% |
Q Como crio um link que abrirá uma nova janela, e configuro aquela janela?
Isso requer javascript. Veja Cookbook:PopupWindow.
Q Como coloco um endereço de correspondência em uma página?
Use a marca mailto:
, como em um dos seguintes:
* mailto:meuendereco@example.com * [[mailto:meuendereco@example.com]] * [[mailto:meuendereco@example.com | mande email]] * [[mailto:meuendereco@example.com?subject=Assunto |mande email ]] |
A marca [[mailto:eu@example.com?cc=outro@example.com&bcc=aindaoutro@example.com&subject=Assunto pré-definido&body=corpo pré-definido | corpo]] =]
Deixa você especificar mais parâmetros como a mensagem mais e-mails (talvez não funcione em todos browsers e clientes de e-mail).
Veja também Cookbook:DeObMail por informação em como proteger o endereço de e-mail de spammers.
Q Como posso habilitar links para outros protocolos, como nntp:, ssh:, xmpp:, etc?
Q Como faço um link Wiki Word para uma página externa ao invés de uma Wiki Page?
Use marca de link. Existem dois formatos:
[[http://example.com/ | WikiWord]] [[WikiWord -> http://example.com/]]
Q Como encontro todas as páginas que linkam para outra página [i.e., links de retorno(backlinks)]?
No formulário de busca, use link=Grupo.Página
para encontrar todas as páginas com link para Grupo.Página.
Use a opção link=
da diretiva (:pagelist:)
, como em
(: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
Q Quais squemas de link o PmWiki suporta?
Veja PmWiki:Link schemes
Q Como abro links externos em uma nova janela ou marco com um ícone?
Q Como posso usar uma imagem como link?
Use [[Page| Attach:image.jpg ]] ou [[ http://site | http://site/image.jpg ]] Veja Images#links
Q Por que meu browser não segue links locais para file://?
Por razões de segurasnça, a maioria dos browsers irá habilitar apenas links do tipo file:// se a página contendo o link está ela mesmo no drive local. Em outras palavras, a maioria dos browsers suportam links para file:// de páginas acessadas, usando http:// assim como em um site PmWiki.
Essa é possivelmente a tradução do original em : PmWiki.Links - Links de retorno
Essa tradução se encontra em : PmWikiPtBr.Links - Links de retorno
Últimas modificações da tradução feitas em : 10 de setembro de 2011, às 13h00
Últimas modificações feitas no original em : 26 de abril de 2024, às 11h04