这是一个创建于 3556 天前的主题，其中的信息可能已经有所发展或是发生改变。
一直只用Markdown，团队要求写sphinx文档，只能用restructuredText， 表格非要对齐又不能转义竖线，怎么这么难用？扫了下restructuredText的文档，感觉也没什么亮点？
对了，顺便问下，如果在restructuredText 的表格里想填 ps | grep abc, 怎么做。
对了，顺便问下，如果在restructuredText 的表格里想填 ps | grep abc, 怎么做。
 |
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. |
Select Language