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

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