Linkando para outras páginas da Wiki no GitHub? [fechadas]

197

As wikis do GitHub permitem que você faça o link para outras páginas da wiki da seguinte forma:

[[Wiki Page Name]]

No entanto, quero exibir um texto diferente do nome da página da wiki ao criar o link. Existe uma maneira de fazer isso? Estou ligando para as páginas wiki totalmente erradas?

github TaylorOtwell
fonte

Respostas:

86

Por padrão, o GitHub usa a sintaxe Markdown para os wikis, para que você possa fazer:

[Arbitrary Link Text](Wiki Page Name)

Confira o Markdown e esta postagem no blog para obter mais informações sobre os wikis e as outras sintaxes de marcação que eles suportam.

Esta solução tem problemas quando você está na página inicial porque cria URLs relativos. Confira a resposta de Sven , abaixo.

cbley
fonte
24
@ A resposta de Sven está correta, esta resposta está errada.
11138 Jon Cram
23
Isso cria um link de URL relativo; portanto, se você estiver no mesmo diretório que a página que está tentando vincular, funciona, caso contrário, não funcionará. Especificamente, se você estiver na página inicial (http: //.../project_name/wiki), isso não funcionará, porque todas as outras páginas estão no diretório wiki, enquanto a página inicial não.
mltsy
4
-1 desde que se quebre; Precisa ser atualizado para incluir o último comentário neste tópico e mudarei para +1.
Merlyn Morgan-Graham
8
Sim, [[Link Text|WikiPage]]funciona para mim. Fundamentos, adicione sua resposta
Anton Danilchenko 15/04
5
Em maio de 2014, isso parece ter sido corrigido no GitHub. Esta resposta agora funciona em todas as páginas. No entanto, a visualização ainda está interrompida.
Drhagen
281

Usando a sintaxe do link Markdown

[Link Text](WikiPage)

parece funcionar na visualização de edição, mas não na página wiki real. Pelo menos para mim, o link gerado é em WikiPagevez de wiki/WikiPagee recebo o famoso GitHub 404 .

No entanto, a sintaxe do MediaWiki

[[Link Text|WikiPage]]

funciona para mim, mesmo para as páginas wiki do Markdown.

Sven Jacobs
fonte
4
Além disso, se o texto do link e página Wiki são os mesmos, você pode simplesmente usar: [[My Wonderful Wiki Page]]. Isso será vinculado a wiki/My-Wonderful-Wiki-Page.
perfil completo de Jimothy
7
Sim, [[Link Text|WikiPage]]funciona para mim. Por favor, edite sua resposta
Anton Danilchenko
6
Definitivamente, essa deve ser a resposta aceita.
precisa saber é o seguinte
1
Aqui está uma referência para Adicionar links a wikis
Ricardo
1
Observe que, em março de 2019, enquanto a sintaxe do MediaWiki trabalha para links com texto sem formatação como o texto do link, ela é interrompida quando solicitada a analisar o texto do link com qualquer formatação, seja Markdown ou MediaWiki. Por exemplo, `` `[[Description of foo| Foo]]` `` `renderizará a marcação de origem (formatada em código), não o link pretendido. Se alguém souber uma maneira de contornar isso, entre em contato.
Jeff Dickey
29

A parte internal-ref é relativa ao seu projeto. Para páginas wiki, use:

[Page Name](wiki/Page-Name)

Na visualização, o link será quebrado, mas quando a página for salva, ela funcionará.

Brett
fonte
1
Funciona, mas a resposta de Sven funciona melhor.
Ulrich Stern
4
Há um problema com isso ao usar dentro de uma barra lateral personalizada, se você navegar para um dos seus links, como wiki/Page-Namena wiki/Page-Namebarra lateral da página, os links são quebrados com um wikielemento duplo como wiki/wiki/Page-Name.
Matt
-7

Verifique a ajuda do editor de wiki. Diz-lhe:

Para criar um link de referência, use dois conjuntos de colchetes. [my internal link][internal-ref]vinculará à referência interna internal-ref.

Tekkub
fonte
2
Eu também vi isso, mas não funciona, porque - como cbley mencionou - o Markdown requer colchetes em volta da referência interna. Eu me pergunto por que a ajuda contém informações erradas.
Ethan Leroy
2
O editor de ajuda do wiki diz isso, mas "referência interna" nesse caso refere-se a uma referência Markdown na página, e não a outra página no mesmo wiki. Veja a sintaxe do link Markdown para mais informações.
Calrion