4

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

我想通过以下命令获得一页：

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

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

等等

问题是 Sphinx 只生成一个包含所有手册页的手册页。

我怎样才能得到我的预期结果？

4

1 回答 1

1

给定结构

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

然后，如果您使用的是 docs 类型

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

您可以通过修补makefile或bash中的一个衬里来自动化它

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

（未经测试，但应该接近）

当心包含路径，亲戚，交叉引用....

它可能会限制您在 Rst 中可以做的事情

于 2012-07-06T12:06:03.437 回答