restructuredText 优势何在？做个表格都要累死了！

[chilaoqi]

一直只用Markdown，团队要求写sphinx文档，只能用restructuredText， 表格非要对齐又不能转义竖线，怎么这么难用？扫了下restructuredText的文档，感觉也没什么亮点？


对了，顺便问下，如果在restructuredText 的表格里想填 ps | grep abc, 怎么做。

[lk09364]

https://gist.github.com/applelam/778cfde46bb3a1883417

[mengzhuo]

用工具啊
vim有一摞的rst表格插件

插入格式不需要的东西 转义不是任何人都第一个能想到的么

[chilaoqi]

@lk09364 汗 - - 为什么我当时总是不成功, 谢谢啊!

[chilaoqi]

@mengzhuo 恩 了解,谢谢. 但是想问问到底rst的优势在哪里? 除了那些只支持rst的地方...

[ioiioi]

rst的优势在于只有一种语法，不像markdown那么多变种。支持的样式也比markdown多。

[mengzhuo]

@chilaoqi

ls说得不对，两者根本不具备可比性

rst完全可以胜任出版工作了
光是directive一项就完爆了md了
还有注释，引用，自动目录生成，文件引用，Latex集成

sphinx 这个变种还有很多针对代码文档的优化
自己看文档吧

[chilaoqi]

@mengzhuo

不过,就我用过来说, restructuredText的一个缺点就是工具不够多啊, WYSIWYG的Online Editor我就只找到一个,并且很不好用

vim, sublime的工具我试了几个, 之所以我会提出上面的问题, 就是在自动生成时这些插件 总是会把 | 当成表格的分隔符, 即使我转义 \| ( 不确定这种转义对不对)

并且,是不是rst的语法过于严格, 比如表格必须要绝对对齐, 这对于没有自动化工具来说,是个体力活.

[haisua]

reST是用来写“书”的，感觉MD更适合用来写一个简单的HTML页面。之前看过一个大神的Sphinx教程，很赞 http://hyry.dip.jp/tech/book/page/sphinx/index.html 。

[mengzhuo]

@chilaoqi

都是工具而已
自己用得舒服就好

都在用标记语言了，就少用WYSIWYG，充分相信自己和工具
p.s. 我的经验是对于自己不熟的工具要至少在别人帮助下、Google、并使用2周左右才能体会它的优缺点的

[lk09364]

@chilaoqi rst 的设计是给人直接用文字编辑器修改的…… 放弃 WYSIWYG 吧。
我也认同做表格的时候很麻烦，不过用sublime 的话有工具可以帮忙吧，例如Ctrl + Shift + L。

[yech1990]

因为你写的是 sphinx 的文档啊

wiki 的第一句
reStructuredText is a file format for textual data used primarily in the Python programming language community for technical documentation.