Liên kết đến các trang Wiki khác trên GitHub? [đóng cửa]

197

Các wiki của GitHub cho phép bạn liên kết đến các trang khác trong wiki như vậy:

[[Wiki Page Name]]

Tuy nhiên, tôi muốn hiển thị văn bản khác với tên trang wiki khi tạo liên kết. Có cách nào để làm việc này không? Tôi có liên kết đến các trang wiki không?

github

— TaylorOtwell
nguồn

86

Theo mặc định, GitHub sử dụng cú pháp Markdown cho wiki để bạn có thể thực hiện:

[Arbitrary Link Text](Wiki Page Name)

Kiểm tra Markdown và bài đăng trên blog này để biết thêm thông tin về wiki của họ và các cú pháp đánh dấu khác mà họ hỗ trợ.

Giải pháp này có vấn đề khi bạn ở trang chủ vì nó tạo ra các URL tương đối. Kiểm tra câu trả lời của Sven , dưới đây.

— cbley
nguồn

24

Câu trả lời của @ Sven là đúng, câu trả lời này là sai.

— Jon Cram

23

Điều này tạo ra một liên kết url tương đối, vì vậy nếu bạn tình cờ ở cùng thư mục với trang bạn đang cố gắng liên kết với nó hoạt động, nếu không, nó không hoạt động. Cụ thể, nếu bạn trên Trang chủ (http: //.../project_name/wiki), điều này sẽ không hoạt động, vì tất cả các trang khác đều nằm trong thư mục wiki, trong khi trang chủ thì không.

— mltsy

4

-1 kể từ khi nó vỡ; Cần được cập nhật để bao gồm nhận xét cuối cùng về chủ đề này và tôi sẽ thay đổi thành +1.

— Merlyn Morgan-Graham

8

Vâng, [[Link Text|WikiPage]]làm việc cho tôi. Lời cầu xin thêm vào câu trả lời của bạn

— Anton Danilchenko

5

Kể từ tháng 5 năm 2014, điều này dường như đã được sửa trên GitHub. Câu trả lời này bây giờ hoạt động trên tất cả các trang. Tuy nhiên, bản xem trước vẫn bị hỏng.

— drhagen

280

Sử dụng cú pháp liên kết Markdown

[Link Text](WikiPage)

dường như hoạt động trong bản xem trước chỉnh sửa nhưng không phải trên trang wiki thực tế. Ít nhất với tôi, liên kết được tạo ra WikiPagethay vì wiki/WikiPagevà tôi nhận được GitHub 404 nổi tiếng .

Tuy nhiên cú pháp MediaWiki

[[Link Text|WikiPage]]

làm việc cho tôi, ngay cả đối với các trang wiki Markdown.

— Sven Jacobs
nguồn

4

Hơn nữa, nếu văn bản liên kết và trang Wiki giống nhau, bạn chỉ cần sử dụng : [[My Wonderful Wiki Page]]. Điều này sẽ liên kết đến wiki/My-Wonderful-Wiki-Page.

— Jimothy

7

Vâng, [[Link Text|WikiPage]]làm việc cho tôi. Xin vui lòng chỉnh sửa câu trả lời của bạn

— Anton Danilchenko

6

Điều này chắc chắn nên là câu trả lời được chấp nhận.

— Kenny Cason

1

Dưới đây là một tham chiếu đến Thêm liên kết đến wiki

— Ricardo

1

Lưu ý rằng, kể từ tháng 3 năm 2019, trong khi cú pháp MediaWiki hoạt động đối với các liên kết với văn bản thuần túy là văn bản liên kết, nó sẽ bị hỏng khi được yêu cầu phân tích văn bản liên kết với bất kỳ định dạng nào, cho dù là cú pháp Markdown hoặc MediaWiki. Ví dụ, `` `[[Mô tả về foo| Foo]]` `` sẽ hiển thị đánh dấu nguồn (được định dạng mã), không phải là liên kết dự định. Nếu bất cứ ai biết một cách xung quanh này, xin vui lòng cho tôi biết.

— Jeff Dickey

29

Phần ref-nội bộ có liên quan đến dự án của bạn. Đối với các trang wiki sử dụng:

[Page Name](wiki/Page-Name)

Trong bản xem trước, liên kết sẽ bị hỏng nhưng khi trang được lưu, nó sẽ hoạt động.

— Brett
nguồn

1

Hoạt động nhưng câu trả lời của Sven hoạt động tốt hơn.

— Ulrich Stern

4

Có một vấn đề với điều này khi sử dụng bên trong một thanh bên tùy chỉnh, nếu bạn điều hướng đến một trong các liên kết của mình, như wiki/Page-Nametrong wiki/Page-Namethanh bên của trang, các liên kết bị hỏng có một wikiyếu tố kép như thế wiki/wiki/Page-Name.

— Matt

-7

Kiểm tra trợ giúp của biên tập viên wiki. Nó nói với bạn:

Để tạo một liên kết tham chiếu, sử dụng hai bộ dấu ngoặc vuông. [my internal link][internal-ref]sẽ liên kết đến tài liệu tham khảo nội bộ internal-ref.

— Tekkub
nguồn

2

Tôi cũng đã thấy điều đó, nhưng nó không hoạt động, bởi vì - như đã đề cập đến - Markdown yêu cầu dấu ngoặc tròn xung quanh nội bộ-ref. Tôi tự hỏi tại sao sự giúp đỡ chứa thông tin sai.

— Ethan Leroy

2

Trình soạn thảo trợ giúp của wiki nói điều đó, nhưng "tham chiếu nội bộ" trong trường hợp này đề cập đến một tham chiếu Markdown trong trang, chứ không phải một trang khác trong cùng wiki. Xem cú pháp liên kết Markdown để biết thêm.

— Calrion