问题标签 [docutils]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
2 回答
2755 浏览

documentation - docutils/reStructuredText 模板功能

如何.rst使用实际值自定义文件中的占位符?

例如,我有example.rst以下内容的文件:

我想通过运行以下命令将${custom_text}属性替换为值:this is the value of custom property

另外我想知道是否可以使用.properties文件自定义模板?例如,我想使用具有以下内容的文件运行rst2html example.rst -o example.html -p example.properties命令:example.properties

可能吗?reStructuredText 是否完全支持模板功能?

编辑:请注意,我想从命令行自定义模板或使用常规.properties文件(可由 Ant/Maven 构建管理工具使用)。

0 投票
1 回答
607 浏览

python - 使用 docutils 从 reStructuredText 创建最小的 LaTeX 语法

我正在制作一个 Python 脚本,该脚本采用多个具有 reStructuredText 语法的文本文件,并使用 Docutils 创建一个单一的 LaTeX 文件。一切都很好,除了 Docutils 创建了很多我不需要的额外语法。

例如,使用一个简单的小节 Docutils 将编写

当我只需要

我已经看到 Pandoc 没有创建太多额外的语法,但是它不支持 CSV 表,所以我不能在我的项目中使用它。

我查看了所有 docutils 设置,但我真的找不到任何限制输出的选项。无论如何,我是否将 Docutils 设置为仅创建我想要的语法?

0 投票
2 回答
1038 浏览

python - 重组文本中的全局包含

我正在为我的博客/网站使用 reStructuredText,并且我想添加一个全局包含文件。我可以访问并很高兴更改用于生成 html 输出的设置文件,但我无法弄清楚其中任何一个的语法:

  1. 将默认包含文件添加到解析器
  2. 在 python 中使用 docutils 在 python 中定义指令/内联角色等

我尝试阅读源代码和文档,但发现它有点难以理解。我希望我只是错过了一些非常明显的事情,但我想做类似以下的事情(第一部分就是已经存在的——你可以在 jekyll-rst 插件中看到文件的其余部分来源(指向它的链接)

有没有一种简单的方法可以做到这一点?defaults.rst定义一个文件并每次都加载它会很棒。

编辑:这里有一些我希望能够全局包含的示例(自定义指令也很好,但我可能会在代码中编写这些指令)

0 投票
3 回答
1254 浏览

restructuredtext - 使用 ReStructuredText 添加外部 PDF 作为附录

我正在写一份重要报告,并且有两个 PDF 文件我想作为附录包含在内。报告使用 ReStructuredText 编写,将使用 rst2pdf 进行转换。

docutils 或 rst2pdf 是否具有将外部文件作为附录的任何功能?

0 投票
3 回答
1389 浏览

python - 从 reStructuredText 中提取字段列表

假设我有以下 reST 输入:

我想结束的是这样的字典:

我试着用这个:

它确实解析了字段列表,但我最终得到了一些伪 XML tree["whole"]?

由于treedict 不包含任何其他有用的信息,而这只是一个字符串,我不确定如何从 reST 文档中解析出字段列表。我该怎么做?

0 投票
1 回答
2063 浏览

restructuredtext - 水平和垂直对齐图像

使用docutils,似乎无法在 reStructuredText 中水平和垂直对齐图像。垂直对齐仅适用于替换,而水平对齐仅适用于内联图像,因此:

碰撞。

有没有办法同时控制垂直和水平对齐?

0 投票
3 回答
17862 浏览

django - 如何从终端安装 Docutils 以便 Django admindocs 可以工作?

Docutils 是一个很棒的软件包。如果您使用的是 Django,则 admindocs 包需要 docutils。提供了使用 Web 浏览器安装的说明,但如果您是远程用户并通过 SSH 使用终端登录怎么办?这种情况下怎么安装?如果您只是想要一个快速的方法来使用终端完成这项工作怎么办?

0 投票
1 回答
346 浏览

python - Python字典“复制值”

当我看到这个(已编辑)时,我正在查看 docutil 源代码(在 python 中):

我正在谈论的线路是这一行:

“[:]”到底是做什么的?它上面的评论暗示了某种副本,但我的谷歌搜索并不那么成功,我无法确定它是语言功能还是某种技巧/捷径。

0 投票
2 回答
897 浏览

python - 如何更改 pycharm 的命令以将 rst 转换为 html

我安装 docutils 和 pygment 以在 rst 文件上突出显示语法。通过使用命令:

我能得到好的结果。

当我使用 pycharm 编写 rst 文件时,它具有用于转换 rst 的内置脚本:

我阅读了文件“rst2smth.py”,似乎使用系统安装的 docutils 命令 rst2html,但我得到的 html 没有语法高亮代码片段。为了方便描述,我截图如下: https ://www.dropbox.com/s/frmf933t3kjcvum/pycharm_rst2html.png

有什么方法可以让 pycharm 将 rst 转换为 html,就像我在终端中使用的命令一样?

以下是pycharm上的python解释器设置: https ://www.dropbox.com/s/qas4352r4fmi6iq/pycharm_packages.png

0 投票
1 回答
193 浏览

python - 指定在 doctest 套件中运行 testsetup 块的顺序

在一个包含许多 Python doctest 的大型 ReStructured Text 文件中,我有一个我想在每个 doctest 之前运行的 testsetup 块,还有一些我只想在一些 doctest 之前运行的 testsetup 块。我知道如何对组执行此操作,但是有没有办法指定testsetup 块的运行顺序?

这是一个文件 foo.rst:

当它运行时,我看到:

有没有办法强制相反的顺序,所以最广泛适用的设置在特定于组的设置之前运行?