Markup: 재구성된 텍스트에 toctree의 렌더링 추가

에 만든 2015년 08월 10일 · 3코멘트 · 출처: github/markup

재구성된 텍스트의 목차를 렌더링할 수 있다면 독자들에게 큰 도움이 될 것이라고 생각합니다. 그러면 개발자는 물론 불안정한 소프트웨어를 시도하거나 다음 릴리스에 대한 문서를 읽는 사용자를 위해 프로젝트 문서(예: 불안정한 분기)를 미리 볼 수 있습니다.

제 개인적인 사용 사례는 Readme.md에 있는 프로젝트의 불안정한 분기 문서에 대한 링크를 추가하는 것입니다. 프로젝트 자체에는 문서화를 위한 스핑크스 프로젝트가 포함되어 있습니다.

추가 파일을 포함하는 방법에는 여러 가지가 있습니다.

.. toctree::
   :maxdepth: 1

   Introduction1 <introduction1.rst>
   Introduction2.rst
   Introduction3
   Introduction4/Index

출처

thomaszbz

👍5

모든 3 댓글

:+1:

westurner 에 2016년 06월 19일

이것은 엄청나게 도움이 될 것입니다

jonathanunderwood 에 2016년 06월 26일

rST 구현에 Sphinx 사용자 지정 지시문을 추가할 가능성은 거의 없습니다.

kivikakk 에 2017년 03월 23일

😕4

이 페이지가 도움이 되었나요?

0 / 5 - 0 등급

지원 gifv

daenney · 3코멘트

Ordered 하위 목록의 로마 숫자 문제

ghost · 7코멘트

"mailto" 링크(선택적 제목이 있을 수 있음, 올바르게 렌더링되지 않음)

kenlunde · 4코멘트

Perl 6 포드 렌더링

zoffixznet · 6코멘트

groff 파일/맨페이지 지원?

woodruffw · 6코멘트