Ordnung (zeitlich)

../../../_images/hi-anordnen.svg

Bemerkung

Als ich des Suchens müde war, erlernte ich das Finden.

– Friedrich Nietzsche

Die Liste einzelner Artikel läßt sich in drei Varianten anordnen:

  1. explizit/manuell

  2. in alphabetischer Ordnung (automatisch)

  3. nach Datum (automatisch)

Reihenfolge: explizit

Die Reihenfolge wird definiert, indem die Artikel in der Reihenfolge gelistet werden, wie sie auch zur Anzeige kommen sollen.

.. toctree::
   :maxdepth: 1

   artikel/2022/artikel01
   artikel/2022/artikel05
   artikel/2022/artiekl07

Reihenfolge: alphabetisch

Setzt man den Parameter :glob: ein, kann über den * auf alle Artikel in einem Ordner zugegriffen werden. Das spart Tipparbeit. So wie das Betriebssystem die Dateien sortiert, werden sie automatisch in der Dokumentation angeordnet.

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

      artikel/2022/*

Reihenfolge: Datum

Hier sollten die Dateien einem Namensschema folgen, das eine umgekehrte Anordnung unterstützt z.B.

  • 2022-01-12.rst

  • 2022-02-12.rst

  • 2022-03-12.rst

Mit dem Schlüsselwort :reversed: kann dann die normale Sortierung umgekehrt werden und der aktuellste Artikel steht dann immer am Anfang der Liste.

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

      artikel/2022/*