0
点赞
收藏
分享

微信扫一扫

开源一体化文档编写工具sgml/sphinx/markdown各自的适用场景

  一体化文档编写工具主要有sgml(pg采用)和sphinx(python社区和read the docs采用)两大类,官方文档推荐、索引全面,跟HTML高度雷同,当然也有一些采用markdown(github wiki或非正式文档推荐)。在lightdb中,三种文档均有采用。github上的文档采用markdown或手写为主,不够非常正式,用户手册以word或sgml/sphinx生成pdf和在线html为主。

markdown文档

markdown表格语法,推荐IDE Haroopad - The next document processor。

sphinx相关参考资料:

​​https://zhuanlan.zhihu.com/p/563055999​​

​​https://zh-sphinx-doc.readthedocs.io/en/latest/rest.html​​

​​https://zhuanlan.zhihu.com/p/264647009​​

​​https://zhuanlan.zhihu.com/p/510666093​​

​​https://www.zhihu.com/topic/20848782/newest​​

sgml:参考pg官方文档拷贝改即可。


举报

相关推荐

0 条评论