Jak utworzyć pewien rodzaj tabeli treści w wiki GitHub?

Question

Jeśli spojrzeć tutaj: http://en.wikipedia.org/wiki/Stack_Overflow

Zauważysz tam sekcja trochę „Content”, po kliknięciu na jeden z linków, to wyśle ​​cię do specjalnej sekcji na stronie.

Jak to zrobić w wiki GitHub? Z Markdownem lub czymkolwiek, z czego korzystają?

Answer 1

Jest to ładnie przedstawione w Spisie treści Markdown Cheatsheet.

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

Jeśli po najechaniu na nagłówek w pliku Markdown GitHub, zobaczysz mały odnośnik proste do jego lewej strony, można też użyć tego linku. Format tego linku to <project URL#<header name>. Numer <header name> musi być pisany małymi literami.

Answer 2

Jednym z możliwych (półautomatycznych) rozwiązań jest github-markdown-toc Eugene'a Kalinina. To narzędzie zasadniczo przerywa Twój plik README.md i wygłusza nagłówki # w celu utworzenia spisu treści.

1. Pobierz skrypt https://github.com/ekalinin/github-markdown-toc

2. karmić README.md do skryptu (jak wspomniano w Eugeniusza README.md)

   kota README.md | bash github-Przecena-toc

3. Wytnij i wklej wygenerowany TOC i umieścić ją w górnej części pliku README.md

pamiętać, że ta realizacja bash działa tylko na Linuksie (z tego co mogę powiedzieć).

Na marginesie, istnieje golang implementation i jest to prawdopodobnie więcej kłopotów z podjęciem pracy.

Answer 3

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

• git clone your-repo.wiki.git (dodaj .wiki tuż przed .git sklonować wiki
• npm i -g markdown-toc
• Insert <!-- toc --> (liter) w obniżki twojej wiki
• markdown-toc -i my-wiki-markdown.md (-i będzie edytować w miejsce)
• Zysk

Answer 4

Obecnie to not possible to zrobić za pomocą składni Markdown (.md). Trwa nieoficjalne przetwarzanie discussion about automatically generating table of contents TOC plików oznaczeń, takich jak README.md, które zawierają niektóre z pomysłów.

Jednakże istnieją pewne inne obejścia takich jak:

• Zastosowanie AsciiDoc zamiast zgodnie z sugestią z tego suggestion.Na przykład:

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

  Sprawdź przykład pod numerem littlebits/react-popover (README.adoc).

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

• arthurhammer/github-toc - rozszerzenie przeglądarki, które dodaje się spis treści do repo GitHub

Answer 5

Można wybrać tryb edycji „Dyskusja”, która będzie generować TOC Dla nagłówków np

== First == 

== Second ==