Dzięki Sphinx-doc można utworzyć kilka plików ReStructureText z plikiem index.rst
, który zawiera makro spisu treści, które automatycznie generuje spis treści z innych dołączonych plików, oraz conf.py
, który działa jako konfiguracja kompilacji. Następnie możesz skompilować partię w jedną stronę w stylu Pythona, wraz z indeksem, narzędziami nawigacyjnymi i funkcją wyszukiwania.Cała kompilacja strony markdown/pandoc?
Czy istnieje porównywalne narzędzie do przeceny (najlepiej obniżka w stylu pandoc)?
Czy istnieje również narzędzie do dokumentacji (obniżania), które może produkować pliki PDF i ePub tak łatwe, jak robi to Sphinx? –
@white_gecko Edytuj w [Markdown] (http://daringfireball.net/projects/markdown/syntax#overview), przekonwertuj na XHTML za pomocą [pandoc] (http://johnmacfarlane.net/pandoc/README.html) i na końcu przekonwertuj na PDF za pomocą [PrinceXML] (http://www.princexml.com/), którego możesz używać lub nie za darmo (patrz [Licencja CSO] (http://www.princexml.com/license/)) . Ponownie sprawdź [moja strona] (http://hamwaves.com/cl-ocfd/en/index.html), aby uzyskać szczegółowe informacje. Istnieje alternatywa typu open-source o nazwie [wkhtmltopdf] (http://wkhtmltopdf.org/), która jednak nie jest dobra w łamaniu strony. –