ReText(多功能脚本编辑与开发工具)

　　ReText是一款多功能文本编辑与开发工具，同时它也是Markdown和reStructuredText标记语言的简单但功能强大的编辑器，还可以使用Python模块添加对自定义标记；现在可以使用简单的pip install ReText命令在Windows和macOS上安装它，除了现有的Qt WebKit之外，还添加了实验性Qt WebEngine渲染器，字段列表以及Markdown和reStructuredText代码范围的支持，替换选项已添加到搜索工具栏，现在，WebKit和WebEngine预览器可以检测到本地HTML文件的链接，并在新选项卡中打开相应的源文件；现在，当分别按下Return键和Shift-Return键时，表格模式现在可以插入单元格间的换行符和新行，当chardet存在模块时，程序可以自动检测文件编码，新版本添加了用于自动打开最后一个文件的配置选项；提供一种配置选项，用于在仅添加一个选项卡时隐藏选项卡栏；支持表格编辑模式，即使用户可以以许多不同的格式生成漂亮的输出，但也具有漂亮的输入仍然很有用，这不仅在编辑过程中有帮助，而且在您不得不查看输入文本时也有帮助，例如在版本控制系统中合并输入文件的两个版本时；需要的用户可以下载体验

软件功能

　　ReText支持Python-Markdown扩展。

　　默认情况下启用额外的扩展集。数学扩展已启用，可与WebKit渲染器一起使用。

　　可以通过添加remove_extra到扩展列表来禁用Extra和Math 。

　　启用特定文档的扩展名

　　启用其他扩展名的最简单方法是在文档的第一行中列出其名称

　　对于内置扩展名，可以使用它们的简称：foo代替markdown.extensions.foo

　　全局启用扩展

　　支持将某些扩展名应用于目录中的所有文档，只需在该目录的markdown-extensions.txt文件中列出它们。

　　支持键

　　目前支持的键Name，Name[locale]，Icon，Exec，MimeType，FileFilter和DefaultExtension。

软件特色

　　导出扩展是ReText 3.0中引入的，它允许您将自己的导出功能添加到ReText。

　　这些扩展无需保存原始文件即可工作

　　ReText将以原始标记或HTML格式写入一个临时文件，具体取决于您在命令中指定的参数。

　　导出扩展名是位于中的桌面文件RETEXT_PREFIX/share/retext/export-extensions

　　当前支持的前缀为/usr和~/.local。

　　导出扩展名文件应具有.desktop扩展名。

　　可以编写与Desktop Entry Specification兼容的扩展名。

　　导出扩展名将Markdown，reStructuredText或HTML文件作为输入文件。

　　带有某些参数的正在执行的命令的绝对路径

使用说明

　　安装ReText

　　通常，安装ReText所需要做的就是：

　　安装Python 3。

　　pip为python3 安装：

　　$ sudo apt install python3-pip

　　运行以下命令：

　　$ python3 -m pip install ReText --user

　　（--user如果要在系统范围内安装ReText，则该参数对于本地安装是必需的，请将其删除并以超级用户身份运行命令）。

　　对于Linux发行版的用户

　　如果您的系统资源库中有ReText，请从那里安装它。

　　例如，在Debian或Ubuntu上，运行：

　　# apt install retext

　　请注意，发行版提供的版本不一定是此处提供的最新版本。

　　对于Windows和macOS的用户

　　注意：绝对不支持这些系统。在那里使用ReText后果自负。

　　在Windows上，pip还将安装retext.bat文件以使运行ReText更容易。

　　Windows 还提供了一个非官方的便携式应用程序。

　　如果要将某些扩展名应用于所有文档，请在$HOME/.config/markdown-extensions.txt文件中列出它们。您还可以使用“偏好设置”对话框中的“ Markdown扩展名”字段来编辑该文件。

　　在中markdown-extensions.txt，扩展名应单独指定一行，例如：

　　第三方扩展

　　对于第三方扩展，例如，指定可以从Python导入的全名mypackage.mymodule。

　　Python-Markdown Wiki中列出了所有已知的第三方扩展。

　　如果您想获得类似于GitHub Flavored Markdown的体验

