bilingual-jekyll-resume-theme 0.8.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc4ee64a555f7e1df4e80b33d565d82142dd29f56b23204ad071fa1c970e2388
-  data.tar.gz: e7eb24a6509d3e10f7fd167fec77533483d8bb8e47b4c998ef6576e92291fc96
+  metadata.gz: 00d980490bbad955afa894d864e4379a65a6f39f371d97a6db9d1808785ccaed
+  data.tar.gz: b5c302a20cb5d88382151575fdb376b870969a4067d401da907cb2608f76ed3b
 SHA512:
-  metadata.gz: c56b2e9e48c86c9da3d05f66767818277d4177eb0751c1b5906a0cf68299bf2f693e67e935bda825cb5137bf36c35e21a6ad14261994fb801a4e92be58788c97
-  data.tar.gz: 359e5532bf3e557bcbfeaf2d5ac40b767768dbda6af88400b67e8163c38adc27d5fe8e6c3ddd1290685bc1199c006f16225096e2b64c06bfe04a2337f1dbefba
+  metadata.gz: 35046ae1202cd6e65a03d90313cb6dbf2ebecff360f4d1f4183a413b02b7b0da17df223b8066133ea90f3e44d5596dfb9ea2f6834ab981afa73d2165c53f480d
+  data.tar.gz: ab8eb568a6ca00d51c040c2282efdfddb2dc3a29634f706e6b7d9cf96e08f49b069ceddb9c83d11f2582a5fcea9ca2d978674521aa866c9ed14281630c196135

data/403.html

@@ -1,6 +1,6 @@
 ---
 layout: error
 code: "403"
-title: "403 - Access Forbidden / الوصول محظور"
+title: "403 - Access Forbidden"
 permalink: /403.html
 ---

data/404.html

@@ -1,6 +1,6 @@
 ---
 layout: error
 code: "404"
-title: "404 - Page Not Found / الصفحة غير موجودة"
+title: "404 - Page Not Found"
 permalink: /404.html
 ---

data/500.html

@@ -1,6 +1,6 @@
 ---
 layout: error
 code: "500"
-title: "500 - Internal Server Error / خطأ داخلي في الخادم"
+title: "500 - Internal Server Error"
 permalink: /500.html
 ---

data/CHANGELOG.md

