pandas-dev · goanpeca · May 8, 2025 · May 11, 2025 · May 12, 2025 · May 12, 2025
diff --git a/.gitignore b/.gitignore
@@ -141,3 +141,12 @@ doc/source/savefig/
 # Pyodide/WASM related files #
 ##############################
 /.pyodide-xbuildenv-*
+
+
+# Web & Translations #
+##############################
+web/preview/
+web/translations/
+web/pandas/es/
+web/pandas/pt/
+web/pandas/fr/
diff --git a/web/pandas/_templates/layout.html b/web/pandas/_templates/layout.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html>
+<html lang="{{ selected_language }}">
     <head>
         <script defer data-domain="pandas.pydata.org" src="https://views.scientific-python.org/js/script.js"></script>
         <title>pandas - Python Data Analysis Library</title>
@@ -15,6 +15,82 @@
                   href="{{ base_url }}{{ stylesheet }}">
         {% endfor %}
         <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/font/bootstrap-icons.min.css">
+        <script type="text/javascript">
+            window.addEventListener("DOMContentLoaded", function() {
+            var absBaseUrl = document.baseURI;
+            var baseUrl = location.protocol + "//" + location.hostname
+            if (location.port) {
+                baseUrl = baseUrl + ":" + location.port
+            }
+            var currentLanguage = document.documentElement.lang;
+            var languages = [
+                {% for lang, name in translations["languages"].items() -%}
+                    "{{ lang }}",
+                {% endfor -%}
+            ]
+            var languageNames = {
+                {% for lang, name in translations["languages"].items() -%}
+                    {{ lang }}: '{{ name }}',
+                {% endfor -%}
+            }
+
+            // Handle preview URLs on github
+            // If preview URL changes, this regex will need to be updated
+            var re = /preview\/pandas-dev\/pandas\/(?<pr>[0-9]*)\//g;
+            var previewUrl = '';
+            for (const match of absBaseUrl.matchAll(re)) {
+                previewUrl = `/preview/pandas-dev/pandas/${match.groups.pr}`;
+            }
+            var pathName = location.pathname.replace(previewUrl, '')
+
+            // Create dropdown menu
+            function makeDropdown(options) {
+                var dropdown = document.createElement("li");
+                dropdown.classList.add("nav-item");
+                dropdown.classList.add("dropdown");
+
+                var link = document.createElement("a");
+                link.classList.add("nav-link");
+                link.classList.add("dropdown-toggle");
+                link.setAttribute("data-bs-toggle", "dropdown");
+                link.setAttribute("href", "#");
+                link.setAttribute("role", "button");
+                link.setAttribute("aria-haspopup", "true");
+                link.setAttribute("aria-expanded", "false");
+                link.textContent = languageNames[currentLanguage];
+
+                var dropdownMenu = document.createElement("div");
+                dropdownMenu.classList.add("dropdown-menu");
+
+                options.forEach(function(i) {
+                var dropdownItem = document.createElement("a");
+                dropdownItem.classList.add("dropdown-item");
+                dropdownItem.textContent = languageNames[i] || i.toUpperCase();
+                dropdownItem.setAttribute("href", "#");
+                dropdownItem.addEventListener("click", function() {
+                    var urlLanguage = '';
+                    if (i !== 'en') {
+                    urlLanguage = '/' + i;
+                    }
+                    pathName = pathName.replace('/' + currentLanguage + '/', '/')
+                    var newUrl = baseUrl + previewUrl + urlLanguage + pathName
+                    window.location.href = newUrl;
+                });
+                dropdownMenu.appendChild(dropdownItem);
+                });
+
+                dropdown.appendChild(link);
+                dropdown.appendChild(dropdownMenu);
+                return dropdown;
+            }
+
+            var container = document.getElementById("language-switcher-container");
+            if (container) {
+                var dropdown = makeDropdown(languages);
+                container.appendChild(dropdown);
+            }
+            });
+        </script>
     </head>
     <body>
         <header>
@@ -28,7 +104,7 @@
 
                     <div class="collapse navbar-collapse" id="nav-content">   
                         <ul class="navbar-nav ms-auto">
-                            {% for item in navbar %}
+                            {% for item in navbar[selected_language] %}
                                 {% if not item.has_subitems %}
                                     <li class="nav-item">
                                         <a class="nav-link" href="{% if not item.target.startswith("http") %}{{ base_url }}{% endif %}{{ item.target }}">{{ item.name }}</a>
@@ -50,6 +126,8 @@
                                     </li>
                                 {% endif %}
                             {% endfor %}
+                            <!-- Language switcher -->
+                            <div id="language-switcher-container"></div>
                         </ul>
                     </div>
                 </div>

diff --git a/web/pandas/config.yml b/web/pandas/config.yml
@@ -25,39 +25,6 @@ static:
   css:
   - static/css/pandas.css
   - static/css/codehilite.css
-navbar:
-  - name: "About us"
-    target:
-    - name: "About pandas"
-      target: about/
-    - name: "Project roadmap"
-      target: about/roadmap.html
-    - name: "Governance"
-      target: about/governance.html
-    - name: "Team"
-      target: about/team.html
-    - name: "Sponsors"
-      target: about/sponsors.html
-    - name: "Citing and logo"
-      target: about/citing.html
-  - name: "Getting started"
-    target: getting_started.html
-  - name: "Documentation"
-    target: docs/
-  - name: "Community"
-    target:
-    - name: "Blog"
-      target: community/blog/
-    - name: "Ask a question (StackOverflow)"
-      target: https://stackoverflow.com/questions/tagged/pandas
-    - name: "Code of conduct"
-      target: community/coc.html
-    - name: "Ecosystem"
-      target: community/ecosystem.html
-    - name: "Benchmarks"
-      target: community/benchmarks.html
-  - name: "Contribute"
-    target: contribute.html
 blog:
   num_posts: 50
   posts_path: community/blog
@@ -204,3 +171,14 @@ sponsors:
     kind: partner
 roadmap:
   pdeps_path: pdeps
+translations:
+  url: https://github.com/Scientific-Python-Translations/pandas-translations/archive/refs/heads/main.tar.gz
+  folder: translations
+  source_path: pandas-translations-main/web/pandas/
+  default_language: 'en'
+  default_prefix: ''
+  languages:
+    en: English
+    es: Español
+    pt: Português
+    # fr: Français
diff --git a/web/pandas/navbar.yml b/web/pandas/navbar.yml
@@ -0,0 +1,34 @@
+navbar:
+  - name: "About us"
+    target:
+    - name: "About pandas"
+      target: about/
+    - name: "Project roadmap"
+      target: about/roadmap.html
+    - name: "Governance"
+      target: about/governance.html
+    - name: "Team"
+      target: about/team.html
+    - name: "Sponsors"
+      target: about/sponsors.html
+    - name: "Citing and logo"
+      target: about/citing.html
+  - name: "Getting started"
+    target: getting_started.html
+  - name: "Documentation"
+    target: docs/
+    translated: false
+  - name: "Community"
+    target:
+    - name: "Blog"
+      target: community/blog/
+    - name: "Ask a question (StackOverflow)"
+      target: https://stackoverflow.com/questions/tagged/pandas
+    - name: "Code of conduct"
+      target: community/coc.html
+    - name: "Ecosystem"
+      target: community/ecosystem.html
+    - name: "Benchmarks"
+      target: community/benchmarks.html
+  - name: "Contribute"
+    target: contribute.html