VyOS readthedocs (mirror of https://github.com/vyos/vyos-documentation.git) https://git.amelek.net/vyos/vyos-documentation.git/atom?h=claude%2Fcf-port-circinus 2026-08-15T12:52:50+00:00 2026-08-15T12:52:50+00:00 Yuriy Andamasov yuriy@vyos.io 2026-08-15T12:52:50+00:00 urn:sha1:0f69d0846fef313f23c84d7dff8b5ae8e24ec04c Hand-merges the CF-specific hunks onto circinus's own docker/Dockerfile and docs/conf.py rather than clobbering them with rolling's versions — circinus keeps its own content-driven history in both files. docker/Dockerfile: - imagemagick + librsvg2-bin (sphinx.ext.imgconverter backend) and poppler-utils (pdfinfo, used by docs-build.yml's PDF page-count completeness check), installed --no-install-recommends - install docker/im-convert.sh as /usr/local/bin/im-convert docs/conf.py: - enable sphinx.ext.imgconverter + image_converter = 'im-convert' so the LaTeX/PDF builder stops silently dropping .webp/.svg images - register js/version-picker.js + css/version-picker.css unconditionally (degrades silently on ReadTheDocs) - _vyos_cf_build gate off the raw DOCS_VERSION_SLUG env var; only CF builds load js/pagefind-wrapper.js, and html_context['vyos_cf_build'] lets _templates/searchbox.html fall back to the stock Sphinx searchbox via the "!" bang-include on RTD The RTD path stays the default in both files: circinus continues building on ReadTheDocs until RTD sunset, and every CF feature activates only when DOCS_VERSION_SLUG is present. .readthedocs.yml is untouched. circinus keeps its own version/release/html_title/source_suffix and its hardcoded html_baseurl (its CF slug is also `1.5`, so rolling's DOCS_VERSION_SLUG/READTHEDOCS_VERSION resolution block is a no-op here and was deliberately not ported). Advances: IS-572 2026-08-15T12:52:37+00:00 Yuriy Andamasov yuriy@vyos.io 2026-08-15T12:52:03+00:00 urn:sha1:6c420e86f4ad0b8440db9060803fe8e8cbdace0f Copies the branch-agnostic half of the docs.vyos.io Cloudflare Workers pipeline from `rolling` at 8cb568bf, byte-identical: - .github/workflows/docs-build.yml - workers/ (entire tree) - scripts/docs_gates/ - docker/im-convert.sh - docs/_static/js/version-picker.js, js/pagefind-wrapper.js, css/version-picker.css (new files, no circinus counterpart) - docs/_templates/breadcrumbs.html, searchbox.html (new files) docs-build.yml already triggers on push to [rolling, circinus, sagitta] and resolves `circinus` -> worker vyos-docs-v15-en / slug 1.5 from workers/matrix.json; the files simply did not exist on this branch, so slug 1.5 still serves the bootstrap placeholder. workers/versions.json + workers/matrix.json are deliberately identical across all three branches and must be kept in sync. Advances: IS-572 2026-05-07T08:57:45+00:00 Yuriy Andamasov yuriy@vyos.io 2026-05-07T08:57:45+00:00 urn:sha1:366537b87376e071473849e1f870839c07692541 Circinus's `docker/Dockerfile` was missing two pip-installed Python extensions enabled in `docs/conf.py` post-#1903 (the circinus llms.txt build-time render). Without them, `make html` from inside the docker image fails to load `sphinx_llms_txt` and `sphinx_sitemap`. `current` and `sagitta` Dockerfiles already include both. After this fix, circinus's Dockerfile is byte-identical to current's (md5 `45101a75...`). Bundled here because [#1906](https://github.com/vyos/vyos-documentation/pull/1906)'s CLAUDE.md states "Docker (recommended)" and the previous Copilot review pointed out (correctly) that the referenced docker image wouldn't actually build the docs without these deps. Fixing the Dockerfile makes the CLAUDE.md claim accurate. \xf0\x9f\xa4\x96 Generated by [robots](https://vyos.io) 2024-05-10T18:15:36+00:00 Matthew Kobayashi 1856537+MattKobayashi@users.noreply.github.com 2024-05-10T18:15:36+00:00 urn:sha1:48fc4291536607036f3191cad21ff0065d1eeaaf * Update Debian base image to 12 * Add --break-system-packages option to pip3 install command * Remove chmod a+s from Dockerfile (newer versions of gosu in particular don't support this) * Add sudo to relevant commands in entrypoint.sh * Add UID_MIN key to adduser command (allows the container to run on MacOS) * Formatting and spelling fixes 2024-01-16T12:15:18+00:00 Robert Göhler github@ghlr.de 2024-01-16T12:15:18+00:00 urn:sha1:eeffa32cf0c486fc12dba86d30c365f9b521652a 2022-08-25T09:32:52+00:00 snyk-bot snyk-bot@snyk.io 2022-08-25T09:32:52+00:00 urn:sha1:75b7c2ba6006e73e2fbbcb4783e5ba6a30f004d1 The following vulnerabilities are fixed with an upgrade: - https://snyk.io/vuln/SNYK-DEBIAN10-BASH-536280 - https://snyk.io/vuln/SNYK-DEBIAN10-GCC8-347558 - https://snyk.io/vuln/SNYK-DEBIAN10-GCC8-347558 - https://snyk.io/vuln/SNYK-DEBIAN10-GCC8-347558 - https://snyk.io/vuln/SNYK-DEBIAN10-ZLIB-2976149 2022-04-01T09:42:53+00:00 rebortg github@ghlr.de 2022-04-01T09:42:53+00:00 urn:sha1:9708481d5e539a4b5c3d13b1a774abcda84df138 2022-02-12T20:40:50+00:00 rebortg github@ghlr.de 2022-02-12T20:38:45+00:00 urn:sha1:31464afb0430303bc84b879b28ebe7a9e4374818 (cherry picked from commit 6052f0d7374519f8de9f076ba9db63ef7aed162a) 2022-01-24T20:17:24+00:00 rebortg github@ghlr.de 2022-01-24T20:17:24+00:00 urn:sha1:ca70a6d267fd20d852cef45eb089a61f63bb139c 2020-12-08T13:38:56+00:00 rebortg github@ghlr.de 2020-12-08T13:38:56+00:00 urn:sha1:0bb741b58bc0dd7f0beae7364ed519f7165bdbb7