toctree

See also

http://sphinx-doc.org/latest/markup/toctree.html

de  Luc Saffre <luc.saffre@gmail.com>
heure de l'expéditeur   Envoyé à 14:26 (GMT+02:00). Heure locale : 17:00. ✆
répondre à  sphinx-dev@googlegroups.com
à   sphinx-dev <sphinx-dev@googlegroups.com>
date    18 février 2011 14:26
objet   [sphinx-dev] toctree glob ordering
liste de diffusion  <sphinx-dev.googlegroups.com> Filtrer les messages de cette liste de diffusion

Hi,

I just discovered a useful thing that is not documented (at least not where I would expect it to be at http://sphinx-doc.org/markup/toctree.html)

A toctree with :glob: flag option not only supports * but also the ? wildcard character.

I use this to have the correct sort order in an automatic index for pages are named using simple numbers, starting from 1.rst. When I have more than 9 files (12 for example), then a simple * would yield a toctree sorted 1, 11, 12, 2, 3, 4. But if I use the following construct:

.. toctree::
  :maxdepth: 1
  :glob:

  ?
  ??

then I get the expected order 1, 2, 3, 4, 11, 12.

In short: Sphinx is great :-)