bengal-theme-customize

name	bengal-theme-customize
description	Customizes or extends Bengal themes. Use when changing the default theme, adding custom templates, or creating a new theme.

Bengal Theme Customize

Customize or extend Bengal themes.

Override Templates

Place templates at site root to override the default theme:

site-root/
├── templates/           # Overrides theme templates
│   ├── base.html        # Override base layout
│   ├── home.html        # Override home page
│   └── blog/
│       └── single.html  # Override blog post template

Templates in templates/ take precedence over theme templates. Override only what you need.

Add Static Assets

site-root/
├── static/              # Site-level static files
│   ├── css/
│   ├── js/
│   └── images/

Reference with asset_url('path/to/file.css') in templates.

Theme Config (bengal.toml)

[theme]
name = "default"
# features = ["search", "rss"]

The default theme supports features in theme.yaml. Override in config if needed.

Create a Custom Theme

site-root/
├── themes/
│   └── my-theme/
│       ├── theme.yaml   # Theme metadata
│       ├── templates/   # Theme templates
│       │   ├── base.html
│       │   └── ...
│       └── assets/      # Theme assets
│           ├── css/
│           └── js/

Set [theme] name = "my-theme" in bengal.toml.

Theme Structure (Default)

themes/default/
├── theme.yaml       # Features, appearance, icons
├── templates/       # Kida/Jinja templates
│   ├── base.html
│   ├── home.html
│   ├── blog/
│   ├── doc/
│   └── partials/
└── assets/
    ├── css/
    ├── js/
    └── icons/

Template Context

Use theme.* for theme config in templates:

{{ theme.hero_style }}
{{ theme.default_palette }}

Checklist

• Create templates/ for overrides
• Create static/ for site assets
• Or create themes/my-theme/ for full custom theme
• Set theme name in bengal.toml
• Use asset_url() for asset paths

Additional Resources

See references/theme-structure.md for directory layout.