Merge branch 'main' into ci/autoupdate-translation-stats

Author: RobPasMue

TRANSLATING.md

@@ -8,6 +8,11 @@ This guide will help you get started contributing to the translation of the Pyth
 
 The process of contributing to the translation of the guide is similar to the process of contributing to the guide itself, except that instead of working on the guide source files directly, you will be working on the translation files.
 
+# Translation Status
+
+```{translation-graph}
+```
+
 ## Overview of the Translation Process
 
 The process of adapting software to different languages is called internationalization, or i18n for short. Internationalization makes sure that translation can happen without having to modify the source code, or in our case, the original English source files of the guide.

_ext/translation_graph.py

@@ -127,7 +127,6 @@ def run(self):
         )
         return [nodes.raw("", div, format="html")]
 
-
 def calculate_translation_percentage(po_path : Path, locale : str) -> ModuleStats:
     """
     Calculate the translation percentage for a given .po file.

_static/pyos.css

@@ -419,6 +419,31 @@ th {
   padding: 8px; /* Add some padding for better readability */
 }
 
+/* -------------- */
+/* Plotly Heatmap */
+/* -------------- */
+
+.plotly svg {
+  g:not(.heatmap-label) > text {
+    fill: var(--pst-color-text-base) !important;
+  }
+
+  @media (max-width: 540px) {
+    g.heatmap-label > text {
+      display: none;
+    }
+  }
+}
+
 /* ----------------- */
 /* Language Selector */
 /* ----------------- */
+
+/* Hide the left-side column for pages marked as orphan */
+.orphan .bd-sidebar {
+  display: none !important;
+}
+
+.orphan .bd-main {
+  margin-left: 0 !important;
+}

conf.py

@@ -83,6 +83,7 @@
     "sphinxext.opengraph",
     "sphinx_favicon",
     "sphinxcontrib.bibtex",
+    "_ext.translation_graph",
 ]
 
 # colon fence for card support in md

pyproject.toml

@@ -22,6 +22,8 @@ dependencies = [
     "sphinx-inline-tabs",
     # for project cards
     "matplotlib",
+    # for translation graphs
+    "plotly",
     # for license page bibliography
     "sphinxcontrib-bibtex",
 ]