Referência Rápida
Hiperligação |
Sintaxe |
Comentário |
ligação interna |
NomeDeWiki |
nome de página CamelCase |
ligação interna livre |
[[Página]] ou [[ligação livre]] |
função configurável function |
ligação interna para subpágina |
/SubPágina ou [[/Subpágina com espaços]] |
relativa à página acima |
ligação externa |
http://example.net |
|
ligação interna com título |
[[ConteúdosDeAjuda|Conteúdos de Ajuda]] |
|
ligação externa com título |
[[http://example.net|sítio de exemplo]] |
|
ligação irmã |
[[../../irmã|texto da ligação]] |
ligação para uma página irmã da página-mãe |
gráficos locais (anexo) |
{{attachment:gráficos.png}} |
imagens serão exibidas internamente |
gráficos externos |
{{http://example.net/imagem.png}} |
exibe imagem-alvo |
gráficos externos e internos |
[[ImageLink(image,target[,width=width[,height=height]][,alt=alttag])]] |
cria uma ligação que exibe uma imagem e ligações para um URL ou uma página wiki. |
contorno de uma ligação interna |
NomeDeWiki``s |
2 acentos graves - quando um NomeDeWiki termina no meio de uma palavra |
evitar uma ligação interna |
!NomeDeWiki |
função configurável |
Explicações e Exemplos
Nomes de Páginas Arbitrários
Ao englobar uma sequência de caracteres entre chavetas e aspas ["assim"], cria-se um nome de página. Isso pode ser utilizado em casos específicos do MoinMoin (como a organização de uma lista de itens, ex: a sua colecção de CD's, pelo seu nome "natural") ou para ter um wiki com conjuntos de caracteres não-ocidentais. Ao duplicar as aspas ["desta "" forma"] pode incluir uma no nome da página se necessário.
URLs e Imagens Internas
Existem várias formas para inserir referências externas^1^ no texto:
inserção de URL directos; se o URL terminar com uma extensão de imagem (".gif", ".jpg" ou ".png"), o URL é convertido para uma tag de imagem.
- URLs entre parênteses.
ligações de LigaçõesEntreWikis.
- endereços de correio electrónico.
Se inserir URLs no texto normal, existe o problema da detecção do que pertence ou não ao URL. Existem quatro formas de forçar o fim de um URL:
- coloque um espaço a seguir ao URL,
utilize a funcionalidade do espaçamento das seis plicas,
- coloque o URL entre aspas; se o URL contiver uma citação duplique as aspas,
- utilize a sintaxe de URLs entre parênteses.
Os esquemas de URL suportados são: http, https, ftp, nntp, news, mailto, telnet, irc e file. O administrador do seu wiki pode adicionar esquemas suportados utilizando a variável url_schemas (ver o tópico AjudaNaConfiguração).
Adicionalmente aos esquemas standard, existem ainda os esquemas específicos do MoinMoin: wiki, attachment, inline, e drawing. O "wiki" indica uma ligação de LigaçõesEntreWikis, assim MoinMoin:PáginaPrincipal e wiki:MoinMoin:PáginaPrincipal são equivalentes; irá preferir geralmente a versão mais curta: o esquema "wiki" torna-se importante quando utiliza ligações em brackets, uma vez que aí necessitará sempre de um esquema. Os outros três esquemas são relacionados a anexos de ficheiros e são explicados no tópico AjudaNasAcções/AttachFile. Para utilizar espaços no nome da página de LigaçõesEntreWikis, coloque o nome da página entre aspas: MoinMoin:"página com espaços", para utilizar aspas no nome: MoinMoin:"página com ""as"" aspas".
Para mais informações sobre a formatação possível, consulte o tópico AjudaNaEdição. Para mais informações sobre ligações a subpáginas, consulte o tópico AjudaNaEdição/SubPáginas.
Para inserir âncoras numa página, necessita da macro Anchor: [[Anchor(nome da âncora)]]. Onde se lê "nome da âncora", escreve-se o identificador real da âncora. Para referencir uma âncora na mesma página do wiki utilize [#nomedaâncora] ou [#nomedaâncora texto da legenda]. Para criar uma ligação para uma âncora numa outra página do wiki, escreva [:NomeDaPágina#nomedaâncora] ou [:NomeDaPágina#nomedaâncora:texto da legenda], where "NomeDaPágina" is the name of the other page and "anchorname" is the identifier of the anchor on that page.
É aconselhável criar uma ligação para uma página de Wiki no Wiki actual, mas a ligação surge com uma legenda de texto diferente. Embora possa utilizar uma ligação de LigaçõesEntreWikis com o próprio nome do Wiki, isto criará um ícone de prefixo das LigaçõesEntreWikis, o que pode levar em erro, uma vez que não chega a sair do wiki actual. Utilize a sintaxe de [:PáginaDoWiki:Texto da legenda] para conseguir uma ligação para uma página do wiki actual sem criar uma ligação do tipo LigaçõesEntreWikis.
Em alguns Wikis, uma ligação para a página AlteraçõesRecentes pode referir-se à mesma página da ligação alteraçõesrecentes. Isto é especialmente verdade para os sistemas Windows e Mac OS X, uma vez que não são normalmente sensíveis a maiúsculas/minúsculas.
O oposto de referências externas são as internas, ligações NomeDeWiki automáticas. (1)
Evitar algumas coisas resulta em ligações automáticas
Para evitar que uma palavra como NomeDaPágina seja convertida numa ligação automaticamente, utilize Nome``Da``Página.
Pode igualmente suprimir um NomeDeWiki colocando um ponto de exclamação (bang) antes do NomeDeWiki, ou seja, !NomeDeWiki. Isto pode ser desactivado com a opção de configuração bang_meta = False.
Para evitar que um URL seja convertido numa ligação automaticamente, utilize `http://...` ou {{{http://...}}}.
Exemplo
* http://moinmoin.wikiwikiweb.de/ * [[http://moinmoin.wikiwikiweb.de/]] * [[http://moinmoin.wikiwikiweb.de/|Página Principal do MoinMoin]] * {{http://moinmoin.wikiwikiweb.de/wiki/common/moinmoin.png}} * [[http://moinmoin.wikiwikiweb.de/wiki/common/moinmoin.png]] * [[http://moinmoin.wikiwikiweb.de/wiki/common/moinmoin.png|moinmoin.png]] * [[http:/wiki/common/moinmoin.png]] URL parcial * LigaçõesEntreWikis * LigaçõesEntreWikis * MeatBall:InterWiki * MeatBall:InterWiki * MeatBall:InterWiki * [[MeatBall:InterWiki|Página de LigaçõesEntreWikis no MeatBall]] * [[WikiMoinMoin|MoinMoin]]:"página com espaços" (não existe) * [[WikiMoinMoin|MoinMoin]]:"página com espaços ""e"" aspas" (não existe) * correio electrónico * utilizador@example.com * mailto:utilizador@example.com?subject=teste * [[mailto:utilizador@example.com?subject=teste|Enviar mensagem]] * [[InterWiki|Página de LigaçõesEntreWikis neste wiki]] * [[#nomedaâncora|Ligação para uma âncora nesta página]] * [[OutraPágina#nomedaâncora|Ligação para uma âncora numa outra página deste wiki com texto de legenda]]
Exibição
http:/wiki/common/moinmoin.png URL parcial
- correio electrónico
Ligação para uma âncora numa outra página deste wiki com texto de legenda