- 主题:大家写文档用的什么工具？
使用手册这种，要出pdf, html，man，商业软件
尝试过asciidoctor和sphinx，这俩出html和man都可以，效果还可以
但pdf上， asciidoctor处理交叉引用过于简化，而且页眉页脚也过于简化，且依赖额外的theme
sphinx出pdf依赖latex，默认效果惨不忍睹，得二次处理.tex。
大家有什么推荐的工具吗？
--
FROM 58.211.103.*
可以考虑md+pandoc
【 在 pcal 的大作中提到: 】
: 使用手册这种，要出pdf, html，man，商业软件
: 尝试过asciidoctor和sphinx，这俩出html和man都可以，效果还可以
: 但pdf上， asciidoctor处理交叉引用过于简化，而且页眉页脚也过于简化，且依赖额外的theme
: ...................
--
FROM 124.64.23.*
【 在 pcal 的大作中提到: 】
: 使用手册这种，要出pdf, html，man，商业软件
: 尝试过asciidoctor和sphinx，这俩出html和man都可以，效果还可以
: 但pdf上， asciidoctor处理交叉引用过于简化，而且页眉页脚也过于简化，且依赖额外的theme
: ...................
texinfo？不过，这个也不友好，而且似乎也生成不了 man 吧
groff 好像可以生成 man，但这个太古老了……
--
FROM 117.152.202.*
markdown不行，缺很多功能，连图片大小都不能设置。
不是严肃的文档工具
【 在 licy 的大作中提到: 】
: 可以考虑md+pandoc
:
--
FROM 58.211.103.*
不是纯文本的，有大量的图片，表格，交叉引用啥的。
【 在 snoopyzhao 的大作中提到: 】
:
: texinfo？不过，这个也不友好，而且似乎也生成不了 man 吧
: groff 好像可以生成 man，但这个太古老了……
--
FROM 58.211.103.*
emacs 有个 org mode，感觉还是挺强大的
要不就照着这个列表挨个试一遍：
https://en.wikipedia.org/wiki/Lightweight_markup_language#Comparison_of_language_features
【 在 pcal 的大作中提到: 】
: 使用手册这种，要出pdf, html，man，商业软件
: 尝试过asciidoctor和sphinx，这俩出html和man都可以，效果还可以
: 但pdf上， asciidoctor处理交叉引用过于简化，而且页眉页脚也过于简化，且依赖额外的theme
: ...................
--
FROM 203.184.25.*
wps?
【 在 pcal 的大作中提到: 】
: 使用手册这种，要出pdf, html，man，商业软件
: 尝试过asciidoctor和sphinx，这俩出html和man都可以，效果还可以
: 但pdf上， asciidoctor处理交叉引用过于简化，而且页眉页脚也过于简化，且依赖额外的theme
: ...................
--
FROM 58.37.82.*
md可以设置图片大小啊, 直接用<img>标签啊, 就是html嘛
【 在 pcal 的大作中提到: 】
: markdown不行，缺很多功能，连图片大小都不能设置。
: 不是严肃的文档工具
--
FROM 123.120.191.*
reStructuredText呢？
【 在 pcal 的大作中提到: 】
: 使用手册这种，要出pdf, html，man，商业软件
: 尝试过asciidoctor和sphinx，这俩出html和man都可以，效果还可以
: 但pdf上， asciidoctor处理交叉引用过于简化，而且页眉页脚也过于简化，且依赖额外的theme
: ...................
--
FROM 221.216.156.*