我是reStructuredText的忠实拥护者,但是支持它的工具分散在整个Internet上。在官方的工具列表是不完整的和/或过时的,并且只能通过提交更新特权。一段时间以来,Wikipedia reStructuredText页面上有一个完整的列表,但是显然“ 这不符合Web内容的知名度准则 ”,因此被删除了。
因此,以一种问题的形式来表达:使用reStructuredText时,可以期望找到哪些工具支持,例如文本编辑器,Wiki软件,reStructuredText的转换工具等?
我是reStructuredText的忠实拥护者,但是支持它的工具分散在整个Internet上。在官方的工具列表是不完整的和/或过时的,并且只能通过提交更新特权。一段时间以来,Wikipedia reStructuredText页面上有一个完整的列表,但是显然“ 这不符合Web内容的知名度准则 ”,因此被删除了。
因此,以一种问题的形式来表达:使用reStructuredText时,可以期望找到哪些工具支持,例如文本编辑器,Wiki软件,reStructuredText的转换工具等?
Answers:
从旧版本的Wikipedia页面中挽救(并扩展)列表:
尽管reStructuredText的参考实现是用Python编写的,但也存在其他语言的reStructuredText解析器。
reStructuredText的主要发行版是Python Docutils软件包。它包含几个转换工具:
Pandoc是用于从一种标记格式转换为另一种标记格式的Haskell库,也是使用该库的命令行工具。它可以读取Markdown和reStructuredText,HTML和LaTeX(的子集),并且可以编写Markdown,reStructuredText,HTML,LaTeX,ConTeXt,PDF,RTF,DocBook XML,OpenDocument XML,ODT,GNU Texinfo,MediaWiki标记,groff man页和S5 HTML幻灯片放映。
有一个Pandoc在线工具(POT)可以尝试此库。不幸的是,与reStructuredText在线渲染器(ROR)相比,
docutils
)JRst是Java reStructuredText解析器。它当前可以输出HTML,XHTML,DocBook xdoc和PDF,但似乎存在严重问题:使用当前的完整下载无法生成PDF或(X)HTML,结果(X)HTML中的结果页为空,并且IO上的PDF生成失败XSL文件问题(未捆绑?)。请注意,原始的JRst已从网站上删除;在GitHub上找到一个fork 。
Laika是一个新的库,用于将标记语言转换为其他输出格式。当前,它支持Markdown和reStructuredText的输入并产生HTML输出。该库是用Scala编写的,但也可以从Java使用。
该稔编译器功能的命令 rst2html
和rst2tex
这将reStructuredText文件,HTML和TeX的文件。标准库提供以下模块(供编译器使用)以编程方式处理reStructuredText文件:
这些工具中的大多数(但不是全部)都基于Docutils(请参见上文),并提供与主发行版可能不支持的格式之间的转换。
pip
安装的python包requiredocutils
,它会进行实际渲染。restview
的主要易用性功能是,当您将更改保存到文档时,它会自动重新呈现并重新显示它们。restview
docutils
以将您的文档呈现为HTML一些项目使用reStructuredText作为基础来建立基线,或提供其他功能来扩展reStructuredText工具的实用程序。
所述斯芬克斯文档生成平移一组reStructuredText的源文件到各种输出格式,自动制作交叉引用,索引等
rest2web是一个简单的工具,可让您从单个模板(或任意多个模板)构建网站,并将内容保留在reStructuredText中。
Pygments是一种通用语法突出显示工具,可广泛用于各种软件中,例如论坛系统,Wiki或需要美化源代码的其他应用程序。请参阅在reStructuredText文档中使用Pygments。
尽管任何纯文本编辑器都适合编写reStructuredText文档,但某些编辑器比其他编辑器具有更好的支持。
通过rst-mode 的Emacs支持作为Docutils软件包的一部分提供,位于/docutils/tools/editors/emacs/rst.el
vim-common
大多数GNU / Linux发行版附带的软件包都具有开箱即用的reStructuredText语法突出显示和对reStructuredText的缩进支持:
gedit,GNOME桌面环境的官方文本编辑器。有一个gedit reStructuredText插件。
Geany是一个小型轻量级的集成开发环境,包括对版本0.12(2007年10月10日)中的reStructuredText的支持。
Leo是程序员的概述编辑器,它通过rst-plugin或通过“ @ auto-rst”节点来支持reStructuredText (没有充分说明,但是@ auto-rst节点允许直接编辑rst文件,将结构解析为Leo轮廓) 。
它还提供了一种在“ viewrendered”窗格中预览结果HTML的方法。
该FTE折叠文本编辑器-一个免费的(在GNU GPL许可)为开发文本编辑器。FTE 有一种支持reStructuredText 的模式。它提供基本RSTX元素的颜色突出显示和特殊菜单,这些菜单提供了将大多数常用RSTX元素插入文档的简便方法。
PyK是PyEdit和reStInPeace的后继者,是在Qt4工具箱的帮助下用Python编写的。
带有ReST编辑器插件的Eclipse IDE 提供了对reStructuredText文件进行编辑的支持。
NoTex是基于浏览器(通用)的文本编辑器,具有集成的项目管理和语法突出显示功能。另外,它还可以使用rST编写书籍,报告,文章等,并将它们转换为LaTex,PDF或HTML。PDF文件具有很高的出版质量,是通过Sphinx和Texlive LaTex套件生成的。
Notepad ++是Windows的通用文本编辑器。它具有针对多种内置语言的语法突出显示功能,并通过用户定义的reStructuredText语言支持reStructuredText。
Visual Studio Code是Windows / macOS / Linux的通用文本编辑器。它有语法高亮通过内置并支持reStructuredText的许多语言的延伸从LeXtudio。
Sublime Text是一个完全可定制且可扩展的源代码编辑器,可用于Windows,OS X和Linux。长期使用需要注册,但是未注册版本提供所有功能,并偶尔会提醒您购买许可证。版本2和版本3(当前处于beta版)默认情况下支持reStructuredText语法高亮显示,并且可通过程序包管理器Package Control使用多个插件来提供摘要和代码完成,其他语法高亮显示,与RST和其他格式的相互转换以及HTML预览。在浏览器中。
适用于Mac的BBEdit(及其免费变体TextWrangler)可以使用此无代码语言模块在语法上突出显示reStructuredText 。
TextMate是Mac OS X的专有通用GUI文本编辑器,具有reStructuredText的捆绑包。
Intype是Windows的专有文本编辑器,开箱即用地支持reStructuredText。
E是根据“开放公司许可”授权的专有文本编辑器。它支持TextMate的包,因此应该像TextMate一样支持reStructuredText。
PyCharm(和其他IntelliJ平台IDE?)具有ReST / Sphinx支持(语法突出显示,自动完成和预览)。)
以下是一些支持reStructuredText标记作为本地标记语法或附加组件的Wiki程序:
MediaWiki reStructuredText扩展允许在MediaWiki中用<rst>
和包围的reStructuredText标记</rst>
。
MoinMoin是一个高级,易于使用且可扩展的WikiEngine,拥有大量的用户社区。简而言之,这是关于易于编辑的网页上的协作。
MoinMoin有一个reStructuredText解析器。
Trac是用于软件开发项目的增强的Wiki和问题跟踪系统。Trac中有一个reStructuredText支持。
该Wiki是Ian Bicking编写的Python Wiki网络软件。该Wiki使用ReStructuredText作为标记。
rstiki是一个极简主义的单文件个人Wiki,使用了受pwyky启发的reStructuredText语法(通过docutils)。它不支持作者身份指示,版本控制,层次结构,chrome /框架/模板或样式。它利用docutils / reStructuredText作为Wiki语法。因此,它在200行代码下,并且在一个文件中。您将其放在目录中并运行。
Ikiwiki是Wiki编译器。它将Wiki页面转换为适合在网站上发布的HTML页面。Ikiwiki将页面和历史记录存储在版本控制系统(例如Subversion或Git)中。还有许多其他功能,包括对博客的支持以及大量插件。它是reStructuredText插件,但是在某种程度上受到限制,目前不建议将其作为其主要标记语言。
一个在线reStructuredText的编辑器可用于与标记发挥,并立即看到结果。
WordPress的WordPreSt reStructuredText插件。(PHP)
reStructuredText的解析器插件的锌(锌时,被安排来获得本地新结构化的支持将成为0.2版本已过时)。Zine已停产。(蟒蛇)
Pelican是静态博客生成器,支持使用ReST撰写文章。(蟒蛇)
Hyde是支持ReST的静态网站生成器。(蟒蛇)
Acrylamid是一个静态博客生成器,支持用ReST撰写文章。(蟒蛇)
Nikola是支持ReST的静态站点和博客生成器。(蟒蛇)
Ipsum属是用Nim编写的静态博客生成器。
Yozuch是用Python编写的静态博客生成器。