two/docs/_static/version-switcher.js
GnomeZworc 8429dfd7e1
All checks were successful
Documentation / publish (push) Successful in 1m47s
ci: docs: liens du menu de version relatifs à switcher.json
Le menu de version pointait sur /main/ à la racine du domaine : DOCS_BASE_PATH
était vide alors que les pages sont servies sous /two/. Le thème colle l'URL
d'une version devant le chemin de la page sans la résoudre, un chemin relatif
y casserait donc selon la profondeur de la page.

Les URL de switcher.json sont désormais relatives à switcher.json lui-même, et
version-switcher.js les résout depuis cet emplacement une fois le menu rempli.
Le site fonctionne ainsi sous n'importe quel sous-chemin, sans réglage.

Le script est injecté par le workflow dans chaque version construite
(sphinx-build -D) : une version figée comme 0.2.0, construite depuis le
conf.py de son tag, le reçoit sans retoucher le tag.

Vérifié en local avec les étapes du workflow : site servi sous /two/ et à la
racine, liens du menu corrects sur une page de premier niveau et de
sous-répertoire.

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
2026-10-25 11:29:38 +01:00

16 lines
576 B
JavaScript

(() => {
const versionRoot = new URL(document.documentElement.dataset.content_root, window.location.href);
const switcherUrl = new URL(DOCUMENTATION_OPTIONS.theme_switcher_json_url, versionRoot);
const resolveLinks = (root) => {
root.querySelectorAll(".version-switcher__menu a[href]").forEach((anchor) => {
anchor.href = new URL(anchor.getAttribute("href"), switcherUrl).href;
});
};
resolveLinks(document);
new MutationObserver(() => resolveLinks(document)).observe(document.documentElement, {
childList: true,
subtree: true,
});
})();