Bir Sphinx belgesinde, "glob" bayrağı seçeneği tarafından sağlanan yönergenin sırasını nasıl geri alabilirim?

Question

Dosya isimlerinin azalan sırasına göre sipariş verme seçeneği var mı? artan durumunda, biz kullanabilirsiniz: glob: Böyle bir seçenek:

.. toctree: 
    :glob: 

    2011* 

Bu Sfenks belge içinde bildirilmelidir yeniden harflerle yazılan günlük notlar için kullanışlı olacaktır.

Answer 1

Tutanakları tersine sıralamak için basit bir seçenek yoktur. Ancak belge yapısını dosyaya yazılmadan önce değiştirerek yapabilirsiniz. İşte bir öneri. conf.py aşağıdaki kodu ekleyin: doctree-resolved etkinliği tetiklendiğinde

def reverse_toctree(app, doctree, docname): 
    """Reverse the order of entries in the root toctree if 'glob' is used.""" 
    if docname == "index": 
     for node in doctree.traverse(): 
      if node.tagname == "toctree" and node.get("glob"): 
       node["entries"].reverse() 
       break 

def setup(app): 
    app.connect("doctree-resolved", reverse_toctree) 

reverse_toctree() geri çağırma işlevi çağrılır. İşlev belge ağacındaki toctree düğümünü bulur ve yerinde değiştirir. Sfenks ve Docutils API'ler hakkında

Diğer ayrıntılar:

• http://sphinx.pocoo.org/ext/appapi.html
• http://docutils.sourceforge.net/docs/ref/doctree.html

Answer 2

Bu toctree bir ters seçeneği ekler. sağlayan

from sphinx.directives import TocTree 
from docutils.parsers.rst import directives 

class NewTocTree(TocTree): 
    option_spec = dict(TocTree.option_spec, 
         reversed=directives.flag) 

    def run(self): 
     rst = super(NewTocTree, self).run() 
     if 'reversed' in self.options: 
      rst[0][0]['entries'].reverse() 
     return rst 

def setup(app): 
    app.add_directive('toctree', NewTocTree) 

yapmanız:

Sfenks'in itibariyle

Contents: 

.. toctree:: 
    :maxdepth: 2 
    :reversed: 
    :glob: 

    20* 

Answer 3

1.5+ yerleşik bir :reversed: bayrak bir toctree ekleyebileceğiniz vardır: Daha fazla bilgi için

.. toctree:: 
    :glob: 
    :reversed: 

    2011* 

, the Sphinx documentation'a bakın.