# Analysis

URL: /bengal/docs/build-sites/structure/analysis/
Section: analysis
Description: Site structure analysis tools

---

> For a complete page index, fetch /bengal/llms.txt.

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.

Graph Analysis

Analyze your site's structure, improve internal linking, and optimize navigation

(/bengal/docs/build-sites/structure/analysis/graph/)

## 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

- Report (#)

- Orphans (#)

- PageRank (#)

BASH

```
# 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

BASH

```
# 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)

BASH

```
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 with`bengal graph report` for a unified view of your site structure. Use `--ci`mode in pipelines to fail builds when connectivity thresholds are exceeded.

## In This Section

Graph Analysis (/bengal/docs/build-sites/structure/analysis/graph/)

Analyze your site's structure, improve internal linking, and optimize navigation

Related Pages

Configuration (/bengal/docs/ship/configuration/)

Configuring Bengal with bengal.toml

Related

Internationalization (i18n) (/bengal/docs/build-sites/structure/i18n/)

Multi-language sites with gettext PO/MO, RTL support, and translation workflows

Related

Ship (/bengal/docs/ship/)

Build configuration, SEO/discovery, output formats, and deployment

Related

Runtime Capabilities (/bengal/docs/ship/configuration/capabilities/)

Enable self-hosted diagram, math, and third-party JS capabilities

Related

Versioned Documentation (/bengal/docs/build-sites/structure/versioning/)

Serve multiple versions of your documentation from a single site

Related

persona-operator (/bengal/tags/persona-operator/)