¿Vinculando a otras páginas Wiki en GitHub? [cerrado]

197

Los wikis de GitHub le permiten vincular a otras páginas en la wiki de esta manera:

[[Wiki Page Name]]

Sin embargo, quiero mostrar un texto diferente al nombre de la página wiki al hacer el enlace. ¿Hay alguna forma de hacer esto? ¿Estoy mal vinculado a páginas wiki?

TaylorOtwell
fuente

Respuestas:

86

GitHub por defecto usa la sintaxis Markdown para los wikis, por lo que puedes hacer lo siguiente:

[Arbitrary Link Text](Wiki Page Name)

Consulte Markdown y esta publicación de blog para obtener más información sobre sus wikis y las otras sintaxis de marcado que admiten.

Esta solución tiene problemas cuando está en la página de inicio porque crea URL relativas. Mira la respuesta de Sven , a continuación.

cbley
fuente
24
La respuesta de @ Sven es correcta, esta respuesta es incorrecta.
Jon Cram
23
Esto crea un enlace de URL relativo, por lo que si se encuentra en el mismo directorio que la página que está intentando vincular funciona, de lo contrario, no lo hará. Específicamente, si está en la página de inicio (http: //.../project_name/wiki), esto no funcionará, porque todas las demás páginas están en el directorio wiki, mientras que la página de inicio no lo está.
mltsy
44
-1 ya que se rompe; Necesita actualizarse para incluir el último comentario en este hilo y cambiaré a +1.
Merlyn Morgan-Graham
8
Si, [[Link Text|WikiPage]]funciona para mi. Súplicas agregue a su respuesta
Anton Danilchenko
55
A partir de mayo de 2014, esto parece haberse solucionado en GitHub. Esta respuesta ahora funciona en todas las páginas. Sin embargo, la vista previa todavía está rota.
drhagen
281

Uso de la sintaxis del enlace Markdown

[Link Text](WikiPage)

parece funcionar en la vista previa de edición, pero no en la página wiki real. Al menos para mí, el enlace generado es en WikiPagelugar de wiki/WikiPagey obtengo el famoso GitHub 404 .

Sin embargo, la sintaxis de MediaWiki

[[Link Text|WikiPage]]

funciona para mí, incluso para las páginas wiki de Markdown.

Sven Jacobs
fuente
44
Además, si el texto del enlace y la página Wiki son los mismos, sólo tiene que utilizar: [[My Wonderful Wiki Page]]. Esto vinculará a wiki/My-Wonderful-Wiki-Page.
Jimothy
77
Si, [[Link Text|WikiPage]]funciona para mi. Por favor edite su respuesta
Anton Danilchenko
66
Esta definitivamente debería ser la respuesta aceptada.
Kenny Cason
1
Aquí hay una referencia para Agregar enlaces a wikis
Ricardo
1
Tenga en cuenta que, a partir de marzo de 2019, aunque la sintaxis de MediaWiki funciona para enlaces con texto sin formato como texto de enlace, se rompe cuando se le pide que analice el texto de enlace con cualquier formato, ya sea Markdown o sintaxis de MediaWiki. Por ejemplo, `` `[[Descripción de foo| Foo]]` `` generará el marcado de origen (con formato de código), no el enlace deseado. Si alguien sabe cómo evitar esto, avíseme.
Jeff Dickey
29

La parte de referencia interna es relativa a su proyecto. Para páginas wiki use:

[Page Name](wiki/Page-Name)

En la vista previa, el enlace se romperá, pero cuando se guarde la página funcionará.

Brett
fuente
1
Funciona pero la respuesta de Sven funciona mejor.
Ulrich Stern
44
Hay un problema con esto cuando se usa dentro de una barra lateral personalizada, si navega a uno de sus enlaces, como wiki/Page-Name, en la wiki/Page-Namebarra lateral de la página, los enlaces se rompen con un wikielemento doble como wiki/wiki/Page-Name.
Matt
-7

Consulte la ayuda del editor wiki. Te dice:

Para crear un enlace de referencia, use dos conjuntos de corchetes. [my internal link][internal-ref]se vinculará a la referencia interna internal-ref.

Tekkub
fuente
2
También lo vi, pero no funciona porque, como cbley mencionó, Markdown requiere corchetes alrededor de la referencia interna. Me pregunto por qué la ayuda contiene información incorrecta.
Ethan Leroy
2
El editor de ayuda de la wiki dice eso, pero la "referencia interna" en este caso se refiere a una referencia de Markdown en la página, no a otra página en la misma wiki. Consulte la sintaxis del enlace Markdown para obtener más información.
Calrion