feat!: Enable ar language (#3302)

.github/workflows/build-pr.yml

@@ -80,7 +80,7 @@ jobs:
     needs: [submodule, metadata]
     strategy:
       matrix:
-        lang: [es, fr, he, it, nl, ru, zh-Hant, zh-TW]
+        lang: [ar, es, fr, he, it, nl, ru, zh-Hant, zh-TW]
       fail-fast: false
     uses: ./.github/workflows/build.yml
     with:

.github/workflows/build-zimfile.yml

@@ -424,7 +424,7 @@ jobs:
 
     strategy:
       matrix:
-        lang: [en, es, fr, he, it, nl, ru, zh-Hant]
+        lang: [ar, en, es, fr, he, it, nl, ru, zh-Hant]
 
     steps:
       - name: Add GitHub Token to Environment

.github/workflows/publish-release.yml

@@ -50,7 +50,7 @@ jobs:
     needs: submodule
     strategy:
       matrix:
-        lang: [en, es, fr, he, it, nl, ru, zh-Hant, zh-TW]
+        lang: [ar, en, es, fr, he, it, nl, ru, zh-Hant, zh-TW]
         build: [build]
     permissions:
       contents: read

mkdocs.yml

@@ -173,6 +173,10 @@ extra:
       link: /en/
       lang: en
       icon: https://raw.githubusercontent.com/twitter/twemoji/master/assets/svg/1f1fa-1f1f8.svg
+    - name: عربي
+      link: /ar/
+      lang: ar
+      icon: https://raw.githubusercontent.com/twitter/twemoji/master/assets/svg/1f1f8-1f1e6.svg
     - name: Español
       link: /es/
       lang: es
@@ -313,7 +317,7 @@ markdown_extensions:
     custom_fences:
       - name: mermaid
         class: mermaid
-        format: !!python/name:pymdownx.superfences.fence_code_format 
+        format: !!python/name:pymdownx.superfences.fence_code_format
   pymdownx.tabbed:
     alternate_style: true
   pymdownx.arithmatex:
@@ -334,8 +338,8 @@ markdown_extensions:
   meta: {}
   abbr: {}
   pymdownx.emoji:
-    emoji_index: !!python/name:material.extensions.emoji.twemoji 
-    emoji_generator: !!python/name:material.extensions.emoji.to_svg 
+    emoji_index: !!python/name:material.extensions.emoji.twemoji
+    emoji_generator: !!python/name:material.extensions.emoji.to_svg
     options:
       custom_icons:
         - theme/icons

theme/assets/stylesheets/lang-ar.css

@@ -0,0 +1,43 @@
+/*
+/// Copyright (c) 2026 Jonah Aragon <jonah@triplebit.net>
+///
+/// Permission is hereby granted, free of charge, to any person obtaining a
+/// copy of this software and associated documentation files (the "Software"),
+/// to deal in the Software without restriction, including without limitation
+/// the rights to use, copy, modify, merge, publish, distribute, sublicense,
+/// and/or sell copies of the Software, and to permit persons to whom the
+/// Software is furnished to do so, subject to the following conditions:
+///
+/// The above copyright notice and this permission notice shall be included in
+/// all copies or substantial portions of the Software.
+///
+/// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+/// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+/// FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
+/// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+/// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+/// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+/// DEALINGS
+*/
+
+/* arabic */
+@font-face {
+  font-family: 'ABeeZee';
+  font-style: normal;
+  font-weight: 400;
+  src: url(https://fonts.bunny.net/abeezee/files/abeezee-latin-ext-400-normal.woff2) format('woff2'), url(https://fonts.bunny.net/abeezee/files/abeezee-latin-ext-400-normal.woff) format('woff');
+}
+
+/* latin */
+@font-face {
+  font-family: 'ABeeZee';
+  font-style: normal;
+  font-weight: 400;
+  src: url(https://fonts.bunny.net/abeezee/files/abeezee-latin-400-normal.woff2) format('woff2'), url(https://fonts.bunny.net/abeezee/files/abeezee-latin-400-normal.woff) format('woff');
+}
+
+
+h1, h2, h3, .md-header__topic {
+  font-family: "Bagnard", "ABeeZee", serif;
+  font-weight: 700!important;
+}

theme/layouts/home.yml

@@ -9,7 +9,9 @@ definitions:
     Bagnard
 
   - &font_family >-
-    {%- if config.theme.language == "he" -%}
+    {%- if config.theme.language == "ar" -%}
+      ABeeZee
+    {%- elif config.theme.language == "he" -%}
       Suez One
     {%- elif config.theme.language == ("ru" or "zh-Hant" or "zh-TW") -%}
       Noto Sans TC

theme/layouts/page.yml

@@ -17,7 +17,9 @@ definitions:
     {{ layout.color or "#2d2d2d" }}
 
   - &title_font_family >-
-    {%- if config.theme.language == "he" -%}
+    {%- if config.theme.language == "ar" -%}
+      ABeeZee
+    {%- elif config.theme.language == "he" -%}
       Suez One
     {%- elif config.theme.language == ("ru" or "zh-Hant" or "zh-TW") -%}
       Noto Serif TC

theme/layouts/pride.yml

@@ -13,7 +13,9 @@ definitions:
     {{ layout.color or "#2d2d2d" }}
 
   - &title_font_family >-
-    {%- if config.theme.language == "he" -%}
+    {%- if config.theme.language == "ar" -%}
+      ABeeZee
+    {%- elif config.theme.language == "he" -%}
       Suez One
     {%- elif config.theme.language == ("ru" or "zh-Hant" or "zh-TW") -%}
       Noto Serif TC

theme/layouts/toolbox.yml

@@ -17,7 +17,9 @@ definitions:
     {{ layout.color or "#2d2d2d" }}
 
   - &title_font_family >-
-    {%- if config.theme.language == "he" -%}
+    {%- if config.theme.language == "ar" -%}
+      ABeeZee
+    {%- elif config.theme.language == "he" -%}
       Suez One
     {%- elif config.theme.language == ("ru" or "zh-Hant" or "zh-TW") -%}
       Noto Serif TC