　　启用WebKit模式

　　ReText中的数学仅在使用WebKit渲染器时才有效。要启用它，请使用“编辑→使用WebKit渲染器”菜单。

　　数学语法

　　MathJax支持大多数标准LaTeX语法以及某些AMS扩展。

　　这和这个维基文章提供了LaTeX的数学语法的很好的概述。

　　您可以使用TeX和LaTeX样式的边界

　　要启用$...$定界符，请添加mathjax到扩展列表中。有关如何启用扩展的详细信息，请参见Markdown扩展页面。

　　您还可以使用\begin...\end表达式：

　　TeX和LaTeX支持MathJax中对TeX和LaTeX的支持涉及两个功能：第一个在您的网页中查找数学（由，如数学定界符所示$$...$$），并标记该数学以供MathJax稍后处理；第二个是将TeX表示法转换为MathJax内部的内容格式，然后MathJax的输出处理器之一将其显示在网页中。在MathJax版本2中，这些功能被分为不同的组件（tex2jax 预处理器和TeX输入jax），但是在版本3中，tex2jax 功能已折叠到TeX输入jax中。

　　可以将TeX输入jax配置为查找要用于数学定界符的任何标记。

　　TeX输入处理器可将您的数学符号转换为MathJax的内部格式（本质上是MathML），因此可作为TeX到MathML的转换器。还可以通过使用定义其他功能的扩展程序来定制TeX输入处理器

　　自动方程式编号MathJax中的TeX输入处理可以配置为将方程式编号自动添加到显示的方程式中。默认情况下，此功能是关闭的，但是通过添加以下内容，可以轻松配置MathJax以生成自动方程式编号：

　　告诉TeX输入处理器使用AMS编号规则（其中只有某些环境会生成编号方程，就像在LaTeX中一样）。也可以将标签设置为'all'，以便无论使用什么环境，每个显示的方程式都将得到一个数字。

　　您可以使用\notag或\nonumber防止对单个方程式进行编号，\tag{}也可以使用您自己的符号替代常用的方程式编号（或在自动编号关闭的情况下添加方程式标签）。

　　请注意，AMS环境有两种形式：加星标和未加星标。未加星标版本会生成方程式编号（当tags设置为时），而带星标版本 'ams'不会生成。例如

　　将被编号，而

　　将不被编号（当tags是'ams'）。

　　您可以\label为方程式提供一个标识符，以供以后使用它，然后在文档中使用\ref或\eqref在文档中的该位置插入实际方程式编号作为参考。例如，

　　包括标记的方程式和对该方程式的引用。注意，引用可以在相应公式之前或之后。

　　您可以通过包括tagFormat扩展名和在 配置tagFormat块内设置选项来配置数字的显示方式以及如何引用数字tex。

　　如果使用自动方程式编号并动态修改页面，则由于标签重复，可能会遇到问题。

　　因此，与其像这样编写表格：

　　最好使它看起来像这样：

　　不幸的是，要保持表格的格式正确是有代价的。例如，如果以后要用“个人计算机”替换“计算机”一词，则表格将不再具有良好的格式，并且必须将所有其他行上的单元格都变宽才能对其进行修复。

　　表格模式为您完成此操作。如果您将其打开并由于输入更多文本而使单元格变宽，则所有其他行都将匹配。类似地，删除文本时，单元格会变小，但不能小于其他行中的文本。

　　当然，只有在编辑器中使用等宽字体时，此功能才有帮助。可以从“编辑”菜单更改编辑器字体。

　　Enter在表格编辑模式下按将创建一个新行，按Shift+ Enter还将插入分隔线（在reStructuredText中有用，用于在Markdown中将标题与正文分离）。

　　您可以从“编辑”菜单启用表格编辑模式。

更新信息

　　总体改进：

　　现在默认情况下会在新选项卡中打开新文件，而不是在新窗口中打开（由Daniele Scasciafratte在＃476中贡献）。可以使用openFilesInExistingWindow配置选项禁用它。

　　首选项对话框的改进：现在使用选项卡；添加了指向配置文件的链接（由Xavier Gouchet在＃327中贡献）；单击复选框标签现在会更改复选框状态。

