2

Sphinx を使用して、私が取り組んできた Python ライブラリを文書化しようとしています。途中でこの投稿を大まかなガイドとして使用してきました。しかし、Sphinx を正しく動作させるのに問題があります。

すべての設定が完了したら、Sphinx がインストールされ、プロジェクトのルートから入力するコードにドキュメントを追加しました。

sphinx-apidoc -F -o docs/ mypackage/

出力:

Creating file docs/mypackage.rst.
Creating file docs/mypackage.helpers.rst.
Creating file docs/conf.py.
Creating file docs/index.rst.
Creating file docs/Makefile.
Creating file docs/make.bat.

次に、docs/conf.py をそれぞれ編集して、sys.path.insert(0, os.path.abspath('/Users//path/to/mypackage')) が正しいことを確認します。

ただし、次の方法で(docsディレクトリ内から)ドキュメントをビルドしようとすると:

build html

私は次のように迎えられます:

-bash: make: command not found

私は sphinx-apidoc を使用し、他のライブラリで html を作成しましたが、これに遭遇したことはないので、途方に暮れています。何かご意見は?

4

1 に答える 1