Verlinkung zu anderen Wiki-Seiten auf GitHub? [geschlossen]

197

Mit GitHub-Wikis können Sie wie folgt auf andere Seiten im Wiki verlinken:

[[Wiki Page Name]]

Ich möchte jedoch beim Erstellen des Links einen anderen Text als den Namen der Wiki-Seite anzeigen. Gibt es eine Möglichkeit, dies zu tun? Verlinke ich falsch auf Wiki-Seiten?

github TaylorOtwell
quelle

Antworten:

86

GitHub verwendet standardmäßig die Markdown- Syntax für die Wikis, sodass Sie einfach Folgendes tun können:

[Arbitrary Link Text](Wiki Page Name)

Check out Markdown und dieses Blog - Post für mehr Informationen über ihre Wikis und den anderen Markup Syntaxen sie unterstützen.

Diese Lösung weist Probleme auf, wenn Sie sich auf der Startseite befinden, da relative URLs erstellt werden. Schauen Sie sich Svens Antwort unten an.

cbley
quelle
24
@ Svens Antwort ist richtig, diese Antwort ist falsch.
Jon Cram
23
Dadurch wird ein relativer URL-Link erstellt. Wenn Sie sich also zufällig im selben Verzeichnis befinden wie die Seite, auf die Sie einen Link erstellen möchten, funktioniert dies nicht. Andernfalls funktioniert dies nicht. Insbesondere wenn Sie sich auf der Startseite (http: //.../project_name/wiki) befinden, funktioniert dies nicht, da sich alle anderen Seiten im Wiki-Verzeichnis befinden, während sich die Startseite nicht befindet.
mltsy
4
-1 da es bricht; Muss aktualisiert werden, um den letzten Kommentar zu diesem Thread aufzunehmen, und ich werde zu +1 wechseln.
Merlyn Morgan-Graham
8
Ja, [[Link Text|WikiPage]] arbeitet für mich.
Bitte
5
Ab Mai 2014 scheint dies auf GitHub behoben worden zu sein. Diese Antwort funktioniert jetzt auf allen Seiten. Die Vorschau ist jedoch immer noch fehlerhaft.
drhagen
280

Verwenden der Markdown-Link-Syntax

[Link Text](WikiPage)

scheint in der Bearbeitungsvorschau zu funktionieren, aber nicht auf der eigentlichen Wiki-Seite. Zumindest für mich ist der generierte Link WikiPagestatt wiki/WikiPageund ich bekomme den berühmten GitHub 404 .

Allerdings die MediaWiki-Syntax

[[Link Text|WikiPage]]

funktioniert für mich auch für Markdown-Wiki-Seiten.

Sven Jacobs
quelle
4
Wenn der Linktext und die Wiki-Seite identisch sind, können Sie einfach Folgendes verwenden : [[My Wonderful Wiki Page]]. Dies wird verlinkt auf wiki/My-Wonderful-Wiki-Page.
Jimothy
7
Ja, [[Link Text|WikiPage]]arbeitet für mich.
Bitte
6
Dies sollte definitiv die akzeptierte Antwort sein.
Kenny Cason
1
Hier ist ein Verweis auf Links zu Wikis hinzufügen
Ricardo
1
Beachten Sie, dass die MediaWiki-Syntax ab März 2019 zwar für Links mit einfachem Text als Linktext funktioniert , jedoch unterbrochen wird, wenn Sie aufgefordert werden, den Linktext mit einer beliebigen Formatierung zu analysieren, unabhängig davon, ob es sich um eine Markdown- oder eine MediaWiki-Syntax handelt. Beispiel: `` [[Beschreibung von foo| Foo]] `` `rendert das (codeformatierte) Quell-Markup, nicht den beabsichtigten Link. Wenn jemand einen Weg kennt, lassen Sie es mich bitte wissen.
Jeff Dickey
29

Der interne Referenzteil bezieht sich auf Ihr Projekt. Verwenden Sie für Wiki-Seiten:

[Page Name](wiki/Page-Name)

In der Vorschau wird der Link unterbrochen, aber wenn die Seite gespeichert wird, funktioniert sie.

Brett
quelle
1
Funktioniert, aber Svens Antwort funktioniert besser.
Ulrich Stern
4
Bei der Verwendung in einer benutzerdefinierten Seitenleiste tritt ein Problem auf. Wenn Sie zu einem Ihrer Links navigieren, z. B. wiki/Page-Namein der wiki/Page-NameSeitenleiste der Seite, werden Links mit einem doppelten wikiElement wie unterbrochen wiki/wiki/Page-Name.
Matt
-7

Überprüfen Sie die Hilfe des Wiki-Editors. Es sagt dir:

Verwenden Sie zum Erstellen eines Referenzlinks zwei eckige Klammern. [my internal link][internal-ref]wird auf die interne Referenz verlinken internal-ref.

Tekkub
quelle
2
Ich habe das auch gesehen, aber es funktioniert nicht, weil - wie bereits erwähnt - Markdown runde Klammern um den internen Verweis erfordert. Ich frage mich, warum die Hilfe falsche Informationen enthält.
Ethan Leroy
2
Der Hilfeditor des Wikis sagt dies, aber "interne Referenz" bezieht sich in diesem Fall auf eine Markdown-Referenz auf der Seite, nicht auf eine andere Seite im selben Wiki. Weitere Informationen finden Sie in der Markdown-Link-Syntax .
Calrion