@@ -4,6 +4,128 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [1.0.0] - 2026-09-24
+
+### Added
+* Add Feature 4.9, auto-generate CV/profile pages per language ([`8b473b7`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/8b473b731b3c5ecf58576db9b014d389c0ab06e5))
+
+* Add check-data-keys, a static checker for template-vs-data key mismatches ([`f4fcfcd`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/f4fcfcd7f8aaf2fbec08295a8029c0c5cfcfa6fe))
+
+* Add client-side site search blueprint ([`ac7f7ef`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/ac7f7ef20fc3123bf28e79f390416d10ee7bcc5f))
+
+* Add public-domain sherlock holmes avatar image ([`c73945b`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/c73945bbbc283acee174f70435fb3e5a0a8ca993))
+
+* Add locale system reference guides ([`d4ebf9c`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/d4ebf9c236cc26b69c27a4e13588f919b6dfaf16))
+
+* Add locale, parity, and schema test coverage ([`1314632`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/131463239e0bb9446430c7d4f0a2fb0bff034921))
+
+* Add sherlock holmes demo resume in six languages ([`5194795`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/5194795f82c8ab2b0fbae721803efb5e59a9376e))
+
+* Add locale-agnostic resume layout ([`28239ec`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/28239ecb2a4039f91c8be94bf78bac8a92a89a1e))
+
+* Add unified section dispatcher for all locales ([`23cfc0d`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/23cfc0df8c4ee240d9298ee6a3f36dd4e572b99f))
+
+* Add universal date formatter for all six locales ([`1a830bd`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/1a830bd52a44266a0145fb7ece5432f32ac9570e))
+
+* Add native email support to social links ([`064e2e0`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/064e2e0ee7f4d5dac86911ee30becf32562d8aaa))
+
+* Add canonical locale dictionaries for six languages ([`20973be`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/20973be336c3b871f1278e8be655ed0e7e547ab5))
+
+* Add v1.0.0 multilingual implementation plan and align roadmap ([`9b71b02`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/9b71b02312a15dd002f28e899fc6fd315b3cf58c))
+
+
+### Changed
+* Make profile layout multilingual and data-driven ([`87d4c46`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/87d4c4680dfd8510c9dc9add4ef68619e9ed24f7))
+
+* Include base styles in profile page stylesheet ([`193f96b`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/193f96b41ccbc64938f8c54f6096c86fde69201d))
+
+* Bump documented version to v1.0.0, reconcile roadmap ([`1c77680`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/1c77680bca4b648104495860a0481622b6ddbee8))
+
+* Localize error-page search box to the visitor's browser language ([`256dbb3`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/256dbb3a4239d60cb1848f6db53d97e1b15780b2))
+
+* Extract shared grouped-item-list renderer ([`1b5a0a4`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/1b5a0a46d30f3fdc355d24ca05b7dca53d4870f4))
+
+* Bump actions/checkout in the github-actions group ([`0809e9c`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/0809e9cda99a6dd18e1daa3a83cdee1b2da26501))
+
+* Update minitest requirement from ~> 5.25 to ~> 6.0 ([`7fa8a8e`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/7fa8a8e8cc7ad5983394c72346ac3a8b6380b4cc))
+
+* Record PR #220's live CI verification for Feature 3.2 ([`00e8fdf`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/00e8fdffd6ed9f43dd7586ff44bda74104e138af))
+
+* Update agent guidance and roadmap for v1.0.0; retire implementation plan ([`0579aa3`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/0579aa3fb4bb27ad221b6f13430500bfcb3692de))
+
+* Wire build/proof tooling to the locale-driven demo overlay ([`4f27143`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/4f2714381205c1133372aa3f3ec093eed10be0de))
+
+* Import and adapt locale-aware resume data validator ([`834969a`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/834969a7c2e2fb2e263687b81ccf60500b0e4bca))
+
+* Make every remaining EN/AR consumer locale-driven ([`faa5d7e`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/faa5d7e503ac0dfc63fa1cd781430334f61be465))
+
+* Purge deprecated site.avatar, analytics.ga, and resume_dark_mode fallbacks ([`e565de0`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/e565de054705c01cf572893c1ec35470f6f46dc0))
+
+* Align Arabic header contact icons icon-first ([`ed3e655`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/ed3e655c7d6a413c87f5efd164bb06e22346383e))
+
+* Split resume stylesheet into locale-driven LTR/RTL layers ([`807b4e2`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/807b4e240ba83e98fb0b61e3657667ec3b729450))
+
+
+### Fixed
+* Resolve 404 language and Home button from the requested URL ([`8616bb2`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/8616bb201a4246cd2dee0f5b862f39d08f7a635b))
+
+* Require "date" so YAML.safe_load_file's permitted_classes resolves on Ruby 3.3 ([`ad4a1cd`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/ad4a1cde235784d7e9e8c0fbc17741d1b959541a))
+
+* Render single-language error pages via remembered language preference ([`7105376`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/7105376c57763e98c977685c1a96c645bbb84505))
+
+* Tighten URL/section/language checks, require education year ([`86b8212`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/86b82122925fbb8557d0e7e4bb763730605558f6))
+
+* Use locale-driven font variable instead of undefined RTL tokens ([`2a08333`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/2a08333e35e1770adeb256a4844e071f3d360283))
+
+* Fall back to standard contact info when live fields are partial ([`dbd5e00`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/dbd5e001b43ef6688aab7a0d25c883a72d378ee6))
+
+* Declare minitest as a development dependency ([`3b51fd4`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/3b51fd4d2711de4c08ffb5b98e31f1e84a3b345e))
+
+* Use lang_cfg.name for creator microdata ([`83c97d9`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/83c97d9b99974f8860c514840c3b8682ada3c8df))
+
+* Update actions/checkout and action-gh-release versions for compatibility ([`d807bc3`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/d807bc3f36a30e64bad2b2e1ba2169c9990114d2))
+
+
+### Removed
+* Remove non-functional error-page search form ([`73e1ac5`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/73e1ac5515b548a245fd8443078909a265a6dfb3))
+
+## [0.9.0] - 2026-09-21
+
+### Added
+* Add accessible landmark roles, skip-links, and focus styles ([`a29c480`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/a29c48087c3933c9edb71722bbb00ea12e3c9ad4))
+
+
+### Changed
+* Update active feature blueprints, issue mappings, and ignore rules ([`28dd0c3`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/28dd0c317cc869f966731c1732570b7592affb3e))
+
+* Consolidate dynamic data loader into shared include component ([`ef5cc4f`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/ef5cc4fa1e979024a0fbc8efebef5105706aa1df))
+
+* Consolidate profile styles with shared partials and remove redundant forwarder ([`0d1fbd0`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/0d1fbd04b427c4ee334d64558d6275ec64f71e9c))
+
+* Simplify resume section conditions with direct Liquid blank checks ([`c9a6ada`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/c9a6ada2089b9b686d510edfffe0d196dca5f051))
+
+* Clean up legacy mixins, remove IE zoom hacks, and eliminate dead table classes ([`2800d0a`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/2800d0ab1553ee14e59c6eaae441d4de83c5b35f))
+
+* Encapsulate dark mode activation cascade into toggle include ([`405b493`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/405b4933ea0640951fd8a24a21151574bb0ab11a))
+
+* Implement interactive bilingual language switcher ([`c56e50f`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/c56e50fa6f7e64a58ff7930a3bfb4a7275b7e134))
+
+* Apply living-docs framework, add code comments, browser QA verified ([`d1535b9`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/d1535b9f22d79eab1cd7f4078c0db2d86a74f7b6))
+
+* Update release notes for version automation ([`fc9ead1`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/fc9ead129df08b3698264b9da5a07378e1543aa3))
+
+* Preserve bump-only releases in git-cliff template ([`ba334a5`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/ba334a54fa8d63aeea1a72ad646b2bb71ff6f0a7))
+
+* Automate gem publishing and release workflow ([`f4bd096`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/f4bd096ae44bfc42cb14c9635a0e9803e297a0ba))
+
+
+### Fixed
+* Render language header summary on a dedicated line ([`d3352dc`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/d3352dcb6833f8bc48d2d799774757a42325a711))
+
+
+### Removed
+* Remove redundant Gem::Specification monkey-patch ([`a78efd6`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/a78efd68e70c0848f78bb5b25ab51f848c437c1d))
+
 ## [0.8.0] - 2026-09-19
 
 ### Added
