Hands-on lessons that teach you Bengal step-by-step. Each tutorial starts from scratch and builds to a working result.
Choose Your Starting Point
The perfect first tutorial for writers and beginners. No prior Bengal knowledge required.
Copy and customize just the templates you need. Perfect for personalizing your site while staying compatible with theme updates.
Complete migration guide from Hugo, Jekyll, Gatsby, or other SSGs. Includes content, templates, and configuration mapping.
Configure GitHub Actions for automatic builds, testing, and deployment to GitHub Pages, Netlify, or Vercel.
Learning Journey
Tip
After tutorials: Move to Content for authoring reference, Theming for customization, or Building for deployment options.
What makes a good tutorial?
Tutorials are learning-oriented — they teach skills through guided practice.
Each tutorial:
- Starts from scratch — No prior Bengal knowledge assumed
- Builds progressively — Each step builds on the previous
- Provides working code — Copy, run, and see results
- Explains the "why" — Understand concepts as you go
This follows the Diátaxis documentation framework.
Troubleshooting
Command not found
Ensure Python's bin directory is in your PATH.
If using a virtual environment, activate it:
source .venv/bin/activate
Try reinstalling:
pip uninstall bengal && pip install bengal
Python version errors
Verify your Python version:
1 2 3 | |
Install Python 3.14+ using pyenv or the official installer.
Permission errors
Use the--userflag:
pip install --user bengal
Or use a virtual environment:
python -m venv venv && source venv/bin/activate