# Tutorials URL: /docs/tutorials/ Section: tutorials -------------------------------------------------------------------------------- Tutorials 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 Build a Blog from Scratch Start Here Go from zero to a deployed personal blog in 15 minutes The perfect first tutorial for writers and beginners. No prior Bengal knowledge required. Palette Swizzle and Customize the Default Theme Learn theme inheritance without breaking updates Copy and customize just the templates you need. Perfect for personalizing your site while staying compatible with theme updates. Migrate from Hugo 30 min Step-by-step migration from existing static site generators Complete migration guide from Hugo, Jekyll, Gatsby, or other SSGs. Includes content, templates, and configuration mapping. Settings Automate with GitHub Actions Set up CI/CD pipelines for automatic deployment Configure GitHub Actions for automatic builds, testing, and deployment to GitHub Pages, Netlify, or Vercel. Learning Journey flowchart LR A[Build a Blog] --> B[Content Authoring] A --> C[Swizzle Theme] C --> D[Theming Basics] B --> E[Advanced Content] D --> F[Custom Themes] E --> G[Automation] F --> G Tip Tip After tutorials: Move to Content for authoring reference, Theming for customization, or Building for deployment options. Info 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 Warning 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 Warning Python version errors Verify your Python version: 1 2 3python --version # or python3 --version Install Python 3.14+ using pyenv or the official installer. Warning Permission errors Use the --user flag: pip install --user bengal Or use a virtual environment: python -m venv venv && source venv/bin/activate -------------------------------------------------------------------------------- Metadata: - Author: lbliii - Word Count: 330 - Reading Time: 2 minutes