Lien vers d'autres pages Wiki sur GitHub? [fermé]

197

Les wikis GitHub vous permettent de créer des liens vers d'autres pages du wiki comme ceci:

[[Wiki Page Name]]

Cependant, je veux afficher un texte différent de celui de la page wiki lors de la création du lien. Y a-t-il un moyen de faire cela? Suis-je en train de créer un lien vers des pages wiki?

github TaylorOtwell
la source

Réponses:

86

GitHub utilise par défaut la syntaxe Markdown pour les wikis, vous pouvez donc simplement faire:

[Arbitrary Link Text](Wiki Page Name)

Consultez Markdown et ce billet de blog pour plus d'informations sur leurs wikis et les autres syntaxes de balisage qu'ils prennent en charge.

Cette solution a des problèmes lorsque vous êtes sur la page d'accueil car elle crée des URL relatives. Découvrez la réponse de Sven , ci-dessous.

cbley
la source
24
@ La réponse de Sven est correcte, cette réponse est fausse.
Jon Cram
23
Cela crée un lien URL relatif, donc si vous vous trouvez dans le même répertoire que la page que vous essayez de créer un lien, cela ne fonctionne pas. Plus précisément, si vous êtes sur la page d'accueil (http: //.../project_name/wiki), cela ne fonctionnera pas, car toutes les autres pages sont dans le répertoire wiki, contrairement à la page d'accueil.
mltsy
4
-1 car il casse; Doit être mis à jour pour inclure le dernier commentaire sur ce fil et je passerai à +1.
Merlyn Morgan-Graham
8
Oui, [[Link Text|WikiPage]]ça marche pour moi. Des suppléments s'ajoutent à votre réponse
Anton Danilchenko
5
En mai 2014, cela semble avoir été corrigé sur GitHub. Cette réponse fonctionne maintenant sur toutes les pages. Cependant, l'aperçu est toujours interrompu.
drhagen
281

Utilisation de la syntaxe de lien Markdown

[Link Text](WikiPage)

semble fonctionner dans l'aperçu de l'édition mais pas sur la page wiki réelle. Au moins pour moi, le lien généré est WikiPageau lieu de wiki/WikiPageet j'obtiens le célèbre GitHub 404 .

Cependant la syntaxe MediaWiki

[[Link Text|WikiPage]]

fonctionne pour moi, même pour les pages wiki Markdown.

Sven Jacobs
la source
4
De plus, si le texte du lien et la page Wiki sont les mêmes, vous pouvez simplement utiliser: [[My Wonderful Wiki Page]]. Ceci sera lié à wiki/My-Wonderful-Wiki-Page.
Jimothy
7
Oui, [[Link Text|WikiPage]]ça marche pour moi. Veuillez modifier votre réponse
Anton Danilchenko
6
Cela devrait certainement être la réponse acceptée.
Kenny Cason
1
Voici une référence à Ajouter des liens vers les wikis
Ricardo
1
Notez que, à compter de mars 2019, bien que la syntaxe MediaWiki fonctionne pour les liens avec du texte brut comme texte de lien, elle se casse lorsqu'on lui demande d'analyser le texte de lien avec n'importe quel format, qu'il s'agisse de la syntaxe Markdown ou MediaWiki. Par exemple, `` [[Description de foo| Foo]] `` rendra le balisage source (formaté en code), pas le lien prévu. Si quelqu'un connaît un moyen de contourner ce problème, faites-le moi savoir.
Jeff Dickey
29

La partie référence interne est relative à votre projet. Pour les pages wiki, utilisez:

[Page Name](wiki/Page-Name)

Dans l'aperçu, le lien sera rompu mais lorsque la page sera enregistrée, cela fonctionnera.

Brett
la source
1
Fonctionne mais la réponse de Sven fonctionne mieux.
Ulrich Stern
4
Il y a un problème avec cela lors de l'utilisation dans une barre latérale personnalisée, si vous accédez à l'un de vos liens, comme wiki/Page-Name, puis dans la wiki/Page-Namebarre latérale de la page, les liens sont rompus avec un double wikiélément comme wiki/wiki/Page-Name.
Matt
-7

Consultez l'aide de l'éditeur de wiki. Il vous dit:

Pour créer un lien de référence, utilisez deux jeux de crochets. [my internal link][internal-ref]sera lié à la référence interne internal-ref.

Tekkub
la source
2
J'ai également vu cela, mais cela ne fonctionne pas, car - comme l'a mentionné Cbley - Markdown nécessite des crochets autour de la référence interne. Je me demande pourquoi l'aide contient des informations erronées.
Ethan Leroy
2
L'éditeur d'aide du wiki le dit, mais la "référence interne" dans ce cas se réfère à une référence Markdown sur la page, pas à une autre page du même wiki. Voir la syntaxe du lien Markdown pour plus d'informations.
Calrion