ci: docs: liens du menu de version relatifs à switcher.json
All checks were successful
Documentation / publish (push) Successful in 1m47s
All checks were successful
Documentation / publish (push) Successful in 1m47s
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>
This commit is contained in:
parent
5a5e2869d5
commit
8429dfd7e1
2 changed files with 26 additions and 14 deletions
16
docs/_static/version-switcher.js
vendored
Normal file
16
docs/_static/version-switcher.js
vendored
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
(() => {
|
||||
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,
|
||||
});
|
||||
})();
|
||||
Loading…
Add table
Add a link
Reference in a new issue