bilingual-jekyll-resume-theme 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8eb8d16040a681b4a06c1d6eba60b957aee132434d038ce56b53415e74774f9
-  data.tar.gz: e7cb05ea3e65d241cab36fb5734062a13af1931e8cabe736ee749a108bf8655b
+  metadata.gz: 1a68cc1ed280f841cfa0f14e22be9bbd010076876dbf789d46469ee408fd2907
+  data.tar.gz: 9ca8bf08818ba3e53a7e05d3f7efb64e8152a0b46dd0c0423d8ae736719bf2b6
 SHA512:
-  metadata.gz: c13e0bd5ff9f935997e3977abe7e7e8b257ace6499f0fdc098f8955dc1999ffd36103518e5143c9d3357763f511cb9e5448e8fbb8cc41bc9c7be9ee9493cd432
-  data.tar.gz: '0069c903af37bd0e31ffa14ac4e5901d4f5c19d4ae3ffca36d41dd647196f931bd5d87593b65a158fd25017f75704cf7750f4803a6887e6a41665e6ed3ddda3a'
+  metadata.gz: 62aa3ab455d1c96ea8ecd15dd79e9fd4e3de073c84565d8eda4c642e85154ca4f2810638ad4ed5702d076fcdc4505ad471fc62b80f202dbd636a2340d13391c2
+  data.tar.gz: 9d4b20f4f4c5da2ab13331a763763482871dec6f6e95228acf285fe1eca415ac7ed2d84ada251cd65097956a2694148a8ae16555428ab6ca2739912752df367e

data/CHANGELOG.md

