Blog-style *tags* for Sphinx

[Mischback]

The content will be ordered using big categories, like Development, Knives, Misc. For additional ordering / more specific sorting, blog-style tags may be used.

There is a corresponding question on SO; the highest rated answer mentions Sphinx's built-in index directive.

Sphinx's documentation has a guide on developing a recipe extension which also incorporates a custom index. This may be a really great resource, if the built-in index is not sufficient out of the box.

[Mischback]

References

• Recipe extension
  • seemed really useful, not part of the above dry-coding
  • will become relevant once indexes should be used!
• TODO extension
  • base of the above dry-coding
• Sphinx's Domains
  • Not yet touched, is used by the Recipe tutorial
  • might become relevant (provide all cms-related meta stuff in a CMS domain or something like this!)
• docutils' tutorial on custom directives
  • reference for the (tbd) parsing logic of arguments