スフィンクスの:: include :: duplicate label警告

Question

Sphinxの.. include:: directiveを使用して、あるファイルのドキュメントを別のファイルに含めて、ドキュメントのソーステキストが複製されないようにしようとしています。私は含めてる部分はconfiguration.rstである（コンフィグ設定のリファレンスドキュメントのそれの一部）と、各コンフィグ設定を相互参照するためのいくつかのラベルが含まれています。別のファイル（authorization.rst）で

.. start_config-authorization 

.. _ckan.auth.anon_create_dataset: 

ckan.auth.anon_create_dataset 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

Example:: 

ckan.auth.anon_create_dataset = False 

Default value: ``False`` 

Allow users to create datasets without registering and logging in. 


.. _ckan.auth.create_unowned_dataset: 

ckan.auth.create_unowned_dataset 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

... 

.. end_config-authorization 

私はちょうど含ま

.. include:: /configuration.rst 
    :start-after: start_config-authorization 
    :end-before: end_config-authorization 

問題が含まれるテキスト内のラベルがスフィンクスからこの警告を生成することである：

doc/configuration.rst:224: WARNING: duplicate label ckan.auth.anon_create_dataset, other instance in doc/authorization.rst 

このような configuration.rstインラインからの許可設定の設定、

私は置けばこれまで相互参照が壊れていないようで、：

:ref:`ckan.auth.anon_create_dataset` 

を3番目のファイルには、これは正しくconfiguration.htmlでckan.auth.anon_create_datasetの定義（および含まれておりませんコピーへのリンクを作成しますその内のauthorization.html）。

これらの重複したラベルの警告を単純に無視または無音にして、すべての相互参照がconfiguration.htmlにリンクすることを期待してください。あるいは私はこれを行う別の方法を見つける必要がありますか？

Answer 1

無視してもよろしいですか？それは警告のままですが、元のコンテンツは含まれているラベルをブロックしているようですので、時々チェックすると危険ではありません。

ラベルなしのインデックスが作成されていないファイルにコンテンツを配置しようとしましたが、必要な場所にこのファイルを含めて、ラベル付きのファイルを作成し、ラベルなしのコンテンツを追加しましたか？最後のファイルは参照によって指し示すべきです。

Ps：テストしていないため、ラベルには標準の内容ではなくインクルードが含まれています。

Answer 2

これを解決するには、別の拡張子（* .inc）に切り替えるか、exclude_patternsのインクルードファイルをconf.pyに追加します。