　　现在，回车键会自动继续引用块和有序列表（由Xavier Gouchet在＃298和＃326中贡献）。

　　现在可以使用Ctrl + W关闭当前选项卡（由＃283中的Xavier Gouchet提供）。

　　编辑器上的Ctrl + wheel现在可以增加/减小字体大小（由＃328的Xavier Gouchet提供）。Ctrl +滚轮预览可放大/缩小（＃400）。

　　Alt +向上/向下箭头现在将当前行向上/向下移动（由＃337的Xavier Gouchet提供）。

　　添加了“跳转到行”功能，并带有Ctrl + G快捷键（由＃382中的Xavier Gouchet提供）。

　　改进了表格模式（由Maurice van der Pot提供）。

　　使用“ Ctrl + Shift + V”快捷键将“粘贴图像”移至单独的动作。

　　添加了“插入表格”对话框（由Changhee Kim在＃431中贡献）。

　　现在，单击指向不存在文件的链接会提示用户创建它（由＃436中的red-kite和＃459中的Xavier Gouchet贡献）。

　　添加了一个菜单操作来插入文件系统中的图像（由Daniel Venturini在＃500中贡献）。

　　添加了新选项：

　　relativeLineNumbers —计算相对于当前行的行号（由Xavier Gouchet在＃270中贡献）。

　　documentStatsEnabled —在编辑器的左下角显示文本统计信息（由Xavier Gouchet在＃268和＃338中贡献）。

　　rightMarginWrap —在用户指定的边距行处自动换行（由OğuzhanÖğreden在＃313中贡献）。

　　paperSize —设置用于打印或PDF导出的默认纸张尺寸（由＃335中的mray271提供）。

　　recentDocumentsCount —菜单中要显示的最近文件数（由＃407中的红色风筝贡献）。

　　windowTitleFullPath —在窗口标题中显示完整路径（由＃429中的red-kite贡献）。

　　defaultPreviewState-模式新选项卡：editor，normal-preview或 live-preview（在＃435贡献的红风筝）。它替代了旧livePreviewByDefault选项。

　　wideCursor —使光标与字符一样宽。

　　错误修复：

　　问题＃252 —将图片的最大宽度限制为100％。

　　问题＃267 — setup.py现在将安装retext.svg图标。

　　问题＃281，＃469-自动填充PDF导出和“另存为”对话框的当前文件名（“另存为”部分由＃474中的Xavier Gouchet提供）。

　　问题＃291 —确保搜索结果与统计/信息区域不重叠。

　　问题＃301-使Markdown包含扩展程序正常工作。

　　PR＃315 —修复了在表格模式下处理reStructuredText表中的多行行（由R1dO提供）。

　　问题＃346 — Ctrl + F现在将焦点放在搜索字段上，而不是关闭搜索栏。要关闭搜索栏，现在可以使用退出键。

　　问题＃378-确保调整大小后光标可见。

　　问题＃397 —仅检查初始页面加载时是否存在.css文件。

　　问题＃399 —在创建QApplication之前尝试加载libGL.so.1。

　　问题＃408-修复带有深色主题的打印。

　　问题＃409-使WebKit渲染器使用磁盘缓存。

　　PR＃411，＃417，＃426，＃494-AppData文件改进（由scx贡献）。

　　问题＃441 —重新加载文件不再触发选项卡更改。

　　问题＃445 —为WebEngine渲染器实现了PDF导出。

　　问题＃451-使同步滚动实现不破坏pymdownx.highlight扩展名。

　　问题＃452，＃497，＃499-防止pip产生轮子，因为这会导致桌面文件损坏。

　　问题＃467，＃488 — WebEngine渲染器被新的Qt版本破坏了。

　　问题＃468-在导出的HTML中包含样式表。

　　问题＃479 — *修改和未保存文档时，在标签标题中显示（由＃480中的Xavier Gouchet提供）。

　　问题＃487 —在Ubuntu 19.10 Yaru主题中添加了一种丢失图标的解决方法。

　　PR＃496 —启用HiDPI图标（由Guo Yunhe提供）。