UYARI: belge dahil dosyanın

Question

Ben uyarıyı alıyorum herhangi toctree dahil değildir: bunlar açık bir şekilde dahil oldum çünkü doküman içinde yer dosyalar için

WARNING: document isn't included in any toctree 

. olduğu gibi, 0020-bar.rst, ben özellikle diğer dosyaların sayısı dahil ediyorum dosyasında

.. toctree:: 
    :maxdepth: 2 

    pages/0010-foo 
    pages/0020-bar 

: Yani dizin dosyanız

.. contents:: :local: 

.. include:: /pages/reference-architecture/technical-considerations/0070-baz.rst 

Ama proje oluştururken 0070-baz.rst herhangi toctree olmadığını, hala olduğu gibi, bir uyarı olsun:

/home/nick/Documents/myProject/docs/pages/reference-architecture/technical-considerations/0070-baz.rst:: WARNING: document isn't included in any toctree 

garip şey çıktı içeriğini görebilirsiniz olmasıdır. Bu normal mi? Bu uyarı her zaman açık bir şekilde eklenmiş olan dosyalar için açık olarak eklenen dosyalar için görünür mü?

Teşekkürler! Dosya dahil olup olmadığını Sfenks bu şikayet edecek

Answer 1

.

Ancak, özellikle exclude_patterns yapılandırma değerini kullanarak dosyaları hariç tutabilirsiniz. Dosyaların grupları bu şekilde eşleşecek şekilde kalıplarını globbing tek tek dosyaları, dizinleri veya kullanım dosyası hariç tutabilirsiniz

exclude_patterns = ['pages/reference-architecture', some/other/file.txt] 

:

Yani durum için gibi bir şey deneyebilirsiniz.

Answer 2

Girinti çalıştı: Sadece ..include:: başka belgede bir belge istiyorsanız

toctree:: 
    :maxdepth: 2 
     hello <h.rst> 
     abc <your.rst> 

Answer 3

, herhangi toctree görünür kalmadan.

uyarı kurtulmak için belgenizin üstüne :orphan: ekleyin.

Bu Dosya çapında meta seçeneği burada, daha bakın:

http://www.sphinx-doc.org/en/1.4.8/markup/misc.html#metadata