Menautkan ke halaman Wiki lain di GitHub? [Tutup]

197

Wiki GitHub memungkinkan Anda untuk menautkan ke halaman lain di wiki seperti:

[[Wiki Page Name]]

Namun, saya ingin menampilkan teks yang berbeda dari nama halaman wiki saat membuat tautan. Apakah ada cara untuk melakukan ini? Apakah saya salah menautkan ke halaman wiki?

github TaylorOtwell
sumber

Jawaban:

86

GitHub secara default menggunakan sintaks Markdown untuk wiki sehingga Anda bisa melakukan:

[Arbitrary Link Text](Wiki Page Name)

Lihat Markdown dan posting blog ini untuk informasi lebih lanjut tentang wiki mereka dan sintaks markup lainnya yang mereka dukung.

Solusi ini memiliki masalah ketika Anda berada di beranda karena ia membuat URL relatif. Lihat jawaban Sven , di bawah ini.

cbley
sumber
24
Jawaban @ Sven benar, jawaban ini salah.
Jon Cram
23
Ini membuat tautan url relatif, jadi jika Anda berada di direktori yang sama dengan halaman yang Anda coba tautkan berfungsi, jika tidak, tautan itu tidak. Khususnya, jika Anda berada di halaman Beranda (http: //.../project_name/wiki), ini tidak akan berfungsi, karena semua halaman lain ada di direktori wiki, sedangkan beranda tidak.
mltsy
4
-1 sejak rusak; Perlu diperbarui untuk memasukkan komentar terakhir di utas ini dan saya akan berubah menjadi +1.
Merlyn Morgan-Graham
8
Ya, [[Link Text|WikiPage]]bekerja untuk saya. Tolong tambahkan ke jawaban Anda
Anton Danilchenko
5
Pada Mei 2014, ini tampaknya telah diperbaiki di GitHub. Jawaban ini sekarang berfungsi di semua halaman. Namun, pratinjau masih rusak.
drhagen
281

Menggunakan sintaks tautan Markdown

[Link Text](WikiPage)

tampaknya berfungsi di pratinjau edit tetapi tidak pada halaman wiki yang sebenarnya. Setidaknya bagi saya tautan yang dihasilkan WikiPagebukan wiki/WikiPagedan saya mendapatkan GitHub 404 yang terkenal .

Namun sintaks MediaWiki

[[Link Text|WikiPage]]

bekerja untuk saya, bahkan untuk halaman wiki Markdown.

Sven Jacobs
sumber
4
Selanjutnya, jika link teks dan halaman Wiki yang sama, Anda dapat hanya menggunakan: [[My Wonderful Wiki Page]]. Ini akan ditautkan ke wiki/My-Wonderful-Wiki-Page.
Jimothy
7
Ya, [[Link Text|WikiPage]]bekerja untuk saya. Harap edit jawaban Anda
Anton Danilchenko
6
Ini seharusnya menjadi jawaban yang diterima.
Kenny Cason
1
Berikut ini adalah referensi untuk Tambahkan tautan ke wiki
Ricardo
1
Perhatikan bahwa pada Maret 2019, sementara sintaksis MediaWiki berfungsi untuk tautan dengan teks biasa sebagai teks tautan, itu terputus ketika diminta untuk mem-parsing teks tautan dengan pemformatan apa pun, apakah sintaks Markdown atau MediaWiki. Misalnya, `` `[[Deskripsi foo| Foo]]` `` akan merender markup sumber (diformat kode), bukan tautan yang dimaksud. Jika ada yang tahu cara mengatasi hal ini, beri tahu saya.
Jeff Dickey
29

Bagian ref internal relatif terhadap proyek Anda. Untuk halaman wiki gunakan:

[Page Name](wiki/Page-Name)

Pada pratinjau tautan akan rusak tetapi ketika halaman disimpan itu akan berfungsi.

Brett
sumber
1
Berfungsi tetapi jawaban Sven bekerja lebih baik.
Ulrich Stern
4
Ada masalah dengan ini ketika menggunakan di dalam bilah sisi khusus, jika Anda menavigasi ke salah satu tautan Anda, seperti wiki/Page-Name, lalu di wiki/Page-Namebilah sisi halaman, tautan yang rusak memiliki wikielemen ganda seperti wiki/wiki/Page-Name.
Matt
-7

Periksa bantuan editor wiki. Ini memberitahu Anda:

Untuk membuat tautan referensi, gunakan dua set tanda kurung. [my internal link][internal-ref]akan ditautkan ke referensi internal internal-ref.

Tekkub
sumber
2
Saya juga melihat itu, tetapi tidak berhasil, karena - sebagaimana disebutkan dengan cerdik - penurunan harga memerlukan kurung bulat di sekitar internal-ref. Saya heran mengapa bantuan tersebut berisi informasi yang salah.
Ethan Leroy
2
Editor bantuan wiki memang mengatakan hal itu, tetapi "referensi internal" dalam hal ini merujuk pada referensi penurunan harga dalam halaman, bukan halaman lain dalam wiki yang sama. Lihat sintaks tautan Markdown untuk info lebih lanjut.
Calrion