用Python编程以程序化方式编写reStructuredText

Question

有没有Python3.X库可以帮助编写rST文件/文本呢？ 我不想使用file.write()手动编写rST文件样式，我正在寻找一种可以更容易地创建具有不同元素（如粗体、下划线、表格）的rST文件的库。

注意：我不想读取rST文件，而是想以编程方式创建rST文件。

- Kumar Roshan Mehta

---

了解一下 Pandoc、docutils 和 Sphinx。 - Thaer A

我确实查看了Sphinx，但我发现它似乎只能解析rST文件。 - Kumar Roshan Mehta

你要找的这个库应该从哪里获取其内容？通常情况下，人类编写RST，然后计算机将其转换为最终产品（HTML、PDF等）。 - noslenkwah

我希望有一个库可以让我更轻松地创建和编写rST文件。例如，对于子标题文本，使用file.write(subsubtitle)和file.write(*********)的方式写入太繁琐了。 - Kumar Roshan Mehta

我曾经考虑过类似的解决方案来解决其他问题。有一段时间，我考虑过修改rst2rst。但是后来我找到了更标准的解决方案，所以这对我来说不再必要。rst2rst: https://pypi.org/project/rst2rst/ - natersoz

看起来是 Is there a reST Writer? 的重复。 - undefined

Answer 1

使用RstCloth可以通过简单的Python API创建RST文件。

from rstcloth import RstCloth

d = RstCloth()
d.title('Example Use')
d.newline()
d.h2('Contents')
d.directive(name="contents", fields=[('local', ''), ('backlinks', 'None')])
d.newline()
d.h2('Code -- shebang')
d.codeblock('#!/usr/bin/env')

d.print_content()

结果：

===========
Example Use
===========

Contents
--------

.. contents::
   :local:
   :backlinks: None

Code -- shebang
---------------

::

   #!/usr/bin/env

- danwos