genindexSphinx は、ドキュメントを作成するときに名前を付けたインデックスを生成するため、その名前をドキュメントに使用することを禁止します。では、その索引へのリンクを目次に含めるにはどうすればよいでしょうか。
私はこれを試しました：
.. toctree::
:maxdepth: 2
genindex
api
Indices and tables
==================
* :ref:`genindex`
最後の行はドキュメント内のそのインデックスへのリンクを作成しますが、ビルドは TOC の作成時に参照を認識しません。
WARNING: toctree contains reference to nonexisting document 'genindex'