VyOS readthedocs (mirror of https://github.com/vyos/vyos-documentation.git) https://git.amelek.net/vyos/vyos-documentation.git/atom?h=circinus 2026-05-07T05:48:02+00:00 2026-05-07T05:48:02+00:00 Yuriy Andamasov yuriy@vyos.io 2026-05-07T05:48:02+00:00 urn:sha1:23d6a3ef8afb0fddc0cc7c4591014b971ee2edf4 Parity with [#1874](https://github.com/vyos/vyos-documentation/pull/1874) (current) and [#1876](https://github.com/vyos/vyos-documentation/pull/1876) (sagitta). Replaces the static `docs/_html_extra/llms.txt` with a Jinja template (`docs/_templates/llms.txt.j2`) rendered at build time via a `build-finished` hook in `conf.py`. URLs and the version line are interpolated from `html_baseurl` and `release`, so the rendered file always matches what circinus actually serves. Hook behavior matches `current`/`sagitta` exactly, including the two review-cycle hardenings landed on those PRs: - Skips on builders other than `html` and `readthedocs` — the curated template encodes `.html` URLs which don't match `dirhtml` output. - `RuntimeError` if `html_baseurl` is empty rather than silently rendering broken root-relative URLs. - Jinja `Environment(undefined=StrictUndefined)` so a typo in `llms.txt.j2` raises at build time instead of writing a half-blank `llms.txt`. The closed PR [#1875](https://github.com/vyos/vyos-documentation/pull/1875) was the previous attempt; this re-lands the change after the post-flip rebase situation cleared. Verified locally: hook tests (happy-path render, fail-fast on `html_baseurl=None`/`''`, `StrictUndefined` catches `{{ relase }}` typo, skips `dirhtml`, skips on build exception) pass against this worktree. \xf0\x9f\xa4\x96 Generated by [robots](https://vyos.io) 2026-05-06T14:47:58+00:00 Yuriy Andamasov yuriy@vyos.io 2026-05-06T14:47:58+00:00 urn:sha1:b61087c396860bb507be1adea50244a8c8e3242c Replaces the broken #1885/#1869/#1875 trio with a single PR for circinus. This PR: - Imports 254 md-*.md files from currents working MyST conversion (the broken converter that produced #1885s md-*.md files is not used here; currents files are correct as verified on /en/rolling/). - Adds the per-page RST-to-MyST swap mechanism: scripts/swap_sources.py, scripts/import_myst.py, tests, _swap.txt, _ext/vyos.py and Makefile swap-wrapped targets, .readthedocs.yml pre/post hooks. - Replaces 175 .jpg/.png with 187 .webp images for swapped pages. - Adds the llms.txt + sitemap feature (sphinx_llms_txt, sphinx_sitemap) with circinus-tailored html_baseurl https://docs.vyos.io/en/1.5/ and curated docs/_html_extra/llms.txt for 1.5.x. - Updates docs/_html_extra/robots.txt with AI crawler Allow rules and the /en/1.5/sitemap.xml reference. - Drops configuration/service/suricata from the swap set (no matching RST sibling on circinus; suricata is a current-only feature). Supersedes: - #1885 (broken md-*.md converter output) - #1869 (LLM doc adaptation backport, bundled here) - #1875 (llms.txt circinus, bundled here) Generated by robots https://vyos.io 2025-02-19T11:09:44+00:00 Yevhen Bondarenko evgeniy.bondarenko@sentrium.io 2025-02-19T11:09:44+00:00 urn:sha1:a78c2266d990f25ed6c41a7b1444a3cf7881ef3a 2025-02-18T18:35:46+00:00 rebortg github@ghlr.de 2025-02-18T18:35:46+00:00 urn:sha1:bcee1acd7054fef3fe39a28ef774f1bc531cbb76 2025-02-18T18:35:02+00:00 rebortg github@ghlr.de 2025-02-18T18:13:11+00:00 urn:sha1:ba38b8b24417303ff4885e8c9b2c9440ffbf5ca6 (cherry picked from commit aa4a2101f82a5be4369b0f7bf44c59ddb533769b) 2025-02-17T21:23:46+00:00 rebortg github@ghlr.de 2025-02-17T21:23:46+00:00 urn:sha1:47de672e7ec349ed9b90733e9d7f10d2f689bec8 2025-02-17T21:04:01+00:00 rebortg github@ghlr.de 2025-02-17T20:55:41+00:00 urn:sha1:5b9ae4f5be54ca026e4a727b9caeb56bdb2d8ae0 (cherry picked from commit 0e440465338457b513e8b295f95b112bde75074b)