从opendocument到sphinx的转换器。

odt2sphinx的Python项目详细描述


这是什么?

odt2sphinx将opendocument文本文件转换为一个或多个.rst文件。

安装

您需要先安装PIL,然后:

pip install odt2sphinx

easy_install odt2sphinx

用法

Usage:
  odt2sphinx [options] filename.odt [targetdir]
  odt2sphinx [options] config.cfg

config.cfg content:
  [path/to/the/file.odt]
  targetdir = path/to/the/targetdir

Options:
  -h, --help            show this help message and exit
  --debug
  --download-source-link

输出文件

文件在目标目录中生成,默认情况下,目标目录具有 与.odt文件同名减去扩展名。

将至少写入一个文件“index.rst”。取决于 文档内容,可以生成附加的rst文件(见下一章)。

提取图像并将其放在内部的“images”目录中 目标目录。

样式映射

转换时,下列规则将应用于特殊样式 一个.odt文件。样式名不区分大小写。

  • “title”(任何语言):成为主文档标题 (带“=”下划线)。
  • “title 1”:创建一个以标题命名的新页面,并成为 页面主标题(带“=”下划线)。对该文件的引用 插入index.rst文件的.. toctree指令中。
  • “标题2”至“标题6”:成为子章节标题。 (分别用下划线“—”、“~”、“^”、“”、“”)
  • “警告”(或“避免”):章节成为内容 一个.. warning指令的
  • “tip”(或“trucs&astuces”):本章成为内容 一个.. tip指令的
  • “注释”或“信息”:章节成为内容 一个.. note指令的

更改

0.3.0(2016-09-28)

  • 切换到枕头
  • 提供通用车轮

0.2.3(2012-09-06)

  • 通过替换任何非字母数字字符修复文件名生成 (第3期)。
  • 修复非样式列表的处理。

0.2.2(2012-07-04)

  • 修复pypi上的sdist存档。

0.2.1(2012-06-24)

  • 添加对编号列表、超链接、带下划线文本(翻译为 斜体)。
  • 修复粗体文本支持。

0.2(2012-05-28)

  • 现在支持Python3
  • 明确地将pil添加为依赖项(问题2)。

0.1.2(2012-05-22)

  • 向样式映射添加“信息”。
  • 处理列表项中的注释、提示和警告样式。这允许使用 在便条、提示或警告中列出。
  • 现在处理外部图像(问题1)。

0.1.1(2011-12-20)

  • 改进了用于第三方代码的rstfile:现在可以 插入代码而不仅仅是附加它。
  • 添加自述文件

0.1.0

初始版本

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

推荐PyPI第三方库


热门话题
java如何在sqlite数据库中保存特定列的历史记录   java如何更改/更新timeseriechart名称(JFreeChart)   java如何将整数转换为可绘制的   汇编什么解释Java的字节码   java查找已编译的类版本号   我应该什么时候在ColdFusion应用程序中使用Java?   java当一个实体的两个字段为(unique=true)时,如何处理JPA异常?   java为什么在所有其他实例都正确的情况下返回错误的布尔值?   java Hibernate每次都准备语句   java停留在平均字长上   对Java和日语字符进行编码   java如何将导致异常的方法的错误消息传递给侦听器中的onTestFailure方法   java代码没有打印结果   java为什么私有内部接口的方法必须是公共的?   休眠发生错误。有关详细信息,请参阅错误日志。JAVAlang.NullPointerException