@@ -73,8 +195,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.6.1] - 2026-08-21
 
 ### Changed
-* Version bump since v0.6.0 gemspec had incorrect version number and release was pushed to RubyGems incorrectly and it was yanked; re-releasing under v0.6.1.
-
+* Version bump release with no structural code changes.
 ## [0.6.0] - 2026-08-21
 
 ### Added
@@ -229,8 +350,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * Initial commit (New Theme Template) ([`00af662`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/00af6628dfec7aefe0ef7d7083bf98c9713a5ffd))
 
+[1.0.0]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.9.0...v1.0.0
+[0.9.0]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.8.0...v0.9.0
 [0.8.0]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.7.0...v0.8.0
 [0.7.0]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.6.1...v0.7.0
+[0.6.1]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.6.0...v0.6.1
 [0.6.0]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.5.2...v0.6.0
 [0.5.2]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.5.1...v0.5.2
 [0.5.1]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.5.0...v0.5.1

data/README.md

@@ -1,13 +1,13 @@
 # bilingual-jekyll-resume-theme
 
-[![Latest release](https://img.shields.io/github/v/release/kmutahar/bilingual-jekyll-resume-theme?display_name=tag)](https://github.com/kmutahar/bilingual-jekyll-resume-theme/releases) [![Gem Version](https://badge.fury.io/rb/bilingual-jekyll-resume-theme.svg?icon=si%3Arubygems)](https://badge.fury.io/rb/bilingual-jekyll-resume-theme)
+[![CI Test Suite](https://github.com/kmutahar/bilingual-jekyll-resume-theme/actions/workflows/ci.yml/badge.svg)](https://github.com/kmutahar/bilingual-jekyll-resume-theme/actions/workflows/ci.yml) [![Latest release](https://img.shields.io/github/v/release/kmutahar/bilingual-jekyll-resume-theme?display_name=tag)](https://github.com/kmutahar/bilingual-jekyll-resume-theme/releases) [![Gem Version](https://badge.fury.io/rb/bilingual-jekyll-resume-theme.svg?icon=si%3Arubygems)](https://badge.fury.io/rb/bilingual-jekyll-resume-theme)
 
-A flexible Jekyll theme for creating clean, data-driven, bilingual (English & Arabic) resume/CV websites. Created and maintained by Khaldoon Mutahar. See the latest version on the [Releases page](https://github.com/kmutahar/bilingual-jekyll-resume-theme/releases).
+A flexible Jekyll theme for clean, data-driven, multilingual resume/CV websites. Ships English, Arabic, Spanish, French, German, and Urdu; any other language is added from your site alone. Created and maintained by Khaldoon Mutahar. See the latest version on the [Releases page](https://github.com/kmutahar/bilingual-jekyll-resume-theme/releases).
 Inspired by and originally forked from [Joel Glovier’s resume template](https://github.com/jglovier/resume-template/). Joel’s version was a basic English-only theme with limited customization (e.g., no section reordering); this project has since evolved into a fully separate theme authored by Khaldoon.
 
 ## Features
 
-- **Bilingual support**: Separate layouts for English (`resume-en.html`) and Arabic (`resume-ar.html`) with full RTL support and Cairo typography
+- **Multilingual support**: One layout (`resume.html`) renders every language, LTR or RTL, from per-language locale files (`_data/locales/<lang>.yml`) with localized UI strings, month names, and fonts (Cairo for Arabic, Noto Nastaliq Urdu for Urdu)
 - **Dark mode**: System preference detection (`prefers-color-scheme`) with optional interactive toggle, `localStorage` persistence, and zero-FOUC inline script
 - **Data-driven architecture**: All resume content stored in YAML files, supporting multiple data paths and versioning
 - **12 resume sections**: Experience, Education, Certifications, Courses, Volunteering, Projects, Skills, Recognition, Associations, Languages, Links, Interests
@@ -15,15 +15,17 @@ Inspired by and originally forked from [Joel Glovier’s resume template](https:
 - **Modern favicon suite**: High-resolution favicons (Apple touch icon, 32x32, 16x16, webmanifest) with subpath-safe URLs and `_config.yml` override support
 - **Print-friendly**: Optimized for PDF generation and printing with bidirectional text isolation (`dir="ltr"`) for URLs
 - **SEO ready**: Built-in support for multilingual SEO, standardized canonical tags via `jekyll-seo-tag`, sitemaps, and feeds
-- **Arabic month support**: Arabic date formatting included out of the box (`_data/ar/months.yml`)
+- **Data validation**: `validate-resume` CLI and build-time checks for schemas, dates, URLs, and parity across every configured language
 
 ## Quick Start
 
 ### Installation
 
-1. Add to your Jekyll site's `Gemfile`:
+1. Add to your Jekyll site's `Gemfile`, inside `group :jekyll_plugins`. A plain `gem "bilingual-jekyll-resume-theme"` line never requires the theme's `lib/bilingual-jekyll-resume-theme.rb`, so its bundled plugins (the error page generator and build-time validation) silently never run:
 ```ruby
-gem "bilingual-jekyll-resume-theme"
+group :jekyll_plugins do
+  gem "bilingual-jekyll-resume-theme"
+end
 ```
 
 2. Add to your `_config.yml`:
@@ -36,20 +38,20 @@ theme: bilingual-jekyll-resume-theme
 bundle install
 ```
 
+> **Upgrading from v0.9.0?** v1.0.0 removes the `resume-en` / `resume-ar` layouts and every `*_en` / `*_ar` config key with no compatibility aliases. Follow the migration table in the [Multilingual Guide](docs/MULTILINGUAL_GUIDE.md#breaking-changes--migration-v090-to-v100).
+
 ### Basic Setup
 
-1. **Copy sample configuration**: Use `docs/_data/_config.sample.yml` as a starting point for your `_config.yml`
+1. **Copy sample configuration**: Use `docs/_data/_config.sample.yml` as a starting point for your `_config.yml`. Keep a `languages.<lang>` entry for each language you publish and delete the rest.
 
-2. **Copy sample data files**: 
-   - English data: Copy files from `docs/_data/en/` to your `_data/en/` directory (includes `header.yml` for the intro paragraph)
-   - Arabic data: Copy files from `docs/_data/ar/` to your `_data/ar/` directory (includes `header.yml` for the Arabic intro paragraph)
+2. **Copy sample data files**: Copy each language folder you need from `docs/_data/` (`en`, `ar`, `es`, `fr`, `de`, `ur`) to your site's `_data/`. Each holds 13 files, including `header.yml` for the intro paragraph.
 
-3. **Create resume pages**: Create pages using the `resume-en` and `resume-ar` layouts:
+3. **Create resume pages**: One page per language, all using the `resume` layout:
 ```yaml
 ---
-layout: resume-en
-permalink: /resume/en/
+layout: resume
 lang: en
+permalink: /en/cv/
 t_id: resume
 ---
 ```
@@ -68,6 +70,12 @@ This theme is fully documented. Choose the guide that fits your needs:
 ### 📘 [Configuration Guide](docs/CONFIG_GUIDE.md)
 Complete guide to `_config.yml` settings. Learn how to configure sections, contact info, social links, analytics, and more. **Start here for beginners.**
 
+### 🌐 [Multilingual Guide](docs/MULTILINGUAL_GUIDE.md)
+Locale files, adding a language, overriding theme strings and fonts, RTL typography, and the **v0.9.0 to v1.0.0 migration table**.
+
+### ✅ [Validation Guide](docs/VALIDATION_GUIDE.md)
+The `validate-resume` CLI, build-time validation, rules per section, and CI setup.
+
 ### 📊 [Data Structure Guide](docs/DATA_GUIDE.md)
 Detailed documentation of all 12 data file types (experience, education, skills, etc.) with examples. Learn how to structure your YAML files and what fields are required vs optional.
 
@@ -80,17 +88,26 @@ Understanding the theme's include system, how sections render, and how to add ne
 ### 🎨 [SASS/SCSS Guide](docs/SASS_GUIDE.md)
 Complete guide to the theme's styling system, how to customize colors/fonts, and how to override styles without forking the theme.
 
+### 🗺️ [Project Overview](docs/PROJECT_OVERVIEW.md)
+High-level architecture summary, repository conventions, layout hierarchy, and design philosophy.
+
+### 📜 [Completed Historical Audit](docs/COMPLETED_AUDIT.md)
+Permanent engineering record of historical bug fixes, security hardening, and architectural upgrades.
+
 ## Project Structure
 
-```
+```text
 bilingual-jekyll-resume-theme/
-├── _layouts/          # HTML templates (default, resume-en, resume-ar, profile)
-├── _includes/          # Reusable components (sections, headers, analytics)
-├── _sass/             # SCSS stylesheets (RTL support, print styles)
-├── _data/             # Theme data (includes ar/months.yml)
-├── assets/            # CSS, images, favicons
-└── docs/              # Documentation and sample files
-    ├── _data/         # Sample data files (copy to your site's _data/)
+├── _layouts/          # HTML templates (default, resume, profile, error)
+├── _includes/         # Reusable components (section dispatcher, date formatter, avatar, toggles)
+├── _sass/             # SCSS (LTR main styles, RTL overrides, dark mode tokens, print styles)
+├── _plugins/          # Error page generator and build-time resume validator
+├── _data/locales/     # Locale dictionaries: en, ar, es, fr, de, ur
+├── lib/               # Gem entrypoint and validator engine
+├── bin/               # validate-resume CLI
+├── assets/            # CSS entrypoints (cv-ltr, cv-rtl), images, favicons
+└── docs/              # Documentation, demo pages, and sample files
+    ├── _data/         # Sample config and six-language demo data (copy to your site's _data/)
     └── *.md           # Documentation guides
 ```
 
@@ -98,26 +115,26 @@ bilingual-jekyll-resume-theme/
 
 ### Data Paths
 
-**Recommended approach (for beginners):** Use language-specific folders. The theme supports separate data paths for English and Arabic:
+Each language reads its data from the folder named by `languages.<lang>.data_path`:
 ```yaml
-active_resume_path_en: "en"  # Uses _data/en/* (recommended)
-active_resume_path_ar: "ar"  # Uses _data/ar/* (recommended)
+languages:
+  en:
+    data_path: en   # _data/en/*
+  ar:
+    data_path: ar   # _data/ar/*
 ```
 
-This is the recommended approach even if you're only using one language, as it keeps your data organized and makes it easy to add more languages later. **Advanced users:** You can place files directly in `_data/` (root) by setting these to empty strings, but this is not recommended for beginners.
+Use one folder per language even for a single-language site; adding a language later is then one more folder. Dot paths (`"2025-06.v1"`) select nested, versioned datasets, and `""` reads `_data/` itself.
 
-See the [Configuration Guide](docs/CONFIG_GUIDE.md#data-source-active_resume_path_en_ar) for details.
+See the [Configuration Guide](docs/CONFIG_GUIDE.md#3-languages) for every per-language key.
 
 ### Sample Files
 
-The theme includes sample data files in `docs/_data/en/` and `docs/_data/ar/` that you can copy to your site. These files contain:
-- Commented examples for all 12 section types
-- Required vs optional field explanations
-- Multiple examples per section
+`docs/_data/{en,ar,es,fr,de,ur}/` hold a complete Sherlock Holmes demo resume in six languages, covering all 12 section types. Copy the folders you need to your site.
 
-### Arabic Month Support
+### Locales
 
-The theme includes `_data/ar/months.yml` with Arabic month names already configured. You don't need to create this file manually—it's included in the theme.
+Month names, "Present" labels, section titles, fonts, and text direction come from `_data/locales/<lang>.yml`, shipped inside the gem for all six languages. Override single strings or add a new language from your site's own `_data/locales/`; see the [Multilingual Guide](docs/MULTILINGUAL_GUIDE.md).
 
 ## Development
 
@@ -127,17 +144,32 @@ To develop this theme locally:
 # Install dependencies
 bundle install
 
-# Run development server
-bundle exec jekyll serve
+# Serve the six-language demo (sample config + demo overlay pointing data_dir at docs/_data)
+bundle exec jekyll serve --config docs/_data/_config.sample.yml,docs/_data/_config.demo.yml
+
+# Build static output
+bundle exec jekyll build --config docs/_data/_config.sample.yml,docs/_data/_config.demo.yml
+
+# Validate resume data schemas and parity (CLI or Rake)
+./bin/validate-resume docs/_data
+bundle exec rake validate
+
+# Check that the theme's own templates only reference real data keys (CLI or Rake)
+./bin/check-data-keys docs/_data
+bundle exec rake check_data_keys
+
+# Validators, RuboCop, and tests together
+bundle exec rake
 
 # Build the gem
 gem build bilingual-jekyll-resume-theme.gemspec
 ```
 
-For more details, see [WARP.md](WARP.md) or the [Development section](#development) below.
+For more details on resume schema checks, see [VALIDATION_GUIDE.md](docs/VALIDATION_GUIDE.md). Contributor and agent rules are in [AGENTS.md](AGENTS.md).
 
 ## Requirements
 
+- Ruby 3.3+ (standard support on Ruby 3.3, 3.4, 4.0+; Ruby <= 3.2 is EOL)
 - Jekyll 4.4+ (specified in `bilingual-jekyll-resume-theme.gemspec`)
 - Required plugins (automatically included):
   - `jekyll-feed`
@@ -157,8 +189,10 @@ The theme is available as open source under the terms of the [MIT License](LICEN
 
 - 📖 Check the [documentation guides](docs/) for detailed information
 - 🐛 Report issues on [GitHub Issues](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues)
-- 💡 See [project_overview.md](project_overview.md) for a high-level architecture overview
+- 💡 See [PROJECT_OVERVIEW.md](docs/PROJECT_OVERVIEW.md) for a high-level architecture overview
+- 📜 See [COMPLETED_AUDIT.md](docs/COMPLETED_AUDIT.md) for historical remediations and architectural decisions
 
 ---
 
-**Created by Khaldoon Mutahar** | Version 0.4.0 | MIT License
+**Created by Khaldoon Mutahar** | MIT License
+

data/_data/locales/ar.yml

@@ -0,0 +1,87 @@
+direction: "rtl"
+font_family: "'Cairo', sans-serif"
+font_url: "https://fonts.googleapis.com/css2?family=Cairo:wght@300;400;600;700;900&display=swap"
+line_height: 1.6
+ui:
+  home: "الرئيسية"
+  skip_to_content: "الانتقال إلى المحتوى الرئيسي"
+  photo_alt: "الصورة الشخصية"
+  present: "حتى الآن"
+  date_of_birth: "تاريخ الميلاد:"
+  languages: "اللغات:"
+  contact_me: "تواصل معي"
+  cv_button: "السيرة الذاتية"
+  not_looking_for_work: "لستُ باحثاً عن عمل حالياً."
+  social_links: "روابط التواصل"
+  page_last_generated_on: "تم إنشاء هذه الصفحة بتاريخ"
+  cv_last_generated_on: "تم إنشاء هذه السيرة الذاتية بتاريخ"
+  at: "في"
+  credential_id: "معرّف الاعتماد:"
+  list_separator: "، "
+  dark_mode_toggle: "تبديل إلى الوضع الداكن"
+  language_switcher: "محدد اللغة"
+  language_name: "العربية"
+  reload_page: "إعادة تحميل الصفحة"
+  section_titles:
+    experience: "الخبرات العملية"
+    education: "التعليم"
+    certifications: "التراخيص والشهادات"
+    courses: "الدورات"
+    volunteering: "الأعمال التطوعية"
+    projects: "المشاريع"
+    skills: "المهارات"
+    recognitions: "الجوائز والتكريم"
+    associations: "العضويات"
+    interests: "الاهتمامات الخارجية"
+    languages: "اللغات"
+    links: "روابط إضافية"
+  social_labels:
+    email: "البريد الإلكتروني"
+    github: "جيت هاب"
+    twitter: "إكس (تويتر)"
+    medium: "ميديام"
+    dribbble: "دريبل"
+    facebook: "فيسبوك"
+    linkedin: "لينكد إن"
+    instagram: "إنستغرام"
+    website: "الموقع الشخصي"
+    whatsapp: "واتساب"
+    devto: "ديف تو"
+    flickr: "فليكر"
+    pinterest: "بينتيريست"
+    telegram: "تيليجرام"
+    youtube: "يوتيوب"
+error_pages:
+  "404":
+    title: "الصفحة غير موجودة"
+    message: "ربما تمت إزالة الصفحة التي تبحث عنها، أو تم تغيير اسمها، أو أنها غير متوفرة مؤقتاً."
+  "403":
+    title: "الوصول محظور"
+    message: "ليس لديك الصلاحية اللازمة للوصول إلى هذا المورد أو الدليل المطلوب."
+  "500":
+    title: "خطأ داخلي في الخادم"
+    message: "واجه الخادم ظرفاً غير متوقع منعه من إكمال الطلب. يرجى المحاولة مرة أخرى لاحقاً."
+  "503":
+    title: "الخدمة غير متوفرة مؤقتاً"
+    message: "الخادم غير قادر على معالجة الطلب حالياً بسبب الصيانة أو زيادة الحمل."
+  return_link: "العودة إلى السيرة الذاتية"
+  search_label: "البحث في الموقع"
+  search_placeholder: "البحث في الموقع..."
+  search_button: "بحث"
+present_values:
+  - "present"
+  - "حتى الآن"
+  - "حاليًا"
+months:
+  - "يناير"
+  - "فبراير"
+  - "مارس"
+  - "أبريل"
+  - "مايو"
+  - "يونيو"
+  - "يوليو"
+  - "أغسطس"
+  - "سبتمبر"
+  - "أكتوبر"
+  - "نوفمبر"
+  - "ديسمبر"

data/_data/locales/de.yml

@@ -0,0 +1,88 @@
+direction: "ltr"
+font_family: ""
+font_url: ""
+line_height: 1.5
+ui:
+  home: "Startseite"
+  skip_to_content: "Zum Hauptinhalt springen"
+  photo_alt: "Profilfoto"
+  present: "Heute"
+  date_of_birth: "Geburtsdatum:"
+  languages: "Sprachen:"
+  contact_me: "Kontaktieren Sie mich"
+  cv_button: "Lebenslauf"
+  not_looking_for_work: "Ich bin derzeit nicht auf Jobsuche."
+  social_links: "Soziale Links"
+  page_last_generated_on: "Diese Seite wurde zuletzt generiert am"
+  cv_last_generated_on: "Dieser Lebenslauf wurde zuletzt generiert am"
+  at: "um"
+  credential_id: "Zertifikats-ID:"
+  list_separator: ", "
+  dark_mode_toggle: "Zum Dunkelmodus wechseln"
+  language_switcher: "Sprachauswahl"
+  language_name: "Deutsch"
+  reload_page: "Seite neu laden"
+  section_titles:
+    experience: "Berufserfahrung"
+    education: "Ausbildung"
+    certifications: "Lizenzen & Zertifizierungen"
+    courses: "Kurse"
+    volunteering: "Ehrenamt"
+    projects: "Projekte"
+    skills: "Fähigkeiten"
+    recognitions: "Auszeichnungen"
+    associations: "Mitgliedschaften"
+    interests: "Interessen"
+    languages: "Sprachen"
+    links: "Weitere Links"
+  social_labels:
+    email: "E-Mail"
+    github: "GitHub"
+    twitter: "X (Twitter)"
+    medium: "Medium"
+    dribbble: "Dribbble"
+    facebook: "Facebook"
+    linkedin: "LinkedIn"
+    instagram: "Instagram"
+    website: "Webseite"
+    whatsapp: "WhatsApp"
+    devto: "Dev.to"
+    flickr: "Flickr"
+    pinterest: "Pinterest"
+    telegram: "Telegram"
+    youtube: "YouTube"
+error_pages:
+  "404":
+    title: "Seite Nicht Gefunden"
+    message: "Die gesuchte Seite wurde möglicherweise entfernt, umbenannt oder ist vorübergehend nicht verfügbar."
+  "403":
+    title: "Zugriff Verweigert"
+    message: "Sie haben keine Berechtigung, auf die angeforderte Ressource oder das Verzeichnis zuzugreifen."
+  "500":
+    title: "Interner Serverfehler"
+    message: "Der Server hat einen unerwarteten Zustand festgestellt, der die Bearbeitung der Anfrage verhindert hat. Bitte versuchen Sie es später erneut."
+  "503":
+    title: "Dienst Nicht Verfügbar"
+    message: "Der Server kann die Anfrage derzeit aufgrund von Wartungsarbeiten oder Überlastung nicht bearbeiten."
+  return_link: "Zurück zum Lebenslauf"
+  search_label: "Website durchsuchen"
+  search_placeholder: "Website durchsuchen..."
+  search_button: "Suchen"
+present_values:
+  - "present"
+  - "heute"
+  - "aktuell"
+  - "gegenwärtig"
+months:
+  - "Januar"
+  - "Februar"
+  - "März"
+  - "April"
+  - "Mai"
+  - "Juni"
+  - "Juli"
+  - "August"
+  - "September"
+  - "Oktober"
+  - "November"
+  - "Dezember"