V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX 提问指南
chilaoqi
V2EX  ›  问与答

restructuredText 优势何在?做个表格都要累死了!

  •  
  •   chilaoqi · 2015-03-04 23:52:39 +08:00 · 8226 次点击
    这是一个创建于 3552 天前的主题,其中的信息可能已经有所发展或是发生改变。
    一直只用Markdown,团队要求写sphinx文档,只能用restructuredText, 表格非要对齐又不能转义竖线,怎么这么难用?扫了下restructuredText的文档,感觉也没什么亮点?


    对了,顺便问下,如果在restructuredText 的表格里想填 ps | grep abc, 怎么做。
    11 条回复    2016-01-09 14:04:58 +08:00
    lk09364
        1
    lk09364  
       2015-03-05 00:25:41 +08:00   ❤️ 1
    mengzhuo
        2
    mengzhuo  
       2015-03-05 07:38:14 +08:00 via iPhone   ❤️ 1
    用工具啊
    vim有一摞的rst表格插件

    插入格式不需要的东西 转义不是任何人都第一个能想到的么
    chilaoqi
        3
    chilaoqi  
    OP
       2015-03-05 11:38:51 +08:00
    @lk09364 汗 - - 为什么我当时总是不成功, 谢谢啊!
    chilaoqi
        4
    chilaoqi  
    OP
       2015-03-05 11:39:52 +08:00
    @mengzhuo 恩 了解,谢谢. 但是想问问到底rst的优势在哪里? 除了那些只支持rst的地方...
    ioiioi
        5
    ioiioi  
       2015-03-05 12:56:42 +08:00
    rst的优势在于只有一种语法,不像markdown那么多变种。支持的样式也比markdown多。
    mengzhuo
        6
    mengzhuo  
       2015-03-05 13:11:02 +08:00
    @chilaoqi

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

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

    sphinx 这个变种还有很多针对代码文档的优化
    自己看文档吧
    chilaoqi
        7
    chilaoqi  
    OP
       2015-03-05 13:52:52 +08:00
    @mengzhuo

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

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

    并且,是不是rst的语法过于严格, 比如表格必须要绝对对齐, 这对于没有自动化工具来说,是个体力活.
    haisua
        8
    haisua  
       2015-03-05 14:18:45 +08:00
    reST是用来写“书”的,感觉MD更适合用来写一个简单的HTML页面。之前看过一个大神的Sphinx教程,很赞 http://hyry.dip.jp/tech/book/page/sphinx/index.html
    mengzhuo
        9
    mengzhuo  
       2015-03-05 15:48:10 +08:00
    @chilaoqi

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

    都在用标记语言了,就少用WYSIWYG,充分相信自己和工具
    p.s. 我的经验是对于自己不熟的工具要至少在别人帮助下、Google、并使用2周左右才能体会它的优缺点的
    lk09364
        10
    lk09364  
       2015-03-05 18:27:56 +08:00
    @chilaoqi rst 的设计是给人直接用文字编辑器修改的…… 放弃 WYSIWYG 吧。
    我也认同做表格的时候很麻烦,不过用sublime 的话有工具可以帮忙吧,例如Ctrl + Shift + L。
    yech1990
        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.
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   987 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 25ms · UTC 20:00 · PVG 04:00 · LAX 12:00 · JFK 15:00
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.