Я использую Sphinx для создания документации для моего проекта.
В этом проекте я описываю список доступных команд в файле yaml, который после загрузки приводит к появлению словаря в форма {command-name : command-description}
, например:
commands = {"copy" : "Copy the highlighted text in the clipboard",
"paste" : "Paste the clipboard text to cursor location",
...}
То, что я хотел бы знать, , если в sphinx есть метод для загрузки файла yaml во время цикла make html
, переведите словарь python в некоторый формат reStructuredText (например, список определения) и включить в мой вывод html.
Я ожидаю, что мой файл .rst
будет выглядеть следующим образом:
Available commands
==================
The commands available in bla-bla-bla...
.. magic-directive-that-execute-python-code::
:maybe python code or name of python file here:
и для преобразования внутри:
Available commands
==================
The commands available in bla-bla-bla...
copy
Copy the highlighted text in the clipboard
paste
Paste the clipboard text to cursor location
перед переходом на HTML.