[somethingwithproof]

The published PDF/text manuals and contributed installation guides describe historical Cacti versions. This adds current replacements while preserving the original archive URLs, contributor credits, and rights notices.

• Publish the complete Cacti development PDF and UTF-8 text manual, plus German, Turkish, Linux, Russian UNIX/Windows, Windows, Solaris migration, and database-schema editions. Label every current edition as unreleased Cacti 1.3.
• Keep the localized introductions separate from their complete English appendices. These are new guides, not full translations or updates attributed to the original contributors. Explain the current Windows dependency restriction and use a migration procedure for Solaris.
• Record source hashes, output checksums, locked tooling, 11 archived originals, and the pinned upstream schema revision. The schema reference includes all 127 base tables and excludes seed data and upgrade commands.
• Reuse the maintained manual content and existing documentation styles. Include populated historical graph screenshots and a real rendered PDF preview in CI artifacts.

Validation: 6 edition-helper tests, 19 HTML-renderer tests, and 2 navigation regression tests pass, with 100% line and branch coverage for those two helpers. Real publication checks validate all 9 PDF/text editions, source/output hashes, complete selected chapters, internal PDF links, and non-English cover text. Browser E2E tests render 217 HTML pages and preserve all 75 legacy routes and 313 bookmarks. At 55aa975 the local main PDF contained 136 chapters across 516 pages; pagination can vary with native fonts/libraries. Markdown, spelling, and workflow checks pass.

Builds on #253, which carries the updated chapters and HTML publication workflow, and merges #250's branch, whose PDF and navigation tooling (bin/build_pdf_docs.py, bin/check_navigation.py, the tool lock and resources/css/pdf.css) it extends in place with language and title parameters, --companions and a heading parser. Merge #250 before this PR; once #250 is on develop, those files show only this PR's changes. #250's query examples and ReportIt work are reviewed in #250. CI uploads current manuals, manifests, coverage, and previews for 14 days. Publishing to the public file host remains a maintainer deployment step; archive files should keep their existing names and notices.

Native stack registration attempted with gh stack link --base develop 248 252 253 254. GitHub rejected it because #248 has auto-merge enabled. That setting is preserved. The PR base chain is #248 → #253 → #254 (#252 has merged into #248's branch); body links are not a substitute for native stack registration.

The editions are rebuilt once from this PR's sources in a CI-matching ubuntu:24.04 container, and their manifests name that source commit. bin/tests/verify_other_manuals.py reports the set complete, with 127 schema tables and 11 archived originals. check_navigation reports no errors, and the edition, navigation and HTML-renderer tests and codespell pass on the final tree. Hosted checks must run again on the current head.

Sonar duplication analysis excludes only the pinned upstream schema SQL and its deliberately generated DDL reference. Authored code remains in duplication analysis and the project thresholds are unchanged. Navigation heading parsing also avoids the previously flagged ambiguous regex.

Hosted validation passed at the earlier head 55aa975: complete HTML/browser publication, PDF/text edition publication, and both Sonar checks. The browser suite also verifies the language declarations of all four localized HTML guides.

Downloaded artifacts were checked after upload: ZIP integrity and SHA-256, every manual output checksum, both 100% helper coverage reports, all 5 browser cases, and the populated PDF preview. The hosted Linux main PDF has 529 pages; its 136 chapters match the local build despite font-dependent pagination.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud