Analyze your site's structure to improve navigation and discoverability.
Note
Do I need this? Skip if your site has under 50 pages. Read when you want to find orphan pages, improve internal linking, or run connectivity checks in CI.
Analysis Tools
flowchart LR
A[Your Site] --> B[Analysis Engine]
subgraph Outputs
C[Connectivity Report]
D[Link Suggestions]
E[PageRank]
end
B --> C
B --> D
B --> E
Quick Start
# Unified connectivity report
bengal graph report
# Brief output for CI
bengal graph report --brief
# CI mode with thresholds
bengal graph report --ci --threshold-isolated 5
Shows:
- Connectivity distribution
- Isolated/lightly-linked pages
- Bridge pages
- Actionable recommendations
# Find isolated pages
bengal graph orphans
# Find lightly-linked pages
bengal graph orphans --level lightly
# JSON output for processing
bengal graph orphans --format json
# Paths only (for scripting)
bengal graph orphans --format paths
Identifies pages by connectivity level:
- 🔴 Isolated (score < 0.25)
- 🟠 Lightly linked (0.25-1.0)
- 🟡 Adequately linked (1.0-2.0)
- 🟢 Well-connected (≥ 2.0)
bengal graph pagerank --top-n 20
Identifies:
- Most important pages
- Underlinked valuable content
- Navigation priorities
Use Cases
| Goal | Command | Output |
|---|---|---|
| Get site health overview | bengal graph report |
Connectivity distribution and recommendations |
| Find isolated pages | bengal graph orphans |
Pages needing attention |
| Find bridge pages | bengal graph bridges |
Navigation bottlenecks |
| Identify key content | bengal graph pagerank --top-n 20 |
Pages ranked by importance |
Tip
Start withbengal graph report for a unified view of your site structure. Use --cimode in pipelines to fail builds when connectivity thresholds are exceeded.
In This Section
Graph Analysis
Analyze your site's structure, improve internal linking, and optimize navigation
Related Pages
Configuration
Configuring Bengal with bengal.toml
Internationalization (i18n)
Multi-language sites with gettext PO/MO, RTL support, and translation workflows
Ship
Build configuration, SEO/discovery, output formats, and deployment
Runtime Capabilities
Enable self-hosted diagram, math, and third-party JS capabilities
Versioned Documentation
Serve multiple versions of your documentation from a single site