Docs - init i18n

docsrc/source/_static/css/custom.css

@@ -1,5 +1,38 @@
 article figure img {
-  /*box-shadow: 0 4px 8px 0 rgba(0, 0, 0, 0.2), 0 6px 20px 0 rgba(0, 0, 0, 0.19);*/
-  /*box-shadow: 0 1px 6px 0 rgba(0, 0, 0, 0.2), 0 4px 6px 0 rgba(0, 0, 0, 0.19);*/
   border: solid 1px lightgrey;
+}
+
+#furo-languages {
+  position: relative;
+  display: inline-block;
+  font-size: var(--sidebar-item-font-size);
+  padding: 12px 16px;
+  border-top: solid 1px var(--color-sidebar-background-border);
+}
+
+#furo-languages:hover .languages-label {
+  display: none;
+}
+
+#furo-languages .languages-list {
+  display: none;
+  position: absolute;
+  background-color: var(--color-sidebar-item-background);
+  border-top: solid 1px var(--color-sidebar-background-border);
+  width: 100%;
+  z-index: 1;
+  left: 0;
+  bottom: 0;
+}
+#furo-languages .languages-list a {
+  display: block;
+  text-decoration: none;
+  padding: 12px 16px;
+  font-size: var(--sidebar-item-font-size);
+}
+#furo-languages:hover .languages-list {
+  display: block;
+}
+#furo-languages .languages-list a:hover {
+  background-color: var(--color-sidebar-item-background--hover);
 }

docsrc/source/_templates/sidebar/variant-selector.html

@@ -0,0 +1,12 @@
+<div id="furo-languages" tabindex="0">
+  <span class="languages-label">
+    <i class="fa fa-language"></i>
+  </span>
+  <div class="languages-list">
+    {%- for name, code in langs %}
+    <a href="../{{ '../' if '/' in pagename  else '' }}{{ code }}/{{ pagename }}.html" hreflang={{ code }} lang={{ code }}>
+      {{ name }}
+    </a>
+    {%- endfor %}
+  </div>
+</div>

docsrc/source/conf.py

@@ -95,3 +95,15 @@ source_suffix = {
     '.txt': 'markdown',
     '.md': 'markdown',
 }
+
+# -- Internationalization ----------------------------------------------------
+
+language = "en"
+locale_dirs = ["../locales"]
+gettext_compact = "docs"
+
+languages = [
+    ("English", "en"),  # English
+    ("Français", "fr"),  # French
+]
+html_context = { "langs": languages }