- 主题:大家写文档用的什么工具？
使用手册这种，要出pdf, html，man，商业软件
尝试过asciidoctor和sphinx，这俩出html和man都可以，效果还可以
但pdf上， asciidoctor处理交叉引用过于简化，而且页眉页脚也过于简化，且依赖额外的theme
sphinx出pdf依赖latex，默认效果惨不忍睹，得二次处理.tex。
大家有什么推荐的工具吗？
--
FROM 58.211.103.*
markdown不行，缺很多功能，连图片大小都不能设置。
不是严肃的文档工具
【 在 licy 的大作中提到: 】
: 可以考虑md+pandoc
:
--
FROM 58.211.103.*
不是纯文本的，有大量的图片，表格，交叉引用啥的。
【 在 snoopyzhao 的大作中提到: 】
:
: texinfo？不过，这个也不友好，而且似乎也生成不了 man 吧
: groff 好像可以生成 man，但这个太古老了……
--
FROM 58.211.103.*
sphinx试过了。出pdf不美观。
【 在 seablue 的大作中提到: 】
: reStructuredText呢？
:
--
FROM 58.211.103.*
word不好用，短文档还能凑合，长文档简直受罪
出的html不好
出不了manpage
不好用git
【 在 No1 的大作中提到: 】
: 最好使的 word 为啥不在你的选择范围里
:
--
FROM 58.211.103.*
html和pdf是全部，manpage是其中一部分内容。
目前在用asciidoctor。
【 在 fanci 的大作中提到: 】
: manpage里能有图表？？
: - 来自 水木社区APP v3.5.5
--
FROM 58.211.103.*