Command

bengal.validate

Validate site health and content quality.

Runs health checks on your site to find errors, warnings, and issues. By default, shows only problems (errors and warnings).

Usage

bengal.validate [OPTIONS]

Options

Option Type Description
--changed flag BOOLEAN

Only validate changed files (requires incremental build cache)

--file PATH

Validate specific files (can be specified multiple times)

--fix flag BOOLEAN

Show migration hints for template errors

--ignore TEXT

Health check code to ignore (e.g., H101, H202). Can be specified multiple times.

--incremental flag BOOLEAN

Use incremental validation (only check changed files)

--profile CHOICE

Build profile to use (writer, theme-dev, developer)

--suggestions flag BOOLEAN

Show quality suggestions (collapsed by default)

--templates flag BOOLEAN

Validate template syntax (Kida/Jinja2 templates)

--templates-pattern TEXT

Glob pattern for templates (e.g., 'autodoc/**/*.html')

--traceback CHOICE

Traceback verbosity: full | compact | minimal | off

--verbose flag BOOLEAN

Show verbose output (all checks, not just problems)

--watch flag BOOLEAN

Watch mode: validate on file changes (experimental)

Arguments

Argument Type Description
source PATH Default:.

Examples

    bengal validate
    bengal validate --file content/page.md
    bengal validate --changed
    bengal validate --profile writer
    bengal validate --verbose
    bengal validate --ignore H101 --ignore H202
    bengal validate --templates
    bengal validate --templates --fix
    bengal validate --templates --templates-pattern "autodoc/**/*.html"