docs: convert _include/interface-common-with-dhcp.txt MyST cmdincludemd -> RST

2026-05-13T23:57:24+00:00

feat: import MyST swap mechanism + content for sagitta (replaces #1886)

2026-05-06T15:46:21+00:00

Replaces the broken #1886 with a fresh, properly-converted MyST set for the sagitta (1.4.x) docs, mirroring what landed for circinus via #1897. This PR: - Re-imports 210 md-*.md files for sagitta. Source: ran the pipelines rst-to-myst converter (chrisjsewell/rst-to-myst v0.4.0, with pandoc fallback) on sagittas RST. Post-processed via the pipelines postprocess stage (10 ordered fixes for blanks, admonitions, label hyphens, pandoc artifacts, structural blanks, linter markers). Compared to the broken #1886 content (which was left over from an earlier stage-1-only run): zero raw `

` remnants. - For 23 stems where sagittas RST is byte-identical with currents RST (mostly stable policy/protocol pages and the 404 page), reuses currents already-validated md-*.md content rather than re-converting. - Drops cli and installation/cloud/aws from sagittas swap set: their RST has SEVERE/4 "Title level inconsistent" errors that crash rst-to-myst; they need an independent RST-source fix and are kept as RST-only for now. - Adds the per-page swap mechanism: scripts/swap_sources.py, scripts/import_myst.py, the matching tests under tests/, _swap.txt with 210 stems, _ext/vyos.py MyST renderer fallback, Makefile swap-wrapped targets, .readthedocs.yml swap pre/post hooks. - Adds 187 .webp images and removes 235 superseded .jpg/.png/.jpeg static assets; flips html_logo to vyos-logo.webp. - Adds the MyST swap-related blocks to docs/conf.py only: myst_enable_extensions, myst_fence_as_directive, md-*.md exclude patterns, _swap_exclude.txt reader, _prefer_webp and _copy_md_sources setup hooks. github_version fallback set to 'sagitta' to match the branch (parallel to currents 'current' and circinuss 'circinus'). Deliberately excluded (per user direction): - llms.txt and sphinx-llms-txt / sphinx-sitemap config: these will land separately for sagitta via #1870 plus a new sagitta-specific llms.txt template PR. The conf.py here does not pull those extensions in, so the build does not depend on the new pip packages. Verification before pushing: - 210 md-*.md = 210 _swap.txt stems = 210 RST siblings on sagitta (1:1:1). - 0 files contain raw `

fix build error after merge

2020-12-08T14:12:56+00:00

Merge branch 'sagitta' of https://github.com/rebortg/vyos-documentation

2020-12-08T13:57:44+00:00

change include to absolute path

2020-11-30T18:46:59+00:00

include: interface: fix ipv6 dhcp pd

2020-11-27T19:05:22+00:00

interfaces: consolidate vxlan, geneve, wifi, pppoe, wwan to new include command syntax

2020-11-10T21:57:12+00:00

interface: document dhcp(v6)-options on CLI

2020-11-10T20:29:41+00:00

interfaces: document dhcp-options

2020-11-10T19:58:07+00:00

interfaces: introduce new common-with|without-dhcp include

2020-11-10T19:39:39+00:00

Now we have one single include dealing with all the common interface stuff which is present on every interface.

vyos-documentation.git/docs/_include/interface-common-with-dhcp.txt, branch 1.4