docling-studio/mkdocs.yml
Pier-Jean Malandrino 8825292146 fix(docs): tolerate cross-tree links from audit reports in strict mode
The audit reports under docs/audit/reports/release-*/ reference repo
source files (e.g. `[file.py:line](file.py:line)`) on purpose — they
are read with the repo open, not as standalone published pages. MkDocs
in strict mode treats those as unrecognized links and aborts the build.

Set `validation.links.unrecognized_links: info` so the warning still
prints but doesn't fail the build. Real broken doc links (anchors,
absolute paths) keep their existing levels.

Refs the doc deploy run that broke just after the v0.5.0 tag was pushed.
2026-04-29 14:04:42 +02:00

94 lines
3.1 KiB
YAML

site_name: Docling Studio
site_description: Visual document analysis studio powered by Docling
site_url: https://scub-france.github.io/Docling-Studio/
repo_url: https://github.com/scub-france/Docling-Studio
repo_name: scub-france/Docling-Studio
theme:
name: material
palette:
- media: "(prefers-color-scheme: light)"
scheme: default
primary: deep orange
accent: orange
toggle:
icon: material/brightness-7
name: Dark mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
primary: deep orange
accent: orange
toggle:
icon: material/brightness-4
name: Light mode
features:
- navigation.sections
- navigation.expand
- content.code.copy
- toc.integrate
icon:
repo: fontawesome/brands/github
nav:
- Home: index.md
- Getting Started: getting-started.md
- Architecture: architecture.md
- Bbox Pipeline: bbox-pipeline.md
- Contributing: contributing.md
- Processes: PROCESSES.md
- Development:
- Coding Standards: architecture/coding-standards.md
- Commit Conventions: git-workflow/commit-conventions.md
- Code Review Checklist: git-workflow/code-review-checklist.md
- Merge Policy: git-workflow/merge-policy.md
- ADR Guide: architecture/adr-guide.md
- ADR Template: architecture/adr-template.md
- Release:
- Deployment Checklist: release/deployment-checklist.md
- Rollback Playbook: release/rollback-playbook.md
- Operations:
- Incident Response: operations/incident-response.md
- Security Response: operations/security-response.md
- Monitoring Checklist: operations/monitoring-checklist.md
- Community:
- Onboarding Guide: community/onboarding-guide.md
- Issue Triage: community/issue-triage-process.md
- Roadmap Template: community/roadmap-template.md
- Audit:
- Audit Master: audit/master.md
- Audits:
- Hexagonal Architecture: audit/audits/01-clean-architecture.md
- DDD: audit/audits/02-ddd.md
- Clean Code: audit/audits/03-clean-code.md
- KISS: audit/audits/04-kiss.md
- DRY: audit/audits/05-dry.md
- SOLID: audit/audits/06-solid.md
- Decoupling: audit/audits/07-decoupling.md
- Security: audit/audits/08-security.md
- Tests: audit/audits/09-tests.md
- CI & Build: audit/audits/10-ci-build.md
- Documentation: audit/audits/11-documentation.md
- Performance: audit/audits/12-performance.md
validation:
nav:
omitted_files: info
absolute_links: info
links:
absolute_links: info
# Audit reports (audit/reports/release-X.Y.Z/) reference repo source
# files (e.g. `[file.py:line](file.py:line)`) by design — they're read
# alongside the repo, not as standalone docs. Downgrade to info so
# strict-mode builds don't fail on these intentional cross-tree links.
unrecognized_links: info
markdown_extensions:
- admonition
- pymdownx.highlight:
anchor_linenums: true
- pymdownx.superfences
- pymdownx.tabbed:
alternate_style: true
- tables
- toc:
permalink: true