@@ -4,6 +4,79 @@ 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.1.0] - 2026-10-01
+
+### Added
+* Add bin/verify to run the Rule 5 suite with a log ([`333b939`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/333b93947c9f7ac20e21a97ce51ecbbec64bb0b0))
+
+* Add security briefs and streamline completed audit log ([`9580a55`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/9580a55411a605d7636227233a97c7d2f38e9822))
+
+* Add end-to-end rendered site, packaging, and error page suites ([`8eb6cb3`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/8eb6cb3526dbfde6587f4d6e00019be72bcb679d))
+
+* Add Feature 3.2 publications & references blueprint ([`8024a8a`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/8024a8aad060fdab0e2f4f0f4b75d5c75d311064))
+
+* Add exporter and generator test suite ([`aa237dd`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/aa237dd65da91894cafe87b7800533c49244ed51))
+
+* Add localized JSON Resume exporter and generator ([`c600361`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/c60036172e9f856d9fe538d8a381bca95bbc2968))
+
+
+### Changed
+* Filter Liquid frozen-string warning from tests, bump demo ([`8f3f5f9`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/8f3f5f98f62c6590c46a4db398c9a48f50af28c2))
+
+* Bump submodule to the docs-path update ([`38ae031`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/38ae031651476f4004ea1475af2000fb8dd855e9))
+
+* Expand four short guides with verified steps and checks ([`9b1f337`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/9b1f337807c2098ef3ba5e43e3fd53052a53bcef))
+
+* Correct stale layout names in stylesheet comments ([`ce7e1c3`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/ce7e1c3a2b1db4f2b60be1c87fd93c3b7be3fb51))
+
+* Restructure documentation into Diataxis (tutorial, how-to, reference, explanation) ([`1348d88`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/1348d88b17e3f6d0397bc881b25003bfa5362d89))
+
+* Record ADR 0001 and exclude docs/adr from the gem ([`59695d5`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/59695d5cb679602bcd06dba37851681c8f4e3d63))
+
+* Restructure AGENTS.md and update README.md ([`9cb2459`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/9cb245966949cc48db63ac4157bbdbaf9013640b))
+
+* Update guides, README, and gemspec metadata for recent architecture ([`0ff18c0`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/0ff18c0dade5fd632d1af8770b6902b355aab56e))
+
+* Enforce canonical keys in data files with alias hints ([`9f43702`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/9f43702da1404277d8ef8994a843590696c8d365))
+
+* Localized JSON Resume export ([`898dce1`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/898dce11a250029c23285964ca6ecbcf26d50552))
+
+* Document the JSON Resume export feature ([`a304320`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/a3043204b51d17547f66e095d7521cae178d8836))
+
+* Wire discovery link and sample config ([`4fb5333`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/4fb53333a6e343877ee4e3c1048480d2ff5bdf37))
+
+* Validate optional JSON Resume enrichment fields ([`591cb9f`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/591cb9fbab4b5613c6a378aa06a0e3530125493c))
+
+* Merge vendor SVG folders and data-drive social links ([`e22afb8`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/e22afb874357c93d66308de38d9ceab1c462ca32))
+
+* Sync repository documentation, guides, and roadmap ([`40425a2`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/40425a2ebddfaa0dcba06748329b99f739f456bc))
+
+* Upgrade Lineicons to v5.1 and consolidate vendor assets ([`794edcb`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/794edcb35f707ac32cc190ce8deb45e6cc0a6867))
+
+* Inline single-caller stylesheet includes ([`4513f29`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/4513f2997f57577358820a1b2b0ba0bf82a0ca90))
+
+* Auto-generate CV and profile pages per language ([`abaf487`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/abaf48779013fa6524d60f1ba8f7bfdf06641168))
+
+* Deduplicate repeated CSS rules and remove dead code ([`a354b62`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/a354b62253aed4637f0e07df4397adaf27ca2ba9))
+
+
+### Fixed
+* Match GitHub host by parsed URL, not substring ([`98c8d83`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/98c8d83f69a408536c41a8de3ea9258bb4a43436))
+
+* Check doc links and anchors; assert docs ship and docs/adr does not ([`0e097d9`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/0e097d9a945b6757f48c26abafef225c485ce5ae))
+
+* Require date to fix CI error on Ruby 3.3 ([`fc7cb6e`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/fc7cb6e595809de402470f393bae7a934c9ca210))
+
+* Improve date formatting, presence checks, and accessible social labels ([`ea7dfeb`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/ea7dfeb40ae4dc8db865d52d39d203ebbbb8a140))
+
+* Match script closing tags with trailing garbage ([`abd4d95`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/abd4d9586183b9a3dc0bdaae2be701ecace07a34))
+
+* Decode HTML entities before stripping tags ([`cae8378`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/cae8378d111b23f38d62406b4c8c58ac2a547864))
+
+* Close CodeQL tag-stripping bypasses in text() ([`365b7f6`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/365b7f655a2adcc825033f5aab92c8c51edbe354))
+
+* Stop packaging dev-only tools and internal audit log ([`4c5f7d8`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/4c5f7d8ba256a0bf16f10e6bde9216fb0b93769e))
+
 ## [1.0.2] - 2026-09-25
 
 ### Changed
@@ -372,6 +445,7 @@ 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.1.0]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v1.0.2...v1.1.0
 [1.0.2]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v1.0.1...v1.0.2
 [1.0.1]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.9.0...v1.0.0

data/README.md

