Command

bengal.utils.graph.orphans

List pages by connectivity level.

Shows pages grouped by how well they're connected:

  • 🔴 isolated: No meaningful connections (score < 0.25)
  • 🟠 lightly: Only structural links (score 0.25-1.0)
  • 🟡 adequately: Some connections (score 1.0-2.0)
  • 🟢 well: Well connected (score >= 2.0)

Use this command to:

  • Find truly isolated pages that need attention
  • Identify pages relying only on structural links
  • Prioritize internal linking improvements
5Options1Argument

Usage

bengal.utils.graph.orphans [OPTIONS]

Options

Option Type Description
--config PATH

Path to config file (default: bengal.toml)
--format, -f CHOICE

Output format (default: table)

Default:table
--level, -l CHOICE

Connectivity level to show (default: isolated)

Default:isolated
--limit, -n INTEGER

Limit number of results (default: all)
--sort CHOICE

Sort order (default: score)

Default:score

Arguments

Argument Type Description
source PATH Default:.

Examples

    # List isolated pages (truly orphaned)
    bengal graph orphans
    # List lightly linked pages
    bengal graph orphans --level lightly
    # Show all levels for full picture
    bengal graph orphans --level all
    # Export as JSON
    bengal graph orphans --format json > orphans.json