从rst(structuredtext)轻松生成pdf、html和odt文档
2lazy2rest的Python项目详细描述
使用restructedtext生成中短文档的简单方法
- 多格式主题
- 以HTML、ODT、PDF格式呈现相同的文档,保留主视觉标识
- 统一接口
- 厌倦了在具有不同参数或行为的rst2*工具之间切换?
- 是否希望不丢失代码块或一些转换输出格式的呈现选项?
此工具试图解决此问题
- 创建自己的主题
- 待办事项:模板将很容易定制(例如,可能仅限颜色)
如何使用
依赖性
您需要rst2pdf来使用所有功能,其他rst2*工具来自docutils。
使用
mkrst [-h] [--html] [--pdf] [--odt] [--theme THEME]
[--themes-dir THEMES_DIR]
FILE
- 可选参数:
-h, --help show this help message and exit --html Generate HTML output --pdf Generate PDF output --odt Generate ODT output --theme THEME Use a different theme --themes-dir THEMES_DIR Change the folder searched for theme
popo:~/2lazy2rest% ./mkrst test_page.rst --html --pdf Using ./themes/default html: test_page.html pdf: test_page.pdf
定制
复制themes/default,根据需要编辑副本,并使用–theme选项和副本的名称,仅此而已!
示例
popo:~/2lazy2rest% cp -r themes/default themes/red popo:~/2lazy2rest% sed -si 's/#FEFEFE/red/g' themes/red/html/stylesheet.css popo:~/2lazy2rest% ./mkrst test_page.rst --html --theme red
问题
- ODT样式未完成
- pdf&html仍然需要更多的rest覆盖率
- 尚未从模板生成皮肤