Collections

Collections are top-level directories with specific behaviors.

Collection Types

blog/

• URL: /blog/slug/
• Structure: Flat (subdirs ignored in URL)
• Sorting: By date (newest first)
• Features: RSS feed, date display

blog/
  2024-01-15-my-post.md    → /blog/my-post/
  2024/january/post.md     → /blog/post/

notes/

• URL: /notes/path/
• Structure: Hierarchical (subdirs preserved)
• Features: Auto-generated indexes, backlinks

notes/
  linux/
    index.md               → /notes/linux/
    networking.md          → /notes/linux/networking/

Directories without index.md get auto-generated indexes.

snippets/

• URL: /snippets/slug/
• Structure: Flat
• Features: Syntax highlighting, language detection

Place actual code files (not Markdown):

snippets/
  rust/vec_dedup.rs        → /snippets/vec-dedup/
  bash/backup.sh           → /snippets/backup/

Other Collections

• talks/: /talks/slug/ - Conference talks, presentations
• projects/: /projects/slug/ - Project showcases
• recipes/: /recipes/slug/ - Cooking or technical recipes
• slides/: /slides/slug/ - Slide decks (no backlinks)

Collection Behavior Summary

Related: #collections #organization @documentation