从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第三方库


热门话题
java如何在try块中抛出异常并终止程序   java通过spring boot创建可重用模块   testng上组的java交集。xml   用junit检查Java   netbeans针对Java 5编译web应用程序,但不支持字符串。isEmpty()仍然被允许吗?   使用java显示文件夹中的图像   java如何在输入非数字时修复用户输入错误。下一个双倍?   java Hibernate Hibernate完成saveOrUpdate Vs saveOrUpdateAll   java为什么使用netty循环writeAndFlush发送数据包必须让线程休眠一段时间?   java如何使用onResponse json函数更改安卓片段中的公共字符串值   java DateTimeFormatter严格与宽松的意外行为   java访问neo4jogm的映射上下文   Java使用多个堆栈允许“撤消”方法   java单击图像并对其应用seekbar resize