Command

bengal.explain

Explain how a page is built.

Shows complete traceability for any page including:

  • Source file information
  • Frontmatter metadata
  • Template inheritance chain
  • Dependencies (templates, data, assets)
  • Shortcodes/directives used
  • Cache status (HIT/MISS/STALE)
  • Output location
4Options2Arguments

Usage

bengal.explain [OPTIONS]

Options

Option Type Description
--diagnose, -d flag BOOLEAN

Check for issues (broken links, missing assets)
--json flag BOOLEAN

Output as JSON for programmatic use
--traceback CHOICE

Traceback verbosity: full | compact | minimal | off
--verbose, -v flag BOOLEAN

Show additional details (timing, template variables)

Arguments

Argument Type Description
page_path required TEXT
source PATH Default:.

Examples

    bengal explain docs/guide.md
    bengal explain content/posts/hello.md --verbose
    bengal explain api/reference.md --diagnose
    bengal explain docs/guide.md --json