Odnośniki do innych stron Wiki na GitHub? [Zamknięte]

197

Strony wiki GitHub pozwalają na linkowanie do innych stron na wiki w następujący sposób:

[[Wiki Page Name]]

Jednak podczas tworzenia linku chcę wyświetlać inny tekst niż nazwa strony wiki. Czy jest na to sposób? Czy wszystkie linki do stron wiki są nieprawidłowe?

github TaylorOtwell
źródło

Odpowiedzi:

86

GitHub domyślnie używa składni Markdown dla stron wiki, dzięki czemu możesz po prostu:

[Arbitrary Link Text](Wiki Page Name)

Sprawdź Markdown i ten post na blogu, aby uzyskać więcej informacji na temat ich stron wiki i innych obsługiwanych składni znaczników.

To rozwiązanie ma problemy, gdy jesteś na stronie głównej, ponieważ tworzy względne adresy URL. Sprawdź odpowiedź Svena poniżej.

cbley
źródło
24
@ Odpowiedź Svena jest poprawna, ta odpowiedź jest błędna.
Jon Cram,
23
Spowoduje to utworzenie względnego linku do adresu URL, więc jeśli zdarzy się, że znajdujesz się w tym samym katalogu, co strona, którą próbujesz połączyć, działa, w przeciwnym razie nie. W szczególności, jeśli przejdziesz na stronę główną (http: //.../project_name/wiki), to nie zadziała, ponieważ wszystkie inne strony znajdują się w katalogu wiki, podczas gdy strona główna nie.
mltsy,
4
-1, ponieważ się psuje; Musi zostać zaktualizowany, aby zawierał ostatni komentarz do tego wątku, a ja zmienię na +1.
Merlyn Morgan-Graham
8
Tak, [[Link Text|WikiPage]]działa dla mnie. Prośby dodają do twojej odpowiedzi
Anton Danilchenko
5
Od maja 2014 r. Wydaje się, że zostało to naprawione w GitHub. Ta odpowiedź działa teraz na wszystkich stronach. Jednak podgląd jest nadal zepsuty.
drhagen
280

Korzystanie ze składni łącza Markdown

[Link Text](WikiPage)

wydaje się działać w podglądzie edycji, ale nie na rzeczywistej stronie wiki. Przynajmniej dla mnie wygenerowany link jest WikiPagezamiast wiki/WikiPagei otrzymuję słynny GitHub 404 .

Jednak składnia MediaWiki

[[Link Text|WikiPage]]

działa dla mnie, nawet na stronach wiki Markdown.

Sven Jacobs
źródło
4
Ponadto, jeżeli tekst linku i strona Wiki są takie same, można po prostu użyć: [[My Wonderful Wiki Page]]. To będzie link do wiki/My-Wonderful-Wiki-Page.
Jimothy,
7
Tak, [[Link Text|WikiPage]]działa dla mnie. Zarzuty edytuj swoją odpowiedź
Anton Danilchenko
6
To zdecydowanie powinna być zaakceptowana odpowiedź.
Kenny Cason,
1
Oto odniesienie do Dodaj linki do stron wiki
Ricardo
1
Zwróć uwagę, że od marca 2019 r., Podczas gdy składnia MediaWiki działa dla linków z zwykłym tekstem jako tekstem linku, łamie się, gdy zostanie poproszony o parsowanie tekstu linku z dowolnym formatowaniem, niezależnie od tego, czy jest to składnia Markdown czy MediaWiki. Na przykład: `` [[Opis foo| Foo]] `` renderuje znaczniki źródłowe (sformatowane kodem), a nie zamierzone łącze. Jeśli ktoś zna sposób na obejście tego, daj mi znać.
Jeff Dickey
29

Wewnętrznego ref część jest w stosunku do projektu. W przypadku stron wiki użyj:

[Page Name](wiki/Page-Name)

W podglądzie link zostanie uszkodzony, ale po zapisaniu strony będzie działał.

Brett
źródło
1
Działa, ale odpowiedź Svena działa lepiej.
Ulrich Stern
4
Występuje z tym problem podczas korzystania z niestandardowego paska bocznego, jeśli przejdziesz do jednego z linków, np. wiki/Page-NameWtedy wiki/Page-Namena pasku bocznym strony linki są zepsute, mając podwójny wikielement, taki jak wiki/wiki/Page-Name.
Matt
-7

Sprawdź pomoc edytora wiki. Mówi ci:

Aby utworzyć łącze referencyjne, użyj dwóch zestawów nawiasów kwadratowych. [my internal link][internal-ref]będzie link do wewnętrznego odnośnika internal-ref.

Tekkub
źródło
2
Widziałem to również, ale to nie działa, ponieważ - jak wspomniano cbley - Markdown wymaga okrągłych nawiasów wokół wewnętrznego ref. Zastanawiam się, dlaczego pomoc zawiera nieprawidłowe informacje.
Ethan Leroy,
2
Edytor pomocy wiki tak mówi, ale „wewnętrzne odniesienie” w tym przypadku odnosi się do odwołania Markdown na stronie, a nie innej strony na tej samej wiki. Aby uzyskać więcej informacji, zobacz składnię łącza Markdown .
Calrion