问题标签 [restructuredtext]

是否有工具或脚本可以轻松地将一堆JAR文件合并到一个 JAR 文件中？一个好处是可以轻松设置主文件清单并使其可执行。

具体案例是一个Java 重组文本工具。我想用类似的东西运行它：

java -jar rst.jar

据我所知，它没有依赖关系，这表明它不应该是一个简单的单文件工具，但下载的 ZIP 文件包含很多库。

如您所见，不需要手动执行此操作在某种程度上是可取的。

到目前为止，我只尝试过 AutoJar 和 ProGuard，它们都相当容易上手。JAR 文件中的常量池似乎存在一些问题。

显然 jrst 有点坏了，所以我会去修复它。Maven 文件显然也被pom.xml破坏了，所以我必须在修复 jrst 之前修复它......我觉得自己像一个错误磁铁 :-)

更新：我从来没有解决这个应用程序，但我检查了基于胖 JAR 的Eclipse的“可运行 JAR 导出向导”。我发现这很容易用于部署我自己的代码。

其他一些优秀的建议可能更适合在非 Eclipse 环境中构建，oss 可能应该使用Ant进行良好的构建。（Maven，到目前为止刚刚给我带来了痛苦，但其他人喜欢它。）

请找出最流行的轻量级标记语言并比较它们的优缺点。这些语言应该是技术散文的通用标记，例如文档（例如，Haml 不算在内）。

另请参阅：Markdown 与 ReStructuredText

Asciidoc支持标注。如何使用reStructuredText编写类似的标注？

从 Python 2.6 开始，文档似乎采用了新的reStructuredText格式，而且开箱即用地构建Texinfo 信息文件似乎并不容易。

我是一个 Emacs 迷，我更喜欢安装在 Info 中的文档。

有人有 Texinfo 格式的 Python 2.6 或更高版本的文档吗？你是如何转换它们的？或者，那里有维护的构建吗？

我知道我可以使用 w3m 或haddoc来查看 html 文档——我真的希望它们出现在 Info.xml 中。

我玩过Pandoc，但经过一些小实验后，它似乎不能很好地处理文档之间的链接，而我更大的实验——在所有文档中运行它，看看会发生什么——仍然持续两天自从我开始它！

两个好答案

在下面突出显示两个答案，因为 SO 不允许我同时接受这两个答案：

• @wilfred-hughes：从 MELPA 安装是将预构建信息导入 Emacs 的最快方法
• @alioth：自己构建它看起来比我在 2009 年问这个问题时容易得多

我计划使用 reStructuredText 来编写文档，主要目的是生成一些漂亮的 HTML 页面。为此，我使用 docutils rst2html.py 工具。

但是，我可能还需要以漂亮的纯文本格式呈现文档，即没有 reStructuredText 标记，并且仍然在文本输出上执行段落换行和类似的漂亮格式。但是，docutils 中没有 rst2txt.py 工具。

有没有办法将 reStructuredText 转换为漂亮的纯文本格式，也许可以使用 docutils 的特殊选项？

我正在使用 Sphinx 记录将部署在不同服务器中的 Web 服务。该文档充满了供用户单击的 URL 示例，它们应该可以正常工作。我的问题是主机、端口和部署根目录会有所不同，并且必须为每次部署重新生成文档。

我尝试定义这样的替换：

但是生成的 HTML 不是我想要的（在生成的链接中不包含“/path”）：

有人知道如何解决这个问题吗？

我想用 restructuredtext 写一篇研究论文，这种文档可以有两栏固有的风格吗？我查看了规格，但除了使用一张桌子，这将是一个真正的痛苦，我无法找到替代品。

我想使用 VIM 在多个操作系统中编辑 reStuctured 文本文档。

我发现这篇文章http://www.zopyx.com/blog/editing-restructuredtext-with-vim

你能帮我想出在 MS-Windows 操作系统上运行时达到相同效果的线路吗？

是否也可以使用环境变量来指定临时文件的位置？

我正在考虑使用 Sphinx / reStructuredText 作为文档，它看起来很有希望，除了表格看起来很痛苦。有没有可以帮忙的编辑器？

我正在使用reStructuredText & rst2s5创建S5幻灯片演示。很棒，但我也想以 PDF 格式进行演示。如何将 S5 转换为 PDF？

S5 是基于 HTML... S5 的功能之一是创建演示文稿的打印输出。因此，当我尝试从浏览器中使用 PDF 打印机时，我只会得到打印输出。我想要一个带有幻灯片的 PDF，每页 1 张幻灯片以及原始演示文稿中的所有格式、颜色和字体大小。