Я загрузил tar (cmake, на самом деле) tar, и его документ был написан как .rst файлы со структурой вроде blow.After googling, я знаю, что docutils (пакет python) может конвертировать эти файлы в htmls, поэтому он был установлен, но Я не могу найти способ сделать это, пожалуйста, скажите мне, есть ли простая команда, чтобы сделать это? Как?Как использовать docutils для преобразования .rsts в htmls?
// док файлы структура (порождено Ls -l под убунтом)
command
generator
include
index.rst
manual
module
policy
prop_cache
prop_dir
prop_gbl
prop_sf
prop_test
prop_tgt
release
variable
На самом деле, я также установил sphinx и попытался запустить: rst2html.py index.rst index.html, но получил много ошибок, таких как: index.rst: 16: (ERROR/3) Неизвестный тип директивы «toctree». –
Ваши ошибки такого рода, потому что это специфические для Sphinx директивы, которые docutils не будут транслировать (только специфичные для REST). Это облом, с которым я тоже столкнулся. – kcrisman