docs: add language switcher, sidebar filter, switch root redirect to /en/

Benibur · Benibur · commit 8699de4f70a3 · 2026-05-05T23:57:54.000+02:00
- _includes/head_custom.html: JS that hides side-nav entries belonging
  to the other language and injects a FR↔EN link into the auxiliary nav
  using each page's lang_alt_url front matter.
- index.html: root now redirects to /en/ (was /fr/) since EN is now
  available.
diff --git a/docs/_includes/head_custom.html b/docs/_includes/head_custom.html
@@ -0,0 +1,48 @@
+<script>
+(function () {
+  function init() {
+    var path = window.location.pathname;
+    var currentLang = null;
+    if (path.indexOf('/fr/') !== -1) currentLang = 'fr';
+    else if (path.indexOf('/en/') !== -1) currentLang = 'en';
+    if (!currentLang) return; // root redirect page — nothing to do
+
+    // 1. Filter the side nav: hide items that link to the other language
+    var navItems = document.querySelectorAll('.site-nav .nav-list-item');
+    navItems.forEach(function (item) {
+      var link = item.querySelector('.nav-list-link');
+      if (!link) return;
+      var href = link.getAttribute('href') || '';
+      var linkLang = null;
+      if (href.indexOf('/fr/') !== -1) linkLang = 'fr';
+      else if (href.indexOf('/en/') !== -1) linkLang = 'en';
+      if (linkLang && linkLang !== currentLang) {
+        item.style.display = 'none';
+      }
+    });
+
+    // 2. Inject the language switcher into the auxiliary nav (top-right)
+    {% if page.lang_alt_url %}
+    var altUrl = '{{ page.lang_alt_url | relative_url }}';
+    var label = currentLang === 'fr' ? 'EN' : 'FR';
+    var auxNav = document.querySelector('.aux-nav-list');
+    if (auxNav && altUrl) {
+      var li = document.createElement('li');
+      li.className = 'aux-nav-list-item';
+      var a = document.createElement('a');
+      a.href = altUrl;
+      a.className = 'site-button';
+      a.textContent = label;
+      li.appendChild(a);
+      auxNav.insertBefore(li, auxNav.firstChild);
+    }
+    {% endif %}
+  }
+
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', init);
+  } else {
+    init();
+  }
+})();
+</script>
diff --git a/docs/index.html b/docs/index.html
@@ -3,15 +3,15 @@
 sitemap: false
 ---
 <!DOCTYPE html>
-<html lang="fr">
+<html lang="en">
 <head>
 <meta charset="utf-8">
-<meta http-equiv="refresh" content="0; url={{ '/fr/' | relative_url }}">
-<link rel="canonical" href="{{ '/fr/' | relative_url }}">
-<title>Open Buro — Tech Sprint n°1</title>
-<script>window.location.replace("{{ '/fr/' | relative_url }}");</script>
+<meta http-equiv="refresh" content="0; url={{ '/en/' | relative_url }}">
+<link rel="canonical" href="{{ '/en/' | relative_url }}">
+<title>Open Buro — Tech Sprint #1</title>
+<script>window.location.replace("{{ '/en/' | relative_url }}");</script>
 </head>
 <body>
-<p><a href="{{ '/fr/' | relative_url }}">Redirection vers la documentation…</a></p>
+<p><a href="{{ '/en/' | relative_url }}">Redirecting to the documentation…</a></p>
 </body>
 </html>
