Retext 介绍安装配置

Question

Retext 几番安装后又删除，总是因为那难以接受的 Markdown 预览效果，后来才发现，原来 Retext 也是可以调教成心目中的样子，原来 Retext 也可以这么美。

下面的很多操作都是结合网上教程，再加上在 openSUSE Leap 42.1 系统上的实际操作的结果记录下来的。

安装 Retext

从 openSUSE 官网软件库搜索 Retext 并下载安装： https://software.opensuse.org/421/zh_CN

应该也可以 pip 安装：

sudo pip install retext

调教需知

Retext 的配置文件在 ~/.config/ReText project/ReText.conf
Retext 的 markdown 扩展语法设置文件在 ~/.config//markdown-extensions.txt

Retext 的配置项可以参考 官网的说明

Retext 的配置文件

这是我的 Retextr 的配置内容

$ vim ~/.config/ReText project/ReText.conf

[General]
appStyleSheet=~/.config/ReText project/-style.qss
autoSave=true
editorFont=Monospace
editorFontSize=11
font=Monospace
fontSize=14
highlightCurrentLine=true
lineNumbersEnabled=true
previewState=true
recentFileList=/home/snail/env2p/blog/content/note/do_someting_after_install_retext.md, /home/snail/env2p/blog/content/note/extend_admin_in_django.md, /home/snail/env2p/blog/content/note/markdown.md
restorePreviewState=true
styleSheet=~/.config/ReText project/markdown7.css
tabInsertsSpaces=true
tabWidth=4
useWebKit=true

• appStyleSheet 项是设置界面风格的,这里的 style.qss 我是取自 QDarkStyleSheet 里的一套暗黑风格的界面 style.css ，你可以下载下来放在 ~/.config/ReText project/ 里，并在配置文件里指向它。但我的系统是浅色主题所以没有采用它。
• autoSave 项是确定是否自动保存。
• editorFont 项是设置编辑窗口字体。
• editorFontSize 项是设置编辑窗口字体大小。
• font 项是设置预览窗口字体。
• fontSize 项是设置预览窗口字体大小。
• handleWebLinks 项是否指定 web 链接，false 为外部浏览器打开链接，true 为在 Retext 预览界面里打开链接。
• highlightCurrentLine 项是确定是否高亮当前编辑行。
• lineNumbersEnabled=true 项是确定是否显示行号。
• previewState 项是确定预览状态。
• recentFileList 项是保存最近的打开的文件历史。
• restorePreviewState 项是确定是否恢复上次关闭 Retext 时的预览窗口状态。
• styleSheet 项是指定预览窗口的风格模板，这里的 markdown7.css 是取得 markdown-css-themes 的 markdown7.css ，你可以下载下来放在 ~/.config/ReText project/ 里，并在配置文件里指向它。
• tabInsertsSpaces 项是确认是否把 TAB 键转换成空格。
• tabWidth 项是指定 TAB 键的字符个数。
• useWebKit 项是确定是否开启 QtWebKit engine，设置为 true 预览效果会较好。

添加 Markdown 扩展

正常安装 Python-Markdown 后，就有一些扩展可以使用，这些扩展可以参考 官网说明 。

这里列表了几个常用的扩展项

• codehilite 添加语法高亮扩展
• footnotes 添加脚注扩展
• meta 添加预览时消除 meta 题头的扩展
• tables 添加表格扩展
• toc 添加目录扩展

要打开这些扩展，编辑 Retext 的 Markdown 扩展配置文件[^ext]

$ vim ~/.config//markdown-extensions.txt

codehilite
footnotes
meta
tables
toc

保存扩展配置文件，重新打开 Retext 后即可生效。

• codehilite 语法高亮

程序/语句段一个 TAB 缩进或者

​

……  
​

• footnotes 脚注

要脚注的后面 [^1]
在文后添加脚注说明

[^1]: 这里是脚注说明

这里的 1 可以是任意一个字串，但脚注及其说明要对应

• meta 预览时消除 meta 题头

添加后在预览时就不会显示 meta 题头了

• tables 允许表格

|商品|价格|
|--|--|
|番茄|1.5|
|马铃薯|0.8|
|娃娃菜|1.8|

商品	价格
番茄	1.5
马铃薯	0.8
娃娃菜	1.8

• toc 添加目录
  在需要添加目录的地放放置 [TOC] 即可。

添加第三方 Markdown 扩展

mathjax 添加数学公式

网上介绍

sudo apt-get install libjs-mathjax

不过这是 Debian 系统的安装方法，但 openSUSE 里怎么也找不到 libjs-mathjax ，后来在 Python-Markdown 的 第三方扩展 里找到了 python-markdown-math ，总算解决了 mathjax 的问题。

sudo pip install python-markdown-math

然后一样的添加 mathjax 到 Retext 的扩展配置文件里。

再然后我们添加一个公式 $a^2+b^2=c^2$ ，看看效果：$a^2+b^2=c^2$

有点讨厌，开了 mathjax 后，如果有公式存在，预览刷新后都会回到预览页面都是回到页面顶部，而且还会刷新闪动。