问题标签 [restructuredtext]

我正在使用 python docutils 和 rst2html.py 脚本将重组文本转换为 html。

我想像这样转换一行：

变成这样：

但是我得到了这个（路径中的空格被删除）：

如何保留链接中的空格？

如果我有一些文档，例如Galleria 的文档，我该如何设置它以便在我运行make html命令时它会在每个页面上添加一个自定义页脚？

我看到如果我将其输出为 pdf 格式，我可能会使用conf.py的乳胶前导部分。

谢谢！

对 HTML/Text 到 ReST 转换器有什么建议吗？

已经搜索了各种选项，但没有找到任何可靠的解决方案。（注意：已经找到 Pandoc，但不想安装 Haskell）。

如果我定义了一个内部超链接目标，我如何使用任意文本作为链接标题链接到它？

例如：

我怎样才能使“短参考”目标成为“非常长的内部目标”？

编辑：另一个例子：

如何将“小部件”（单数）链接到“小部件”（复数）标题？

（当然，我意识到这可以使用`widget`_\s......但这并不能解决一般问题）

Github 将解析一个 reStructuredText 文件，如果其扩展名为.rst. docutilsbuildhtml.py只会解析带有扩展名的文件.txt，我看不到更改它的选项。这非常烦人。有什么方法可以让 Github 将文件识别.txt为 RST 或 buildhtml 来识别.rst文件？

是否可以创建没有前导和尾随空格的超链接？以下不起作用：

我问的原因是我正在使用中文文本。中文中不使用空格作为单词分隔符。添加空格后，文本看起来格式不正确，例如：

没有空格就对了。</p>

相对

更多空格不成型。</p>

有任何想法吗？

第一个问题流

大家好，

这可能是对这个问题的跟进：Antlr rule priority

我正在尝试为reStructuredText 标记语言编写 ANTLR 语法。

我面临的主要问题是：“如何匹配任何字符序列（常规文本）而不掩盖其他语法规则？”

让我们以一个带有内联标记的段落为例：

我认为为内联标记文本编写规则会很容易。所以我写了一个简单的语法：

这个简单的语法是行不通的。而且我什至没有尝试匹配常规文本...

我的问题：

• 有人可以指出我的错误，并可能给我一个关于如何匹配常规文本的提示吗？
• 有没有办法设置语法规则的优先级？也许这可能是一个线索。

在此先感谢您的帮助 ：-）

罗宾

第二个问题流

非常感谢您的帮助！我很难弄清楚我的错误...我不是（仅）编写该语法来学习 ANTLR，我正在尝试为 Eclipse 编写一个 IDE 插件。为此，我需要一个语法；）

我设法在语法上走得更远，并写了一条text规则：

语法对于 inline_markup 工作正常，但 normal_text 不匹配。

这是我的测试课：

我使用的输入文件：

我得到这个输出：

你能指出我的错误吗？（当我将 filter=true; 选项添加到语法时，解析器适用于内联标记而不会出错）

罗宾

我正在编写将使用 Sphinx 呈现为 HTML 和 PDF 的 reST 文档。我的源文件是 UTF-8，并且希望我的 HTML 显示为 UTF-8。

写乘号的最佳做法是什么？

即：×，不是x。

我知道我可以将它作为 Unicode 字符插入。如果我正在编写 LaTeX，我会使用\times. 在 HTML 中有×. 当我使用 Sphinx 渲染所有内容时，简单的 Unicode 是否能够在转换过程中正常运行？即使我渲染成其他更奇特的格式？

我只是想仔细检查一下这不会在某处绊倒。

我已经写了一些 LaTeX，但现在我感觉很懒，我想用 Markdown、reStructuredText 或 Textile 编写我的下一个更大的项目，以便于阅读。不幸的是，我想拥有一些 TeX 可定制性并编写一些自己的语法结构来满足我的语义需求。

对于这种标记语言，我想要的一件事是现有的插件/过滤器可以生成 LaTeX 和 (X)HTML 输出。

因为我的需求可能无法开箱即用，所以我的问题是，由于许多较新的解析器都是用 Python 编写的，是否有任何特别干净的 Python 实现可以轻松插入新语法？

是否可以在重组文本中删除文本？

<strike>例如，在转换为 HTML 时 呈现为标签的内容，例如： ReSTructuredText