从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, --helpshow this help message and exit
--htmlGenerate HTML output
--pdfGenerate PDF output
--odtGenerate ODT output
--theme THEMEUse 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覆盖率
  • 尚未从模板生成皮肤

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
在MATLAB中生成java格式的矩阵   java混合图片,颜色为白色   java Apache Tomcat 7域问题代理设置   java无法从资产中读取csv文件   java为SpringFramework 5中的所有控制器和方法指定一个模式   java为我的应用程序打开html帮助页面   java中的条件语句。属性文件   数组Java彩票类   javascript允许Rhino使用当前项目中的Java类   java无法将ModelMap添加到会话   Java执行命令行程序   java这个电子邮件程序是如何工作的?   java自定义listview,视图问题   java将变量从JavaFx传递到JavaScript&编写代码来触发按钮   java从csv文件中删除记录   爪哇移动蝙蝠。重新油漆   socketjava断开连接   已解析页面的java HTML