vyos-documentation.git/docs/_templates, branch 1.4

Fix Cookiebot consent dialog rendering unstyled and breaking the page (#2108) (#2110)

2026-06-17T19:26:06+00:00

On a fresh (no-consent) load the consent banner could render completely unstyled and expand to full page height. Cookiebot delivers its dialog CSS as a constructed stylesheet on document.adoptedStyleSheets; ReadTheDocs' readthedocs-addons.js reassigns that whole-array property with a destructive replace, and when that lands after Cookiebot's network-gated adoption it drops Cookiebot's sheet, leaving #CybotCookiebotDialog at position:static expanded to ~6700px. It is a race, so it is intermittent and clears once consent is given (the dialog then never renders). - layout.html: a small adoptedStyleSheets shim, installed before any page script, that preserves Cookiebot's sheet so another library cannot drop it. - custom.css: a leak-safe safety net that keeps the dialog contained even if its adopted sheet is ever absent. It uses only properties Cookiebot itself sets, so it has verifiably no effect on the normal, styled banner. 🤖 Generated by [robots](https://vyos.io) (cherry picked from commit dce7bb521e3947af59fe18895b609ec353e0450e) Co-authored-by: Yuriy Andamasov

docs: finish RST→MD conversion on sagitta

2026-05-13T21:36:01+00:00

Port docs/cli.md and docs/installation/cloud/aws.md from rolling (the canonical, production-tested MyST versions) and remove the remaining cli.rst + aws.rst. Earlier conversion attempts on myst/sagitta had title-level errors flagged for separate fix; rolling's versions are clean. Drop the `cli.html` workaround in `_templates/llms.txt.j2` now that `cli.md` exists and is copied by `_copy_md_sources` — matches the rolling-branch template byte for byte at that line. 🤖 Generated by [robots](https://vyos.io)

fix(docs): add missing space after colon in personalization_storage

2026-05-07T15:19:48+00:00

🤖 Generated by [robots](https://vyos.io)

feat(docs): move Cookiebot CBID to COOKIEBOT_ID env var

2026-05-07T15:02:34+00:00

Read COOKIEBOT_ID from the environment via conf.py html_context, replacing the hardcoded data-cbid value in layout.html. Guards tightened to {% if gtm_id and cookiebot_id %} so neither GTM nor Cookiebot loads unless both IDs are present. 🤖 Generated by [robots](https://vyos.io)

fix(docs): guard GTM/Cookiebot blocks with {% if gtm_id %}

2026-05-07T15:02:34+00:00

Prevents broken googletagmanager.com requests with empty container IDs when GTM_ID is not set (local builds, preview environments). 🤖 Generated by [robots](https://vyos.io)

feat(docs): read GTM_ID from environment instead of hardcoding

2026-05-07T15:02:34+00:00

Move the Google Tag Manager container ID out of the template and into conf.py via os.environ.get('GTM_ID', ''), exposed to Jinja via html_context. Set GTM_ID in the RTD project environment variables. 🤖 Generated by [robots](https://vyos.io)

fix(docs): add title attribute to GTM noscript iframe for a11y

2026-05-07T15:01:30+00:00

🤖 Generated by [robots](https://vyos.io)

fix(docs): use window.dataLayer in gtag() and remove stray closing script tag

2026-05-07T15:01:30+00:00

Agent-Logs-Url: https://github.com/vyos/vyos-documentation/sessions/498fb4de-0a2a-43b8-b567-eb8d8883111b Co-authored-by: andamasov <12631358+andamasov@users.noreply.github.com>

feat(docs): add Cookiebot CMP and GTM with Consent Mode v2

2026-05-07T15:01:30+00:00

Inject Cookiebot CMP, Google Consent Mode v2 defaults, and Google Tag Manager into the Sphinx layout. Cookiebot loads first so its auto-blocker can scan and block other tags before they execute; Consent Mode v2 starts denied for all categories except security_storage and updates only after Cookiebot fires the consent update. 🤖 Generated by [robots](https://vyos.io)

docs(llms.txt): point links at .md sources, not .html

2026-05-07T06:34:21+00:00

Per the [llms.txt spec](https://llmstxt.org/), `/llms.txt` links should point at markdown files (the spec example: `[API docs](https://example.com/api.md)`). We were using `.html` URLs, which still work but force LLM consumers through HTML parsing for content that's already available as raw MyST at the same path (the `.md` is copied to HTML root by `_copy_md_sources`). Pivot the curated llms.txt template to `.md` URLs across 22 of 23 entries. The single exception is `cli.html` — sagitta's `docs/cli.rst` hasn't been migrated to MyST (rst-to-myst chokes on the heading hierarchy), so no `cli.md` is served at the HTML root. A Jinja comment in the template documents the exception and references the follow-up cli.rst migration as a separate PR. Verified locally: every linked `.md` path returns 200 in production. Same pivot applied symmetrically across [#1874](https://github.com/vyos/vyos-documentation/pull/1874) (current), [#1876](https://github.com/vyos/vyos-documentation/pull/1876) (sagitta), and [#1903](https://github.com/vyos/vyos-documentation/pull/1903) (circinus). 🤖 Generated by [robots](https://vyos.io)