Sitemap & Link Integrity Validator Reference
scripts/verify_sitemap_links.py performs rigorous pre-merge validation of all sitemap links across GitBook and GitHub Pages targets.
🧭 Major Validation Phases
- Synchronization check: Compares root
sitemap.txtandsitemap.xmlwithdocs/sitemap.txtanddocs/sitemap.xml. - Structural check: Confirms XML and text sitemaps match perfectly.
- SSRF Host Check: Limits HTTP requests strictly to allowed hostnames (
linuxmalaysia.github.ioandmalaysia-open-source-community.gitbook.io). - GitBook Sampling: Validates a deterministic sample of five GitBook URLs loaded from a separate validation inventory.
- Pre-merge fallback: If a GitHub Pages URL reports 404, verifies if its corresponding source
.mdfile is present locally underdocs/.
🔒 Exit Codes
0: Success. All links verified and sitemaps aligned.1: Failure. Broken links or misaligned sitemaps detected.