Làm cách nào để tạo một số loại nội dung trong GitHub wiki?

Question

Nếu bạn nhìn vào đây: http://en.wikipedia.org/wiki/Stack_Overflow

Bạn sẽ nhận thấy có một phần "Nội dung", nếu bạn nhấp vào một trong các liên kết, nó sẽ đưa bạn đến một phần cụ thể trên trang.

Làm thế nào để làm điều này trong GitHub wiki? Với Markdown hoặc bất cứ điều gì họ sử dụng?

Answer 1

Nó là độc đáo thể hiện trong Table of Contents của Markdown Cheatsheet.

##### Table of Contents 
[Headers](#headers) 
[Emphasis](#emphasis) 
...snip...  
<a name="headers"/> 
## Headers 

Nếu bạn di chuột qua đầu trang trong tệp GitHub Markdown, bạn sẽ thấy một liên kết đơn giản ở bên trái, bạn cũng có thể sử dụng liên kết đó. Định dạng cho liên kết đó là <project URL#<header name>. Các <header name> phải được tất cả các trường hợp thấp hơn.

Answer 2

Một thể (bán tự động) Giải pháp là Eugene Kalinin của github-markdown-toc. Công cụ này chủ yếu là crunches thông qua tập tin README.md của bạn và snarfs ra các tiêu đề của # để tạo ra một TOC.

1. Tải về kịch bản https://github.com/ekalinin/github-markdown-toc

2. Thức ăn của bạn README.md để kịch bản (như đã nêu trong README.md Eugene)

   mèo README.md | bash github-markdown-toc

3. Cắt và dán TOC tạo ra và đặt nó ở phía trên cùng của README.md tập tin của bạn

Lưu ý rằng việc thực hiện bash này chỉ hoạt động trên Linux (từ những gì tôi có thể nói).

Như một mặt lưu ý, có một golang implementation và có lẽ là nhiều hơn một rắc rối để có được làm việc.

Answer 3

https://github.com/jonschlinkert/markdown-toc

• git clone your-repo.wiki.git (thêm .wiki ngay trước .git để clone wiki
• npm i -g markdown-toc
• Chèn <!-- toc --> (case sensitive) trong markdown của wiki của bạn
• markdown-toc -i my-wiki-markdown.md (-i sẽ chỉnh sửa nó trong nơi)
• Lợi nhuận

Answer 4

Hiện tại, not possible làm điều đó bằng cú pháp đánh dấu (.md). Hiện đang diễn ra không chính thức discussion about automatically generating table of contents TOC trên các tệp đánh dấu được hiển thị như README.md liệt kê một số ý tưởng.

Tuy nhiên có một số cách giải quyết khác như:

• Sử dụng AsciiDoc thay vì theo đề nghị từ suggestion này.Ví dụ:

  :toc: macro 
  :toc-title: 
  :toclevels: 99 
  # Title 
  
  ## A 
  
  ### A2 
  
  ## B 
  
  ### B2 
  

  Kiểm tra ví dụ tại littlebits/react-popover (README.adoc).

• online Table Of Content Generator (raychenon/play-table-of-contents)

• arthurhammer/github-toc - phần mở rộng trình duyệt có thêm một bảng nội dung để Repos GitHub

Answer 5

Bạn có thể chọn các chế độ Edit "MediaWiki" mà sẽ tạo ra một toc cho các tiêu đề , ví dụ

== First == 

== Second ==