Add mkdocs-mdpo-plugin, mkdocs-material, and some config

bd808 · bd808 · commit 205eb5d61208 · 2021-11-01T13:37:28.000-06:00
I've been doing proof of concept experiments which often lead to messy
commits with too many things in them to make sense. I will try harder to
make more granular commits in the future I promise. :)

* Add mkdocs-mdpo-plugin for localization of markdown content via
  gnutext PO files which are compatible with translatewiki.net
  workflows.
* Add mkdocs-material theme as a base to customize from.
* Add config for mkdocs theme and current extensions.
* Custom CSS to apply Wikimedia colors to theme.
* Placeholder quality translations to Spanish to show POC function.
diff --git a/docs/assets/css/theme.css b/docs/assets/css/theme.css
@@ -0,0 +1,6 @@
+:root {
+	--md-primary-fg-color:        #3366CC; /* accent50 */
+	--md-primary-fg-color--light: #EAF3FF; /* accent90 */
+	--md-primary-fg-color--dark:  #2A4B8D; /* accent30 */
+	--md-text-font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Lato, Helvetica, Arial, sans-serif;
+}
diff --git a/docs/index.md b/docs/index.md
@@ -2,3 +2,5 @@
 
 Learn about, interact with, and contribute to the open source technology that
 powers [Wikipedia](https://www.wikipedia.org/) and other [Wikimedia projects](https://wikimediafoundation.org/our-work/wikimedia-projects/).
+
+Hello world!
diff --git a/docs/locale/es/LC_MESSAGES/index.md.po b/docs/locale/es/LC_MESSAGES/index.md.po
@@ -0,0 +1,21 @@
+#
+msgid ""
+msgstr ""
+
+msgid "Discover Wikimedia technical documentation and communities"
+msgstr "Descubra la documentación técnica y las comunidades de Wikimedia"
+
+msgid ""
+"Learn about, interact with, and contribute to the open source technology "
+"that powers [Wikipedia](https://www.wikipedia.org/) and other [Wikimedia "
+"projects](https://wikimediafoundation.org/our-work/wikimedia-projects/)."
+msgstr ""
+"Conozca, interactúe y contribuya a la tecnología de código abierto que "
+"impulsa a [Wikipedia](https://www.wikipedia.org/) y otros [proyectos de "
+"Wikimedia](https://wikimediafoundation.org/our-work/wikimedia-projects/)."
+
+msgid "Hello world!"
+msgstr "¡Hola Mundo!"
+
+msgid "Permanent link"
+msgstr "Enlace Permanente"
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -1 +1,62 @@
 site_name: Wikimedia Developer Portal
+site_url: https://developer.wikimedia.org/
+site_description: Portal for discovering technical documentation about Wikimedia projects
+site_author: Wikimedia Foundation and contributors
+copyright: Copyright &copy; 2021 Wikimedia Foundation and contributors
+
+docs_dir: docs
+theme:
+  name: material
+  language: en
+  font: false
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      toggle:
+        icon: material/lightbulb-outline
+        name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      toggle:
+        icon: material/lightbulb
+        name: Switch to light mode
+  features:
+    - navigation.instant
+    - navigation.tracking
+    - navigation.tabs
+    - navigation.sections
+    - toc.integrate
+    - navigation.top
+    - search.share
+
+extra_css:
+  - assets/css/theme.css
+#extra_javascript:
+#  - assets/js/extra.js
+
+extra:
+  alternate:
+    - name: English
+      lang: en
+    - name: Español
+      link: /es/
+      lang: es
+
+markdown_extensions:
+  - meta
+  - toc:
+      permalink: true
+      toc_depth: 3
+  - tables
+  - fenced_code
+  - attr_list
+  - pymdownx.highlight
+  - pymdownx.superfences
+  - pymdownx.inlinehilite
+
+plugins:
+  - search:
+      lang: en
+  - mdpo:
+      locale_dir: locale
+      lc_messages: true
diff --git a/poetry.lock b/poetry.lock
diff --git a/pyproject.toml b/pyproject.toml
