Documentation

🚀 Getting Started
- Overview
  Introduction to GenGen and quick start guide
- Installation
  How to install and set up GenGen
- Configuration
  Complete guide to configuring GenGen
- Pages & Content
  Creating and structuring pages and posts
- Collections
  Group structured content with collections
🔗 URL Structure
- Permalinks
  URL structure and permalink configuration
- Aliases
  URL redirects and content migration
🎨 Styling & Assets
- Sass Processing
  Using Sass/SCSS with _sass directory structure
- Syntax Highlighting
  Code highlighting with the highlight tag
- Assets Management
  Managing static assets and files
- Aurora Theme
  Modern aurora-inspired starter theme
⚡ Advanced Features
- Pagination
  Automatic pagination for posts and content
- Plugins
  Using and developing custom plugins
- Liquid Templates
  Using Liquid templating language
🚀 Deployment
- Build Process
  Understanding the build process
- GitHub Pages
  Deploy to GitHub Pages
- Netlify
  Deploy to Netlify
📚 Reference
- CLI Commands
  Command-line interface reference
- API Reference
  Complete API documentation
- Troubleshooting
  Common issues and solutions

Troubleshooting

Diagnose common build and deployment issues in GenGen.

Troubleshooting

Build Fails Because of Missing Theme

Ensure the theme is installed or bundled in your repository. Run gengen list themes or double-check the _themes/ directory.

Liquid Error: Missing Include

Liquid throws a detailed error including the template and include name. Make sure _includes/ contains the referenced file or update the path in your render tag.

Tailwind Executable Not Found

Enable the Tailwind auto-fetch (see Tailwind enhancement proposal) or download the CLI manually and set tailwind_path in config.yaml.

If you run into something not covered here, open an issue so we can document the fix.