如何生成多个手册页？

Question

我有一个用Python编写的命令行程序。我想用Sphinx生成手册页。

我想通过命令有一个页面，如：

man myprog foo - >重定向到foo命令的手册页。

man myprog foo2 - >重定向到foo2命令的手册页。

等

问题是狮身人面像所有手册页的聚集产生唯一一个手册页。

我如何获得预期的结果？

Answer 1

鉴于结构

docs/ 
    docs/source 
    docs/source/conf.py 
    docs/source/manable1/includable.rst 
    docs/source/index.rst 

然后，如果你在文档键入

sphinx-build -b man -c source source/manable1/ man/other_man 

可以自动化，通过任一修补生成文件或在bash一个一个衬里

for i in source/man*; do 
      sphinx-build -b man -c source $i man/$(basename $i); 
    done 

（未经测试但应该接近）

提防包括路径，亲属，交叉引用....

这可能会限制你可以在Rst的做