一个OpenDocument到sphinx的转换器。
项目描述
这是什么?
Odt2sphinx可以将OpenDocument Text文件转换为一个或多个.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文件(见下一章)。
图片将被提取并放在目标dir中的“images”目录下。
样式映射
以下规则将应用于转换.odt文件时特别样式。样式名称不区分大小写。
“标题”(任何语言):成为主文档标题(用“=”下划线)。
“标题 1”:创建一个以标题命名的页面,并成为此页面的主要标题(用“=”下划线)。在index.rst文件的.. toctree指令中插入对此文件的引用。
“标题 2”到“标题 6”:成为子章节标题。(分别用“-”、“~”、“^”、““”、“’”下划线)
“警告”(或“Avertissement”):章节成为.. warning指令的内容
“提示”(或“Trucs & Astuces”):章节成为.. tip指令的内容
“注意”或“信息”:章节成为.. note指令的内容
变更
0.3.0 (2016-09-28)
切换到Pillow
提供通用wheel
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)
现在支持Python 3
明确将PIL添加为依赖项(问题#2)。
0.1.2 (2012-05-22)
将“信息”添加到样式映射中。
处理列表项中的注释、提示和警告样式。这允许在注释、提示或警告中使用列表。
现在处理外部图像(问题#1)。
0.1.1 (2011-12-20)
改进RstFile以在第三方代码中使用:现在可以插入代码,而不仅仅是追加代码。
添加README文件
0.1.0
初始发布
项目详情
下载文件
下载适用于您的平台的文件。如果您不确定要选择哪个,请了解更多关于安装包的信息。