restructuredtext - 用于编写“并行文本”的 Sphinx

Question

问题：我正在尝试使用reStructuredText编写“并行文本” 。我所说的“平行文本”是指带注释的小说作品，其中文本分为两列。左栏包含正文，右栏包含评论。我将使用sphinx从中生成 HTML 和 Latex 文档。

我有以下要求：

1. 如上所述，我应该能够在两列中排版文本，一列用于正文，一列用于注释。
2. 注释可以是“句子级别”，并不总是“段落级别”。即，我希望能够在一个段落或整个段落中注释不同的句子。
3. 关闭所有注释的模式会很棒，因此输出的 HTML 和 Latex 仅包含正文。在这种情况下，我希望能够使用媒体的整个“房地产”，而不仅仅是一个专栏。
4. 如果可能的话，拥有“注释列表”功能会非常好。

我对 reStructuredText 和 Sphinx 还很陌生，但对 Python 有相当多的经验。我正在寻找一些关于如何做我想做的事情的想法。我一直在阅读有关 reStructuredText 以及编写 Sphinx 扩展的内容，因此为 Sphinx 编写扩展并不是不可能的。

有没有人做过类似的事情？

谢谢！

Answer 1

这些看起来很像脚注？我建议看看http://ignorethecode.net/blog/2010/04/20/footnotes/

如果它们适合您的目的，那么集成它们应该不会太困难。Sphinx 输出带有特殊类的脚注。更换

$("a[rel='footnote']")

在代码中，使用您选择的 jquery css 选择器应该可以满足您的需求。