4 
Contents:

.. toctree::
   :maxdepth: 2

   foo.rst
   bar.rst

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

を使用してビルドしようとしてsphinx-build . docいますが、警告が表示されます:

(WARNING/2) toctree references unknown document u'bar'

その理由は何ですか？

4

2 に答える 2

3

.rstSphinx はtoctree ディレクティブに拡張機能を必要としません。toctree が と 同じディレクトリにあると仮定すると、toctree ディレクティブのand をそれぞれindex.rstandにbar.rst置き換えてみてfoo.rstください。bar.rstfoobar

それ以外の場合bar.rstは、(親またはサブディレクトリではなく) 正しいディレクトリにあることを確認してください。

于 2010-12-13T22:03:01.513 に答える
2

私もこのエラーを受けていました。私にとっては、それはインデントによるものでした。「toctree」は 3 つのスペース文字でインデントされていましたが、最初のファイルを 4 つのスペース文字でリストしました。この問題を解決するには、インデント レベルを同じにする必要があります。

于 2012-05-10T11:53:52.177 に答える