标签: restructuredtext

我是reStructuredText的忠实粉丝,但是支持它的工具分散在整个互联网上.在官方的工具列表是不完整的和/或过时的,并且只能通过提交更新特权.有一段时间,维基百科的reStructuredText页面上有一个全面的列表,但这显然" 不符合Web内容的知名度指南 " 并被删除.

所以把它放在一个问题形式中:在使用reStructuredText时,人们期望找到哪些工具支持,例如文本编辑器,Wiki软件,转换器和reStructuredText转换器等等？

我知道reStructuredText有这个指令:

.. code:: bash

    gedit pohl.m

它呈现代码块.有没有办法让内联片段的语法高亮显示如下:

Do edit the file, type ``gedit pohl.m`` into a terminal.

反引号将其标记为代码,但我想用块之类的pygments突出显示它.这可能吗？

我有一个在GitHub上托管的项目.为此,我使用Markdown语法编写了自述文件,以便在GitHub上很好地格式化.

由于我的项目是Python,我还计划将其上传到PyPi.PyPi上用于README的语法是reStructuredText.

我想避免处理包含大致相同内容的两个README; 所以我搜索了RST(或其他方式)翻译的降价,但找不到任何.

我看到的另一个解决方案是执行markdown/HTML然后执行HTML/RST转换.我在这里和这里找到了一些资源,所以我想它应该是可能的.

你有什么想法可以更好地适应我想做的事情吗？

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

请确定最流行的轻量级标记语言,并比较它们的优缺点.这些语言应该是技术散文的通用标记,例如文档(例如,Haml不计算在内).

另请参阅:Markdown与ReStructuredText

我正在尝试使用以下代码创建一个正确嵌套的列表(遵循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>
  <li>Y</li> 
  <li>Z</li> 
</ol> 

这是我想做的事情:

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版本,但它们都失败了.

有没有办法在重组文本中生成具有相同文本的多个链接？

是否有一个工具或脚本可以轻松地将一堆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
 207723  11-30-07 09:49   jrst-0.8.1/lib/commons-lang-2.1.jar
  52915  11-30-07 09:49   jrst-0.8.1/lib/commons-logging-1.1.jar
 260172  11-30-07 09:49   jrst-0.8.1/lib/commons-primitives-1.0.jar
 313898  11-30-07 09:49   jrst-0.8.1/lib/dom4j-1.6.1.jar
1994150  11-30-07 09:49   jrst-0.8.1/lib/fop-0.93-jdk15.jar
  55147  11-30-07 09:49   jrst-0.8.1/lib/activation-1.0.2.jar
 355030  11-30-07 …

如何在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 &lt;<a class="reference external" href="http://docs.python.org/library/optparse.html">http://docs.python.org/library/optparse.html</a>&gt;`_

看起来像这样

``optparse.OptionParser documentation <http://docs.python.org/library/optparse.html>\_

我正在使用reStructuredText,我想通过<embed>标签添加HTML编码交互式flash类型动画.从我的.rst文档中,如何指定这个任意HTML块的位置？就像是:

  .. html ::

  <embed>
  ... more html here ...
  </embed>

这个功能是否存在？谢谢.