@@ -3,6 +3,8 @@
 [![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 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).
+
+**Links:** [RubyGems](https://rubygems.org/gems/bilingual-jekyll-resume-theme) · [Live demo](https://www.mutahr.me/bilingual-jekyll-resume-theme) · [Source](https://github.com/kmutahar/bilingual-jekyll-resume-theme)
 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
@@ -11,17 +13,19 @@ Inspired by and originally forked from [Joel Glovier’s resume template](https:
 - **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
-- **WCAG 2.1 AA Accessible**: Full screen reader and keyboard accessibility with `.sr-only` labels and declarative aria attributes
+- **Accessibility features**: Semantic landmarks, keyboard navigation, localized skip links, and labelled social controls. See the [Accessibility coverage](docs/reference/accessibility-coverage.md) for coverage and known limitations.
 - **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
+- **JSON Resume Export**: Multilingual builds generate standards-validated JSON Resume files at `/<lang>/resume.json` (on by default; opt out with `json_resume.enabled: false`).
+- **Automatic pages**: Missing CV and profile pages are generated for each configured language; hand-authored pages take precedence.
 - **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`, 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:
+1. Add to your Jekyll site's `Gemfile`, inside `group :jekyll_plugins`. The `:jekyll_plugins` group loads the theme’s bundled generators and validator. Alternatively, explicitly list `bilingual-jekyll-resume-theme` under `plugins:` in `_config.yml` (as the sample does); a plain Gemfile entry plus `theme:` alone is insufficient:
 ```ruby
 group :jekyll_plugins do
   gem "bilingual-jekyll-resume-theme"
@@ -38,61 +42,25 @@ 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 `_config.sample.yml` at the repository root 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**: Copy each language folder you need from `demo/_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**: One page per language, all using the `resume` layout:
-```yaml
----
-layout: resume
-lang: en
-permalink: /en/cv/
-t_id: resume
----
-```
+> **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 [migration guide](docs/how-to/migrate-v0.9-to-v1.0.md).
 
-4. **Run the development server**:
-```bash
-bundle exec jekyll serve
-```
+### Next steps
 
-Visit `http://localhost:4000` to see your resume!
+Follow [Getting Started](docs/tutorials/getting-started.md) for a complete walkthrough from an empty folder to a running two-language resume. The theme generates the CV and profile page for every language you configure (see [the languages table](docs/reference/config.md#3-languages)), and the sample data for six languages lives in `demo/_data/`.
 
 ## Documentation
 
-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.**
+The documentation is organized by what you need. Start at the [documentation index](docs/README.md).
 
-### 🌐 [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**.
+| I want to... | Go to |
+|---|---|
+| Build my first resume site | [Getting Started](docs/tutorials/getting-started.md) (tutorial) |
+| Do one task: add a language, override strings, publish JSON, validate in CI | [How-to guides](docs/README.md#how-to-guides) |
+| Look up a setting, schema, or flag | [Reference](docs/README.md#reference) |
+| Understand why the theme works this way | [Explanation](docs/README.md#explanation) |
+| Contribute or follow the project rules | [AGENTS.md](AGENTS.md) · [Changelog](CHANGELOG.md) |
 
-### ✅ [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.
-
-### 🎨 [Layouts Guide](docs/LAYOUTS_GUIDE.md)
-Deep dive into how layouts work, how data flows through them, and how to create custom layouts. Useful for advanced customization.
-
-### 🧩 [Includes Guide](docs/INCLUDES_GUIDE.md)
-Understanding the theme's include system, how sections render, and how to add new sections or customize existing ones.
-
-### 🎨 [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.
+Most-used reference pages: [Configuration reference](docs/reference/config.md) (**start here** for `_config.yml`), [Data schemas](docs/reference/data-schemas.md), [Locale keys](docs/reference/locale-keys.md), [Validator and build checks](docs/reference/validator-cli.md), [JSON Resume export reference](docs/reference/json-resume-fields.md), and [Accessibility coverage](docs/reference/accessibility-coverage.md).
 
 ## Project Structure
 
@@ -106,9 +74,9 @@ bilingual-jekyll-resume-theme/
 ├── 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
+├── _config.sample.yml # Annotated configuration for consuming sites
+├── demo/              # Separate demo-site submodule, including six-language data
+└── docs/              # Documentation: tutorial, how-to guides, reference, explanation
 ```
 
 ## Key Concepts
@@ -126,7 +94,7 @@ languages:
 
 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#3-languages) for every per-language key.
+See the [Configuration reference](docs/reference/config.md#3-languages) for every per-language key.
 
 ### Sample Files
 
@@ -134,22 +102,28 @@ See the [Configuration Guide](docs/CONFIG_GUIDE.md#3-languages) for every per-la
 
 ### Locales
 
-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).
+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 [Override locale strings](docs/how-to/override-locale-strings.md) and [Add a language](docs/how-to/add-a-language.md).
 
 ## Development
 
 To develop this theme locally:
 
 ```bash
-# Install dependencies
+# Initialize the demo submodule, then install dependencies
+git submodule update --init --recursive
 bundle install
 
 # Serve the six-language demo from the demo submodule
 bundle exec jekyll serve --source demo --destination _site
+# (Or with live reload and incremental builds)
+bundle exec jekyll serve --source demo --destination _site --livereload --incremental
 
 # Build static output
 bundle exec jekyll build --source demo --destination _site
 
+# Clean cached Jekyll build artifacts
+bundle exec jekyll clean
+
 # Validate resume data schemas and parity (CLI or Rake)
 ./bin/validate-resume demo/_data
 bundle exec rake validate
@@ -158,20 +132,35 @@ bundle exec rake validate
 ./bin/check-data-keys demo/_data
 bundle exec rake check_data_keys
 
-# Validators, RuboCop, and tests together
+# Data validator, template key checker, RuboCop, and every test suite
 bundle exec rake
 
+# Verify built HTML (separate from the default Rake task)
+bundle exec rake "proof[_site,demo/_config.yml]"
+
 # Build the gem
 gem build bilingual-jekyll-resume-theme.gemspec
+
+# List packaged files (must include locales and bin, exclude tests)
+gem spec bilingual-jekyll-resume-theme-*.gem files
+rm -f bilingual-jekyll-resume-theme-*.gem
+
+# Dependency Audit
+bundle outdated
+bundle update
+
+# Automated Version Release (updates gemspec, changelog, commits, and tags)
+./bin/release <version>
+./bin/release --bump
 ```
 
-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).
+For more details on resume schema checks, see [Validator and build checks](docs/reference/validator-cli.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):
+- Ruby 3.3+; this repository’s CI matrix tests 3.3, 3.4, and 4.0.
+- Jekyll `~> 4.4` (4.4 or later, below 5.0), as specified in the gemspec.
+- Runtime plugin dependencies (Jekyll loads them automatically when `theme:` is set; the sample config also lists them under `plugins:` to make them explicit):
   - `jekyll-feed`
   - `jekyll-seo-tag`
   - `jekyll-sitemap`
@@ -187,12 +176,9 @@ The theme is available as open source under the terms of the [MIT License](LICEN
 
 ## Support
 
-- 📖 Check the [documentation guides](docs/) for detailed information
+- 📖 Check the [Documentation](#documentation) for detailed information
 - 🐛 Report issues on [GitHub Issues](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues)
-- 💡 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** | MIT License
-

data/SECURITY.md

@@ -0,0 +1,30 @@
+# Security Policy
+
+## Supported Versions
+
+We take the security of our resume theme and the dependencies it delivers to our users seriously. Because this theme is distributed as a RubyGem package used to build static sites, we actively patch vulnerabilities discovered in our runtime plugin requirements.
+
+The following versions of `bilingual-jekyll-resume-theme` currently receive security updates:
+
+| Version | Supported          | Notes                               |
+| ------- | ------------------ | ----------------------------------- |
+| 1.0.x   | :white_check_mark: | Current stable release branch.      |
+| 0.9.x   | :white_check_mark: | Maintenance & security patches.     |
+| < 0.9   | :x:                | Legacy branches; please upgrade.    |
+
+## Our Dependency Monitoring
+
+The checked-in [Dependabot configuration](.github/dependabot.yml) schedules daily Bundler dependency updates and weekly GitHub Actions updates. The repository also contains [Mend configuration](.whitesource) with a `LOW` minimum issue severity. These files describe configuration, not proof that a hosted service is enabled or that all alerts are resolved. No CodeQL workflow is checked in.
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability within this theme or find an unpatched runtime dependency risk, please do not disclose it publicly via GitHub Issues. Instead, report it responsibly through private channels:
+
+1. **Email the Maintainer:** Send a detailed report to **contact@mutahar.me**.
+2. **Include Details:** Please provide a description of the vulnerability, the version affected, and a proof-of-concept or steps to reproduce the issue if possible.
+
+### What to Expect
+
+* **Acknowledgment:** You will receive a response acknowledging your report within 48 hours.
+* **Triage & Status Updates:** We will update you at least once a week while working on a resolution.
+* **Resolution:** If the vulnerability is accepted, a patched release (e.g., a new patch gem version) will be published, and credit will be given to the reporter if desired.

data/_config.sample.yml

@@ -17,9 +17,8 @@ url: "https://your-domain.com" # Full site URL (protocol + host), e.g. https://e
 baseurl: ""                    # Subpath if hosted in a subdirectory (e.g., /resume); keep "" if at root
 timezone: UTC                  # Timezone for date rendering (e.g., UTC, America/New_York, Asia/Riyadh)
 
-# Default site language and text direction (used in default and error layouts)
-# lang: "en"                   # Default: "en"
-# dir: "ltr"                   # Default: "ltr" (use "rtl" for right-to-left base layout)
+# Language comes from page.lang or default_lang (Section 6.5).
+# Direction comes from _data/locales/<lang>.yml; no site-wide lang/dir keys are used.
 
 # ==============================================================================
 # 2. FAVICONS & WEB APP MANIFEST (Optional - defaults to theme bundled assets)
@@ -177,10 +176,16 @@ languages:
 
 default_lang: en                     # Drives hreflang x-default and fallback lookups
 
+# A languages.<lang> entry with no hand-authored CV/profile page gets one auto-generated
+# (CV at languages.<lang>.url, profile at "/" for default_lang or "/<lang>/" otherwise).
+# Set false to require every language to have its own hand-authored page. Override per
+# language with languages.<lang>.auto_generate_pages: true/false.
+resume_auto_generate_pages: true
+
 # ==============================================================================
 # 7. RESUME DISPLAY & BEHAVIOR CONTROLS
 # ==============================================================================
-# Interactive language switcher (floating button, lists every entry in `languages`)
+# Language dropdown (fixed top-left, lists every other configured language)
 resume_language_switcher: true       # Toggle floating language switcher (default: true)
 
 # Header display toggles
@@ -242,8 +247,9 @@ resume_section_order:
 # 9. STYLING, FONTS & DARK MODE
 # ==============================================================================
 # Dark Mode Configuration:
-# - "auto" (default): CSS-only system detection (prefers-color-scheme); zero JS, no toggle button
+# - "auto" (default): system-preference CSS, no toggle button; shared preference script still runs
 # - "enabled" or true: Renders interactive floating toggle button with localStorage persistence
+# - false or "disabled": hides the toggle; does not force the page into light mode
 dark_mode: auto
 
 # Visual theme variant (default: "default")
@@ -251,9 +257,9 @@ resume_theme: default
 
 # To use a self-hosted or alternate CDN font for a locale, override that locale's
 # font_url in your site's own _data/locales/<lang>.yml (see "Overriding Theme
-# Locales" in docs/MULTILINGUAL_GUIDE.md) instead of a site-wide config key.
+# Locales" in docs/explanation/multilingual-and-rtl-design.md) instead of a site-wide config key.
 
-# Disable remote Google Fonts fetching (useful for offline/intranet builds or strict GDPR compliance)
+# Disable font stylesheet loading in the resume layout (including a custom locale font_url)
 # disable_google_fonts: true
 
 # Optional authors metadata
@@ -277,7 +283,7 @@ plugins:
   # Belt-and-suspenders: Jekyll auto-requires gems listed here (site.gems) regardless
   # of Bundler group, guarding against a Gemfile that forgets to put the theme gem in
   # the `:jekyll_plugins` group — without that, the build-time resume validator and
-  # HTTP error page generator silently never run.
+  # page generators silently never run.
   - bilingual-jekyll-resume-theme
   - jekyll-feed
   - jekyll-seo-tag
@@ -305,3 +311,15 @@ exclude:
 
 # Front matter defaults (optional)
 defaults: []
+
+# JSON Resume exports: /<lang>/resume.json and a default-language /resume.json.
+# Details and field mappings: docs/reference/json-resume-fields.md in the theme repository.
+json_resume:
+  enabled: true
+  root_export: true
+  languages: [] # Empty/missing: all configured languages
+  privacy:
+    export_contact_info: true # False removes email, phone, location, WhatsApp from JSON
+# Optional; social_links values remain URL strings.
+# social_usernames:
+#   github: octocat

data/_data/locales/ar.yml

@@ -64,10 +64,6 @@ error_pages:
   "503":
     title: "الخدمة غير متوفرة مؤقتاً"
     message: "الخادم غير قادر على معالجة الطلب حالياً بسبب الصيانة أو زيادة الحمل."
-  return_link: "العودة إلى السيرة الذاتية"
-  search_label: "البحث في الموقع"
-  search_placeholder: "البحث في الموقع..."
-  search_button: "بحث"
 present_values:
   - "present"
   - "حتى الآن"

data/_data/locales/de.yml

@@ -64,10 +64,6 @@ error_pages:
   "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"

data/_data/locales/en.yml

@@ -64,10 +64,6 @@ error_pages:
   "503":
     title: "Service Unavailable"
     message: "The server is currently unable to handle the request due to maintenance or capacity overload."
-  return_link: "Return to resume"
-  search_label: "Search website"
-  search_placeholder: "Search website..."
-  search_button: "Search"
 present_values:
   - "present"
   - "current"

data/_data/locales/es.yml

@@ -64,10 +64,6 @@ error_pages:
   "503":
     title: "Servicio No Disponible"
     message: "El servidor no puede procesar la solicitud actualmente debido a mantenimiento o sobrecarga."
-  return_link: "Volver al currículum"
-  search_label: "Buscar en el sitio"
-  search_placeholder: "Buscar en el sitio..."
-  search_button: "Buscar"
 present_values:
   - "present"
   - "actualidad"

data/_data/locales/fr.yml

@@ -64,10 +64,6 @@ error_pages:
   "503":
     title: "Service Indisponible"
     message: "Le serveur est actuellement incapable de traiter la demande en raison d'une maintenance ou d'une surcharge."
-  return_link: "Retour au CV"
-  search_label: "Rechercher sur le site"
-  search_placeholder: "Rechercher sur le site..."
-  search_button: "Rechercher"
 present_values:
   - "present"
   - "actuel"

data/_data/locales/ur.yml

@@ -64,10 +64,6 @@ error_pages:
   "503":
     title: "سروس عارضی طور پر دستیاب نہیں"
     message: "دیکھ بھال یا زیادہ لوڈ کی وجہ سے سرور فی الحال درخواست پر عمل کرنے سے قاصر ہے۔"
-  return_link: "سی وی پر واپس جائیں"
-  search_label: "ویب سائٹ تلاش کریں"
-  search_placeholder: "ویب سائٹ تلاش کریں..."
-  search_button: "تلاش"
 present_values:
   - "present"
   - "حال"

data/_data/social_networks.yml

@@ -0,0 +1,83 @@
+# Shared network list for _includes/social-links.html and
+# _includes/print-social-links.html: one entry per site.social_links.<key>
+# platform. Order here is the icon/print display order. To add a platform,
+# add its SVG to _includes/vendors/svg-icons/ and an entry here.
+#
+# icon: filename (without .svg) under _includes/vendors/svg-icons/
+# itemprop: schema.org microdata value social-links.html sets on the <a>
+# label: English fallback for the icon's aria-label/title; each locale's
+#        ui.social_labels.<key> wins when present (print labels use it too)
+- key: devto
+  icon: dev
+  itemprop: url
+  label: Dev.to
+
+- key: dribbble
+  icon: dribbble-symbol
+  itemprop: sameAs
+  label: Dribbble
+
+- key: email
+  icon: envelope
+  itemprop: email
+  label: Email
+
+- key: facebook
+  icon: facebook
+  itemprop: sameAs
+  label: Facebook
+
+- key: flickr
+  icon: flickr
+  itemprop: url
+  label: Flickr
+
+- key: github
+  icon: github
+  itemprop: sameAs
+  label: GitHub
+
+- key: instagram
+  icon: instagram
+  itemprop: sameAs
+  label: Instagram
+
+- key: linkedin
+  icon: linkedin
+  itemprop: sameAs
+  label: LinkedIn
+
+- key: medium
+  icon: medium
+  itemprop: url
+  label: Medium
+
+- key: pinterest
+  icon: pinterest
+  itemprop: url
+  label: Pinterest
+
+- key: telegram
+  icon: telegram
+  itemprop: url
+  label: Telegram
+
+- key: twitter
+  icon: x
+  itemprop: sameAs
+  label: X (Twitter)
+
+- key: website
+  icon: globe-1
+  itemprop: url
+  label: Website
+
+- key: whatsapp
+  icon: whatsapp
+  itemprop: url
+  label: WhatsApp
+
+- key: youtube
+  icon: youtube
+  itemprop: url
+  label: YouTube

data/_includes/data-loader.html

@@ -34,7 +34,7 @@ OUTPUT:
 {%- assign data_path = include.path | default: default_lang_cfg.data_path -%}
 {%- assign resume_data = site.data -%}
 
-{%- if data_path != blank -%}
+{%- if data_path.size > 0 -%}
   {%- assign path_parts = data_path | split: '.' -%}
   {%- for part in path_parts -%}
     {%- assign resume_data = resume_data[part] -%}

data/_includes/date-formatter.html

@@ -33,18 +33,31 @@
   {%- if is_present -%}
     {{ locale.ui.present }}
   {%- else -%}
-    {%- assign month_index = include.date | date: "%m" | plus: 0 | minus: 1 -%}
-    {%- assign month_name = locale.months[month_index] -%}
-    {%- assign day = include.date | date: "%-d" -%}
-    {%- assign year = include.date | date: "%Y" -%}
-    {%- if month_name -%}
-      {%- if style == "MDY" -%}
-        {{ month_name }} {{ day }}, {{ year }}
-      {%- else -%}
-        {{ month_name }} {{ year }}
-      {%- endif -%}
-    {%- else -%}
+    {%- comment -%}
+      Split the ISO string ourselves: Liquid's `date` filter reads a bare year (2018) as a
+      Unix timestamp and cannot parse YYYY-MM. YAML Date objects stringify to YYYY-MM-DD.
+      Anything that is not YYYY, YYYY-MM or YYYY-MM-DD is printed verbatim.
+    {%- endcomment -%}
+    {%- assign date_parts = include.date | append: "" | slice: 0, 10 | split: "-" -%}
+    {%- assign year = date_parts[0] -%}
+    {%- assign year_check = year | plus: 0 | append: "" -%}
+    {%- assign month_num = date_parts[1] | plus: 0 -%}
+    {%- assign day = date_parts[2] | plus: 0 -%}
+    {%- assign month_name = nil -%}
+    {%- if date_parts[1].size == 2 and month_num >= 1 and month_num <= 12 -%}
+      {%- assign month_index = month_num | minus: 1 -%}
+      {%- assign month_name = locale.months[month_index] -%}
+    {%- endif -%}
+    {%- if year.size != 4 or year_check != year or date_parts.size > 3 -%}
       {{ include.date }}
+    {%- elsif date_parts.size == 1 -%}
+      {{ year }}
+    {%- elsif month_name == nil -%}
+      {{ include.date }}
+    {%- elsif style == "MDY" and date_parts.size == 3 and day > 0 -%}
+      {{ month_name }} {{ day }}, {{ year }}
+    {%- else -%}
+      {{ month_name }} {{ year }}
     {%- endif -%}
   {%- endif -%}
 {%- endif -%}