Merge pull request #149 from annegentle/patch-1

Clarify the specifics of Auto Toc Tree
This commit is contained in:
Eric Holscher 2019-06-14 07:09:05 -07:00 committed by GitHub
commit 98200fc475
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -38,13 +38,13 @@ One of important command in tools like sphinx is `toctree`. This is a command to
tell sphinx about the structure of the documents. In markdown, usually we manually list of contents by a bullet list tell sphinx about the structure of the documents. In markdown, usually we manually list of contents by a bullet list
of url reference to the other documents. of url reference to the other documents.
AutoStructify will transforms bullet list of document URLs AutoStructify transforms bullet list of document URLs like this
``` ```
* [Title1](doc1.md) * [Title1](doc1.md)
* [Title2](doc2.md) * [Title2](doc2.md)
``` ```
will be translated to the AST of following reStructuredText code to the AST of this following reStructuredText code
```rst ```rst
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1