القائمة
Customizes or extends Bengal themes. Use when changing the default theme, adding custom templates, or creating a new theme.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Adds a new MyST directive to Bengal. Use when creating custom content blocks (admonitions, cards, tabs), extending the rendering system, or adding a directive.
Adds a new Jinja/Kida filter to Bengal templates. Use when creating custom filters for formatting, filtering, or transforming template data.
Migrates content from Markdown, Jekyll, Hugo, or other SSGs to Bengal. Use when converting a site, importing posts, or restructuring content.
Debugs Bengal build failures and errors. Use when builds fail, validation errors occur, or when fixing build errors.
Scaffolds a new Bengal static site with config, content structure, and theme. Use when creating a new site, starting a blog, or converting a project to Bengal.
Configures and uses taxonomy (tags, categories, indexes) in Bengal sites. Use when adding tags, categories, or querying content by section, author, or date.
| name | bengal-theme-customize |
| description | Customizes or extends Bengal themes. Use when changing the default theme, adding custom templates, or creating a new theme. |
Customize or extend Bengal themes.
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.
site-root/
├── static/ # Site-level static files
│ ├── css/
│ ├── js/
│ └── images/
Reference with asset_url('path/to/file.css') in templates.
[theme]
name = "default"
# features = ["search", "rss"]
The default theme supports features in theme.yaml. Override in config if needed.
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.
themes/default/
├── theme.yaml # Features, appearance, icons
├── templates/ # Kida/Jinja templates
│ ├── base.html
│ ├── home.html
│ ├── blog/
│ ├── doc/
│ └── partials/
└── assets/
├── css/
├── js/
└── icons/
Use theme.* for theme config in templates:
{{ theme.hero_style }}
{{ theme.default_palette }}
See references/theme-structure.md for directory layout.