从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
初始版本