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 を作成しましたが、これに遭遇したことはないので、途方に暮れています。何かご意見は?