1
lk09364 2015-03-05 00:25:41 +08:00 1
|
2
mengzhuo 2015-03-05 07:38:14 +08:00 via iPhone 1
用工具啊
vim有一摞的rst表格插件 插入格式不需要的东西 转义不是任何人都第一个能想到的么 |
5
ioiioi 2015-03-05 12:56:42 +08:00
rst的优势在于只有一种语法,不像markdown那么多变种。支持的样式也比markdown多。
|
6
mengzhuo 2015-03-05 13:11:02 +08:00
@chilaoqi
ls说得不对,两者根本不具备可比性 rst完全可以胜任出版工作了 光是directive一项就完爆了md了 还有注释,引用,自动目录生成,文件引用,Latex集成 sphinx 这个变种还有很多针对代码文档的优化 自己看文档吧 |
7
chilaoqi OP @mengzhuo
不过,就我用过来说, restructuredText的一个缺点就是工具不够多啊, WYSIWYG的Online Editor我就只找到一个,并且很不好用 vim, sublime的工具我试了几个, 之所以我会提出上面的问题, 就是在自动生成时这些插件 总是会把 | 当成表格的分隔符, 即使我转义 \| ( 不确定这种转义对不对) 并且,是不是rst的语法过于严格, 比如表格必须要绝对对齐, 这对于没有自动化工具来说,是个体力活. |
8
haisua 2015-03-05 14:18:45 +08:00
reST是用来写“书”的,感觉MD更适合用来写一个简单的HTML页面。之前看过一个大神的Sphinx教程,很赞 http://hyry.dip.jp/tech/book/page/sphinx/index.html 。
|
9
mengzhuo 2015-03-05 15:48:10 +08:00
@chilaoqi
都是工具而已 自己用得舒服就好 都在用标记语言了,就少用WYSIWYG,充分相信自己和工具 p.s. 我的经验是对于自己不熟的工具要至少在别人帮助下、Google、并使用2周左右才能体会它的优缺点的 |
10
lk09364 2015-03-05 18:27:56 +08:00
@chilaoqi rst 的设计是给人直接用文字编辑器修改的…… 放弃 WYSIWYG 吧。
我也认同做表格的时候很麻烦,不过用sublime 的话有工具可以帮忙吧,例如Ctrl + Shift + L。 |
11
yech1990 2016-01-09 14:04:58 +08:00
因为你写的是 sphinx 的文档啊
wiki 的第一句 reStructuredText is a file format for textual data used primarily in the Python programming language community for technical documentation. |