vyos-documentation.git/docs/_templates, branch docs/t8887-phase1-batch1

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

2026-06-17T19:23:43+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)

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

2026-05-07T15:23:25+00:00

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

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

2026-05-07T15:23:25+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:23:25+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:23:25+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): remove stray and add title to GTM noscript iframe

2026-05-07T15:22:52+00:00

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

fix(docs): deduplicate GTM ID via Jinja var and use window.dataLayer in gtag()

2026-05-07T15:22:52+00:00

Agent-Logs-Url: https://github.com/vyos/vyos-documentation/sessions/f6d95cc7-cdbe-4d76-8077-f7fae5e9ddf2 Co-authored-by: andamasov <12631358+andamasov@users.noreply.github.com>

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

2026-05-07T15:22:52+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:19+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 all 22 entries. Spec-compliant, no extra requests, LLMs get raw markdown without the navigation chrome. Verified locally: `/en//.md` returns 200 with raw MyST content (frontmatter + body) for all linked paths on this branch. 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)

docs: render llms.txt at build time from a Jinja template

2026-05-04T08:02:44+00:00

Replace the static curated llms.txt with a build-time render that interpolates html_baseurl and release into the file, so the file always matches the branch it was built from. llms-full.txt is already auto-generated by sphinx-llms-txt. 🤖 Generated by [robots](https://vyos.io)