跳转到主要内容

一个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

初始发布

项目详情


下载文件

下载适用于您的平台的文件。如果您不确定要选择哪个,请了解更多关于安装包的信息。

源分发

odt2sphinx-0.3.0.tar.gz (11.7 kB 查看哈希值)

上传时间

构建分发

odt2sphinx-0.3.0-py2.py3-none-any.whl (12.6 kB 查看哈希值)

上传时间 Python 2 Python 3

由以下支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面