Можно ли изменить таблицу содержимого, используя Markdown в ReadTheDocs?

Question

Понимаю, что таблица может быть отредактирована (т. Е. Элементы сортировки, используя дочерние узлы и т. Д.) С TOC directives при использовании Sphinx.

Можно ли достичь этого при использовании Markdown?

Answer 1

Да, это требует некоторой модификации, однако оно должно выполнить свою работу.

Для получения информации см. https://github.com/rtfd/recommonmark.

Для дальнейшей разработки вам необходимо иметь пип установить recommonmark через pip install recommonmark

Затем, внутри вашего файла conf.py вы хотите добавить в следующем:

from recommonmark.parser import CommonMarkParser 

source_parsers = { 
    '.md': CommonMarkParser, 
} 

source_suffix = ['.rst', '.md'] 

Источник & увидеть его в действии по адресу: http://recommonmark.readthedocs.org/en/latest/