Imported from Aldo-f/Aldo-f.github.io (overrides/AGENTS.md). Install upstream with npx skills add Aldo-f/Aldo-f.github.io --skill overrides. Copyright stays with the author.

PROJECT KNOWLEDGE BASE – overrides

Generated: 2026-09-13 Commit: {{short_sha}} Branch: {{branch}}

OVERVIEW

MkDocs Material template overrides for custom HTML rendering.

STRUCTURE

overrides/
├── 404.html                   # 404 dungeon game page
├── 404_dungeon.md             # 404 dungeon content (JSON data)
├── main.html                  # Base template layout
├── partials/
│   ├── blog_post.html         # Blog post rendering
│   ├── comments.html          # Disqus/comments integration
│   ├── copyright.html         # Footer copyright
│   └── source.html            # Source file link
└── ...

WHERE TO LOOK

CONVENTIONS

• Templates use Jinja2 syntax.
• Override Material templates by matching the same file structure.
• JavaScript/CSS in templates is inline — no external assets unless needed.
• 404 dungeon data lives in data/404_dungeon.json.

ANTI‑PATTERNS

• Do not edit generated site/ output — only modify source templates.
• Do not add heavy JavaScript libraries — keep it lightweight.
• Do not duplicate content from parent templates.

COMMANDS

# Build site with overrides
mkdocs build -f mkdocs.en.yml --strict

# Preview locally
mkdocs serve -f mkdocs.en.yml