Questions tagged «restructuredtext»

我知道reStructuredText具有以下指令： .. code:: bash gedit pohl.m 呈现一个代码块。是否有某种方法可以像这样获得内联代码片段的语法突出显示： Do edit the file, type ``gedit pohl.m`` into a terminal. 反引号将其标记为代码，但我想用像块这样的小片段来突出显示它。这可能吗？

130 restructuredtext 

这个问题的答案是社区的努力。编辑现有答案以改善此职位。它当前不接受新的答案或互动。 我是reStructuredText的忠实拥护者，但是支持它的工具分散在整个Internet上。在官方的工具列表是不完整的和/或过时的，并且只能通过提交更新特权。一段时间以来，Wikipedia reStructuredText页面上有一个完整的列表，但是显然“ 这不符合Web内容的知名度准则 ”，因此被删除了。 因此，以一种问题的形式来表达：使用reStructuredText时，可以期望找到哪些工具支持，例如文本编辑器，Wiki软件，reStructuredText的转换工具等？

128 restructuredtext 

我有一个托管在GitHub上的项目。为此，我使用Markdown语法编写了自述文件，以便在GitHub上很好地格式化它。 由于我的项目使用Python，因此我还计划将其上传到PyPi。PyPi上用于README的语法为reStructuredText。 我希望避免处理两个包含大致相同内容的自述文件。因此，我搜索了RST（或相反）转换器的降价促销，但找不到任何商品。 我看到的另一个解决方案是执行markdown / HTML，然后执行HTML / RST转换。我在这里和这里都找到了一些资源，所以我猜应该是可行的。 您有什么想法可以更好地适合我的工作吗？

116 python  github  markdown  restructuredtext  pypi 

如何在reST / Sphinx页面中插入到同一文档集中子标题或锚定另一个页面中的交叉引用？

110 python-sphinx  restructuredtext 

按照目前的情况，这个问题不适合我们的问答形式。我们希望答案会得到事实，参考或专业知识的支持，但是这个问题可能会引起辩论，争论，民意测验或进一步的讨论。如果您认为此问题可以解决并且可以重新提出，请访问帮助中心以获取指导。 8年前关闭。 请确定最流行的轻量标记语言，并比较它们的优缺点。这些语言应该是技术散文（例如文档）的通用标记（例如，Haml不计算在内）。 另请参阅：Markdown与ReStructuredText

90 documentation  markdown  markup  restructuredtext  textile 

我正在尝试使用以下代码（在Sphinx和docutils文档之后）创建正确嵌套的列表： 1. X a. U b. V c. W 2. Y 3. Z 我希望这将导致两个OLs，但是我得到以下输出： <ol class="arabic simple"> <li>X</li> </ol> <blockquote> <div> <ol class="loweralpha simple"> <li>U</li> <li>V</li> <li>W</li> </ol> </div> </blockquote> <ol class="arabic simple" start="2"> <li>Y</li> <li>Z</li> </ol> 我究竟做错了什么？无法获得以下结果？ <ol class="arabic simple"> <li>X <ol class="loweralpha simple"> <li>U</li> <li>V</li> <li>W</li> </ol> </li> …

90 markup  restructuredtext  python-sphinx 

这是我想做的： 1. `link <http://www.google.com>`__ 2. `link <http://www.yahoo.com>`__ 获得： <ol> <li><a href="http://www.google.com">link</a></li> <li><a href="http://www.yahoo.com">link</a></li> </ol> 上下文是出版物的列表，我希望所有出版物的末尾都有一个标记为“ DOI”的链接。 但是，这似乎失败了： <string>:3: (WARNING/2) Duplicate explicit target name: "doi". 确切的错误似乎取决于我使用的docutils的版本，但是它们都失败了。 有没有一种方法可以在重组文本中生成具有相同文本的多个链接？

81 python  restructuredtext 

如何格式化reStructuredText中指定链接内的文本？ 具体来说，我希望从我的第一个脚本中生成以下HTML： <a href="http://docs.python.org/library/optparse.html"><tt>optparse.OptionParser</tt> documentation documentation</a> 结果应如下所示： optparse.OptionParser 文件资料 其中“ optparse.OptionParser”部分为固定宽度的字体。 我试过了 ```optparse.OptionParser`` <http://docs.python.org/library/optparse.html>`_ 但是，这给了 <tt class="docutils literal">`optparse.OptionParser</tt> documentation <<a class="reference external" href="http://docs.python.org/library/optparse.html">http://docs.python.org/library/optparse.html</a>>`_ 看起来像这样 ``optparse.OptionParser documentation <http://docs.python.org/library/optparse.html>\_

81 python-sphinx  restructuredtext 

是否有工具或脚本可以轻松地将一堆JAR文件合并为一个JAR文件？一个好处是可以轻松地设置主文件清单并使之可执行。 具体情况是Java重组文本工具。我想用类似的东西来运行它： java -jar rst.jar 据我所知，它没有依赖性，这表明它不应该是一个简单的单文件工具，但是下载的ZIP文件包含许多库。 0 11-30-07 10:01 jrst-0.8.1/ 922 11-30-07 09:53 jrst-0.8.1/jrst.bat 898 11-30-07 09:53 jrst-0.8.1/jrst.sh 2675 11-30-07 09:42 jrst-0.8.1/readmeEN.txt 108821 11-30-07 09:59 jrst-0.8.1/jrst-0.8.1.jar 2675 11-30-07 09:42 jrst-0.8.1/readme.txt 0 11-30-07 10:01 jrst-0.8.1/lib/ 81508 11-30-07 09:49 jrst-0.8.1/lib/batik-util-1.6-1.jar 2450757 11-30-07 09:49 jrst-0.8.1/lib/icu4j-2.6.1.jar 559366 11-30-07 09:49 jrst-0.8.1/lib/commons-collections-3.1.jar 83613 11-30-07 09:49 jrst-0.8.1/lib/commons-io-1.3.1.jar …

74 java  jar  merge  restructuredtext  uberjar