jekyll-theme-resume 1.3.0

data/LICENSE.txt

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Joel Glovier
+Copyright (c) 2025 Khaldoon Mutahar
+
+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 NONINFRINGEMENT. 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 IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,184 @@
+# jekyll-theme-resume
+
+[![CI Test Suite](https://github.com/kmutahar/jekyll-theme-resume/actions/workflows/ci.yml/badge.svg)](https://github.com/kmutahar/jekyll-theme-resume/actions/workflows/ci.yml) [![Latest release](https://img.shields.io/github/v/release/kmutahar/jekyll-theme-resume?display_name=tag)](https://github.com/kmutahar/jekyll-theme-resume/releases) [![Gem Version](https://badge.fury.io/rb/jekyll-theme-resume.svg?icon=si%3Arubygems)](https://badge.fury.io/rb/jekyll-theme-resume)
+
+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/jekyll-theme-resume/releases).
+
+**Links:** [RubyGems](https://rubygems.org/gems/jekyll-theme-resume) · [Live demo](https://www.mutahr.me/jekyll-theme-resume) · [Source](https://github.com/kmutahar/jekyll-theme-resume)
+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
+
+- **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
+- **Resume sections**: Experience, Education, Certifications, Courses, Volunteering, Projects, Skills, Recognition, Associations, Languages, Links, Interests, Publications, References
+- **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`. The `:jekyll_plugins` group loads the theme’s bundled generators and validator. Alternatively, explicitly list `jekyll-theme-resume` under `plugins:` in `_config.yml` (as the sample does); a plain Gemfile entry plus `theme:` alone is insufficient:
+```ruby
+group :jekyll_plugins do
+  gem "jekyll-theme-resume"
+end
+```
+
+2. Add to your `_config.yml`:
+```yaml
+theme: jekyll-theme-resume
+```
+
+3. Install dependencies:
+```bash
+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 [migration guide](docs/how-to/migrate-v0.9-to-v1.0.md).
+
+### Next steps
+
+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
+
+The documentation is organized by what you need. Start at the [documentation index](docs/README.md).
+
+| 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) |
+
+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
+
+```text
+jekyll-theme-resume/
+├── _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
+├── _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
+
+### Data Paths
+
+Each language reads its data from the folder named by `languages.<lang>.data_path`:
+```yaml
+languages:
+  en:
+    data_path: en   # _data/en/*
+  ar:
+    data_path: ar   # _data/ar/*
+```
+
+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 reference](docs/reference/config.md#3-languages) for every per-language key.
+
+### Sample Files
+
+`demo/_data/{en,ar,es,fr,de,ur}/` hold a complete Sherlock Holmes demo resume in six languages, covering all section types. Copy the folders you need to your site.
+
+### 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 [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
+# 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
+
+# Check that the theme's own templates only reference real data keys (CLI or Rake)
+./bin/check-data-keys demo/_data
+bundle exec rake check_data_keys
+
+# 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 jekyll-theme-resume.gemspec
+
+# List packaged files (must include locales and bin, exclude tests)
+gem spec jekyll-theme-resume-*.gem files
+rm -f jekyll-theme-resume-*.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 [Validator and build checks](docs/reference/validator-cli.md). Contributor and agent rules are in [AGENTS.md](AGENTS.md).
+
+## Requirements
+
+- 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`
+  - `jekyll-redirect-from`
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](https://www.contributor-covenant.org/) code of conduct.
+
+## License
+
+The theme is available as open source under the terms of the [MIT License](LICENSE.txt).
+
+## Support
+
+- 📖 Check the [Documentation](#documentation) for detailed information
+- 🐛 Report issues on [GitHub Issues](https://github.com/kmutahar/jekyll-theme-resume/issues)
+
+---
+
+**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 `jekyll-theme-resume` 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

@@ -0,0 +1,329 @@
+# ==============================================================================
+# MULTILINGUAL JEKYLL RESUME THEME - MASTER SAMPLE CONFIGURATION
+# ==============================================================================
+# This configuration file contains all supported settings for the theme.
+# Copy this file to your site's root as `_config.yml` and customize it.
+# Working defaults are uncommented. Optional and advanced overrides are commented.
+# ==============================================================================
+
+# ==============================================================================
+# 1. SITE IDENTITY & LOCALIZATION
+# ==============================================================================
+theme: jekyll-theme-resume
+title: "Your Full Name"
+description: >- # Ignore newlines until next key; used for SEO meta descriptions
+  A brief description of your site or professional tagline.
+url: "https://your-domain.com" # Full site URL (protocol + host), e.g. https://example.com
+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)
+
+# 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)
+# ==============================================================================
+# Override these with relative paths in your site repository if you provide custom icons:
+# favicon: "assets/favicon/resume/favicon.ico"
+# apple_touch_icon: "assets/favicon/resume/apple-touch-icon.png"
+# favicon_32: "assets/favicon/resume/favicon-32x32.png"
+# favicon_16: "assets/favicon/resume/favicon-16x16.png"
+
+# ==============================================================================
+# 3. PERSONAL INFORMATION & TITLES (Required)
+# ==============================================================================
+# Name, job title, address, and avatar alt text are per-language in Section 6.5
+# (languages.<lang>.name / .resume_title / .address / .avatar_alt). There is no
+# site-wide name or title key in v1.0.0.
+
+# ==============================================================================
+# 4. PROFILE PICTURE / AVATAR SETTINGS
+# ==============================================================================
+# Master toggle for displaying profile picture in the resume header
+resume_avatar: true
+
+# Custom image source (relative path like 'assets/images/me.jpg' or full URL 'https://example.com/avatar.jpg')
+# Defaults to theme default '/assets/images/Profile-min.jpg' if not specified
+# avatar_url: "assets/images/Profile-min.jpg"
+
+# Accessible alt text falls back to languages.<lang>.avatar_alt (Section 6.5),
+# then languages.<lang>.name, then locale.ui.photo_alt if neither is set.
+
+# Clickable avatar link destination and behavior
+# Set to false to render as a plain standalone <img> without an <a> wrapper
+# avatar_link: "/"                   # Destination URL (default: "/")
+# avatar_link_target: "_self"        # Target attribute: "_self" (recommended) or "_blank"
+
+# ==============================================================================
+# 5. CONTACT INFORMATION (Required: at least email)
+# ==============================================================================
+contact_info:
+  email: "sherlock@example.com"      # Required for contact CTA button
+  phone: "+44 20 7946 0958"          # Optional
+  # Address is per-language: languages.<lang>.address (Section 6.5)
+  # dob: 1990-01-01                  # Optional Date of Birth (YYYY-MM-DD)
+  #
+  # Advanced: alternate contact info used when enable_live: true
+  # email_live: "live@example.com"
+  # phone_live: "+1 555 000 0000"
+
+# ==============================================================================
+# 6. SOCIAL MEDIA LINKS (Optional - only add platforms you actively use)
+# ==============================================================================
+# Supported platforms render interactive SVG icons on page and text in print.
+# `email` renders a native mailto: link with an accessible label (Feature 1.7):
+social_links:
+  email: "you@example.com"
+  github: https://github.com/yourusername
+  linkedin: https://www.linkedin.com/in/yourhandle/
+  twitter: https://twitter.com/yourhandle
+  # telegram: https://t.me/yourhandle
+  # medium: https://medium.com/@yourhandle
+  # website: https://yourwebsite.com
+  # whatsapp: https://wa.me/1234567890
+  # instagram: https://instagram.com/yourhandle
+  # facebook: https://facebook.com/yourhandle
+  # youtube: https://youtube.com/@yourhandle
+  # devto: https://dev.to/yourhandle
+  # dribbble: https://dribbble.com/yourhandle
+  # flickr: https://flickr.com/people/yourhandle
+  # pinterest: https://pinterest.com/yourhandle
+  # mastodon: https://mastodon.social/@yourhandle # Emits <link rel="me"> in default layout
+
+# ==============================================================================
+# 6.5 LANGUAGES (v1.0.0 locale-agnostic `layout: resume`)
+# ==============================================================================
+# Direction and fonts come from _data/locales/<lang>.yml, never from here.
+# Each entry's data_path/url/header_intro/name/resume_title/address/avatar_alt
+# feed the single `_layouts/resume.html` layout for that language.
+#
+# Two more keys are optional and consumed only by `layout: profile` (the
+# bio-link homepage, not the CV):
+#   about      - Free-form bio rendered under the name. Markdown, raw HTML, or
+#                plain text all work (piped through markdownify).
+#   name_html  - Override for the <h1> name markup. Without it, the layout
+#                auto-bolds the last space-separated word (the common
+#                single-surname case). Set this for compound surnames,
+#                particles ("van der Berg"), or hyphenated names where that
+#                guess would bold the wrong part.
+languages:
+  en:
+    data_path: en
+    url: /en/cv/
+    header_intro: true
+    name: "Your Full Name"
+    resume_title: "Your Job Title"
+    address: "Your City, Your Country"
+    avatar_alt: "Your profile photo"
+    # about: >-
+    #   A brief bio for your homepage. Supports **Markdown**, <a href="https://example.com">raw HTML</a>, or plain text.
+    # name_html: "Your <b>Full Name</b>"
+  ar:
+    data_path: ar
+    url: /ar/cv/
+    header_intro: true
+    name: "اسمك الكامل"
+    resume_title: "مسماك الوظيفي"
+    address: "مدينتك، بلدك"
+    avatar_alt: "صورتك الشخصية"
+    # about: >-
+    #   نبذة مختصرة لصفحتك الرئيسية.
+    # name_html: "اسمك <b>الكامل</b>"
+  es:
+    data_path: es
+    url: /es/cv/
+    header_intro: true
+    name: "Tu Nombre Completo"
+    resume_title: "Tu Cargo"
+    address: "Tu Ciudad, Tu País"
+    avatar_alt: "Tu foto de perfil"
+    # about: >-
+    #   Una breve biografía para tu página principal.
+    # name_html: "Tu <b>Nombre Completo</b>"
+  fr:
+    data_path: fr
+    url: /fr/cv/
+    header_intro: true
+    name: "Votre Nom Complet"
+    resume_title: "Votre Poste"
+    address: "Votre Ville, Votre Pays"
+    avatar_alt: "Votre photo de profil"
+    # about: >-
+    #   Une brève biographie pour votre page d'accueil.
+    # name_html: "Votre <b>Nom Complet</b>"
+  de:
+    data_path: de
+    url: /de/cv/
+    header_intro: true
+    name: "Ihr Vollständiger Name"
+    resume_title: "Ihre Berufsbezeichnung"
+    address: "Ihre Stadt, Ihr Land"
+    avatar_alt: "Ihr Profilbild"
+    # about: >-
+    #   Eine kurze Biografie für Ihre Startseite.
+    # name_html: "Ihr <b>Vollständiger Name</b>"
+  ur:
+    data_path: ur
+    url: /ur/cv/
+    header_intro: true
+    name: "آپ کا پورا نام"
+    resume_title: "آپ کا عہدہ"
+    address: "آپ کا شہر، آپ کا ملک"
+    avatar_alt: "آپ کی پروفائل تصویر"
+    # about: >-
+    #   آپ کے ہوم پیج کے لیے ایک مختصر تعارف۔
+    # name_html: "آپ کا <b>پورا نام</b>"
+
+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
+# ==============================================================================
+# Language dropdown (fixed top-left, lists every other configured language)
+resume_language_switcher: true       # Toggle floating language switcher (default: true)
+
+# Header display toggles
+display_header_contact_info: true    # Show contact info row in header
+# Per-language header intro toggle: languages.<lang>.header_intro (Section 6.5)
+
+# Job search status button in header:
+# true  -> Display contact button linked to contact_info.email
+# false -> Display "I'm not looking for work" / "لست متاحاً للعمل حالياً" status pill
+# (omit or remove key entirely to display nothing)
+resume_looking_for_work: true
+
+# Content behavior
+enable_summary: false                # Show detailed summary/description for roles & courses
+enable_live: false                   # Use email_live & phone_live instead of standard contact info
+resume_print_social_links: true      # Render text list of social links in physical and PDF prints
+
+# Build-time resume data validation (warns by default; never fails the build
+# unless validate_resume_strict is also true)
+validate_resume: true
+validate_resume_strict: false
+
+# ==============================================================================
+# 8. RESUME SECTIONS TOGGLE & RENDER ORDER
+# ==============================================================================
+# Section master toggles (true to render, false to hide):
+resume_section:
+  associations: true
+  certifications: true
+  courses: true
+  education: true
+  experience: true
+  interests: false
+  lang_header: true                  # Show compact language chips in header instead of full section
+  languages: false
+  links: false
+  publications: false
+  references: false
+  projects: true
+  recognitions: false
+  skills: false
+  volunteering: true
+
+# Order in which resume sections appear on the page:
+# Only sections set to 'true' in resume_section above will actually render.
+resume_section_order:
+  - experience
+  - education
+  - certifications
+  - courses
+  - volunteering
+  - projects
+  - associations
+  - skills
+  - recognitions
+  - languages
+  - interests
+  - links
+  - publications
+  - references
+
+# ==============================================================================
+# 9. STYLING, FONTS & DARK MODE
+# ==============================================================================
+# Dark Mode Configuration:
+# - "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")
+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/explanation/multilingual-and-rtl-design.md) instead of a site-wide config key.
+
+# Disable font stylesheet loading in the resume layout (including a custom locale font_url)
+# disable_google_fonts: true
+
+# Optional authors metadata
+authors: []
+
+# ==============================================================================
+# 10. ANALYTICS (Optional - configure at most ONE provider)
+# ==============================================================================
+analytics:
+  # Google Tag Manager (recommended - injects head script and noscript body iframe):
+  # gtm: "GTM-XXXXXXX"
+
+  # Google Analytics 4 (injects async gtag.js with measurement ID):
+  # gtag: "G-XXXXXXXXXX"
+
+# ==============================================================================
+# 11. JEKYLL BUILD SETTINGS & PLUGINS
+# ==============================================================================
+# Required plugins (bundled as theme runtime dependencies)
+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
+  # page generators silently never run.
+  - jekyll-theme-resume
+  - jekyll-feed
+  - jekyll-seo-tag
+  - jekyll-sitemap
+  - jekyll-redirect-from
+
+# File processing rules
+include:
+  - _redirects
+  - .well-known/
+  - _pages/
+  - _posts/
+
+exclude:
+  - scratch.md
+  - README.md
+  - Gemfile*
+  - vendor/
+  - node_modules/
+  - "*.gemspec"
+  - netlify.toml
+  - vercel.json
+  - WARP.md
+  - scripts/
+
+# 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

@@ -0,0 +1,85 @@
+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: "روابط إضافية"
+    publications: "المنشورات"
+    references: "التوصيات"
+  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: "الخادم غير قادر على معالجة الطلب حالياً بسبب الصيانة أو زيادة الحمل."
+present_values:
+  - "present"
+  - "حتى الآن"
+  - "حاليًا"
+months:
+  - "يناير"
+  - "فبراير"
+  - "مارس"
+  - "أبريل"
+  - "مايو"
+  - "يونيو"
+  - "يوليو"
+  - "أغسطس"
+  - "سبتمبر"
+  - "أكتوبر"
+  - "نوفمبر"
+  - "ديسمبر"