调教Retext

目录

[TOC]

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

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

安装Retext

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

调教需知

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扩展配置文件¹

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

codehilite
footnotes
meta
tables
toc

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

• codehilite 语法高亮

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

```python  
……  
```

• footnotes 脚注

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

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

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

• meta 预览时消除meta题头

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

• tables 允许表格

|商品|价格|
|--|--|
|番茄|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

s 然后一样的添加mathjax到Retext的扩展配置文件里。 要看到公式的效果，还必须在编辑菜单下开启使用WebKit渲染。

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

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

好了，现在可以装比了～～