bilingual-jekyll-resume-theme 0.4.0 → 0.5.0

data/docs/INCLUDES_GUIDE.md

@@ -52,6 +52,8 @@ In this theme, includes are used for:
 - Social icons
 - Fine-grained rendering of resume sections in English and Arabic
 
+**For beginners:** Includes are like small reusable code snippets. Instead of copying the same HTML code in multiple places, you put it in an include file and reference it. The theme uses includes to organize code into logical pieces (like the header, social links, analytics, etc.).
+
 ---
 
 ## How includes fit into this theme
@@ -79,14 +81,17 @@ Typical include usage inside layouts:
 
 ### Data flow and configuration
 
-The resume layouts compute a `resume_data` object that points to the active data subtree in `_data/`, based on `active_resume_path` configured in your site’s `_config.yml`. This lets you organize multiple datasets (e.g., different roles/versions) and switch without editing templates.
+The resume layouts compute a `resume_data` object that points to the active data subtree in `_data/`, based on `active_resume_path_en` (for English) and `active_resume_path_ar` (for Arabic) configured in your site's `_config.yml`. This lets you organize multiple datasets (e.g., different roles/versions) and switch without editing templates.
 
 Examples:
 - No path (empty or nil): `resume_data == site.data`
-- `active_resume_path: en`: `resume_data == site.data.en`
-- Nested path with dots: `active_resume_path: 2025-06.20250621-PM` → `resume_data == site.data['2025-06']['20250621-PM']`
+- `active_resume_path_en: "en"`: `resume_data == site.data.en` (English layout)
+- `active_resume_path_ar: "ar"`: `resume_data == site.data.ar` (Arabic layout)
+- Nested path with dots: `active_resume_path_en: "2025-06.20250621-PM"` → `resume_data == site.data['2025-06']['20250621-PM']`
+
+Most resume includes read from `resume_data.<section>` (e.g., `experience`, `skills`, `languages`). Feature flags and ordering live in `_config.yml` (see "Dynamic section rendering" below).
 
-Most resume includes read from `resume_data.<section>` (e.g., `experience`, `skills`, `languages`). Feature flags and ordering live in `_config.yml` (see “Dynamic section rendering” below).
+**For beginners:** The `resume_data` object is like a pointer to your data files. **Recommended:** Set `active_resume_path_en: "en"` and `active_resume_path_ar: "ar"` to use language-specific folders. This way, the theme will look for your data in `_data/en/experience.yml`, `_data/en/education.yml`, etc. for English, and `_data/ar/experience.yml`, etc. for Arabic. This keeps your English and Arabic data separate and organized, and is the recommended approach even if you're only using one language.
 
 ---
 
@@ -196,7 +201,9 @@ Usage in templates:
   - `style`: `MDY` → “Month Day, Year”; anything else → “Month Year”
 - Looks up the Arabic month name via `site.data.ar.months[m]`.
 
-Data requirement in your `_data/` (one of these structures):
+Data requirement: The theme includes `_data/ar/months.yml` by default, so you don't need to create this file manually. The months are already defined in the theme.
+
+If you're using a custom data path structure, you can define months in one of these ways:
 ```yaml
 # Option A: _data/ar.yml
 months:
@@ -215,12 +222,14 @@ months:
 ```
 or
 ```yaml
-# Option B: _data/ar/months.yml
+# Option B: _data/ar/months.yml (already included in theme)
 "1": يناير
 "2": فبراير
 # ...
 ```
 
+**Note:** Since the theme already includes `_data/ar/months.yml`, you typically don't need to add this file unless you're using a completely custom data structure.
+
 ---
 
 ### 9) social-links.html
@@ -319,7 +328,7 @@ The layout loops this array and includes the matching block.
 
 Example: Add “publications”.
 
-1) Data: create `_data/publications.yml` (or inside your active subtree) like:
+1) Data: create `_data/en/publications.yml` (or `_data/ar/publications.yml` for Arabic, or inside your active subtree) like:
 ```yaml
 - active: true
   title: Building Scalable Systems
@@ -474,7 +483,7 @@ To add a network not yet supported (e.g., Mastodon):
 - Respect configuration-driven behavior:
   - Feature flags under `resume_section.*`
   - Section order via `resume_section_order`
-  - Data path via `active_resume_path`
+  - Data path via `active_resume_path_en` and `active_resume_path_ar`
 - Localize: if you add a section in EN, consider adding the AR counterpart with translated labels and RTL visual checks.
 - SVG hygiene: strip unnecessary attributes/metadata; keep icons lightweight.
 - Printing: if something is important for PDF/print, add a print-only variant similar to `print-social-links.html`.

data/docs/LAYOUTS_GUIDE.md

@@ -13,7 +13,7 @@ A comprehensive, contributor-friendly overview of `_layouts/` in this theme: wha
   - [resume-en.html](#3-_layoutsresume-enhtml)
   - [resume-ar.html](#4-_layoutsresume-arhtml)
 - [Resume data loading (the `resume_data` object)](#resume-data-loading-the-resume_data-object)
-  - [Configuring `active_resume_path`](#configuring-active_resume_path)
+  - [Configuring `active_resume_path_en` and `active_resume_path_ar`](#configuring-active_resume_path_en-and-active_resume_path_ar)
   - [Dot-path traversal and bracket-notation](#dot-path-traversal-and-bracket-notation)
   - [Examples](#examples)
 - [Rendering flow inside resume layouts](#rendering-flow-inside-resume-layouts)
@@ -33,6 +33,8 @@ A comprehensive, contributor-friendly overview of `_layouts/` in this theme: wha
 
 Layouts wrap pages. A page chooses a layout via its front matter (e.g., `layout: resume-en`). The layout defines the overall HTML structure and where page content or reusable includes appear. This theme ships with specialized layouts for the resume (EN/AR) and a general-purpose base layout.
 
+**For beginners:** If you're new to Jekyll, think of layouts as templates that define the structure of your pages. You create a page file (like `resume-en.md`) and tell it which layout to use. The layout then handles all the HTML structure, styling, and includes the content from your data files.
+
 ---
 
 ## Layout inventory and responsibilities
@@ -88,21 +90,26 @@ Purpose: Arabic (RTL) resume layout. It mirrors `resume-en.html` with language-a
 
 Both resume layouts compute a single variable, `resume_data`, which points to the active subtree under `_data/`. This allows switching datasets without touching templates.
 
-### Configuring `active_resume_path`
+### Configuring `active_resume_path_en` and `active_resume_path_ar`
 
-Set a site-level key in `_config.yml`:
+Set site-level keys in `_config.yml`:
 
 ```yaml
-# Choose which subtree of _data/ to use for the resume
+# Choose which subtree of _data/ to use for each language
 # Examples below in the next section
-active_resume_path: ""
+active_resume_path_en: "en"  # Path for English resume
+active_resume_path_ar: "ar"  # Path for Arabic resume
 ```
 
-- If `active_resume_path` is empty or nil → `resume_data = site.data`
-- If `active_resume_path` is a single key (e.g., `en`) → `resume_data = site.data.en`
-- If `active_resume_path` is a dotted path (e.g., `2025-06.20250621-PM`) → the layout walks down each segment safely
+- If set to a single key (e.g., `"en"`) → `resume_data = site.data.en` (**recommended for beginners**)
+- If set to a dotted path (e.g., `"2025-06.20250621-PM"`) → the layout walks down each segment safely (advanced)
+- If `active_resume_path_en` or `active_resume_path_ar` is empty or nil → `resume_data = site.data` (uses root `_data/`, **advanced users only**)
+
+**Important:** The English layout (`resume-en.html`) reads `site.active_resume_path_en`, and the Arabic layout (`resume-ar.html`) reads `site.active_resume_path_ar`. This allows you to use different data folders for each language.
 
-Note: The layouts read `site.active_resume_path`. If you maintain multiple variants (time-boxed, roles, locales) under `_data/`, this switch lets you pick the current one at build time.
+**Recommended approach (for beginners):** Always use `"en"` and `"ar"` to place files in `_data/en/` and `_data/ar/` folders. 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:** If you maintain multiple variants (time-boxed, roles, locales) under `_data/`, you can use nested paths or root paths, but this is not recommended for beginners.
 
 ### Dot-path traversal and bracket-notation
 
@@ -115,17 +122,23 @@ Implementation highlights inside the layouts:
 ### Examples
 
 ```yaml
-# 1) Use files directly under _data/
-active_resume_path: ""
-# resume_data.experience == site.data.experience
-
-# 2) Use a language subtree
-active_resume_path: en
-# resume_data.experience == site.data.en.experience
-
-# 3) Use nested subtrees for versioning
-active_resume_path: 2025-06.20250621-PM
+# 1) Recommended: Use language subtrees (recommended for beginners)
+active_resume_path_en: "en"
+active_resume_path_ar: "ar"
+# EN: resume_data.experience == site.data.en.experience
+# AR: resume_data.experience == site.data.ar.experience
+# This is the recommended approach even if you're only using one language
+
+# 2) Advanced: Use nested subtrees for versioning
+active_resume_path_en: "2025-06.20250621-PM"
+active_resume_path_ar: "2025-06.20250621-PM"
 # resume_data.experience == site.data['2025-06']['20250621-PM'].experience
+
+# 3) Advanced: Use files directly under _data/ (not recommended for beginners)
+active_resume_path_en: ""
+active_resume_path_ar: ""
+# resume_data.experience == site.data.experience
+# Only use this if you place files directly in _data/ root (advanced users only)
 ```
 
 ---
@@ -146,7 +159,7 @@ active_resume_path: 2025-06.20250621-PM
   - Small inline icons are included from `vendors/lineicons-v4.0/`
 - Title bar with `site.resume_title` (or `resume_title_ar` for AR)
 - Social icon list when `site.social_links` is configured (see `_includes/social-links.html`)
-- Executive summary from `site.resume_header_intro`
+- Executive summary (controlled by `resume_header_intro_en`/`resume_header_intro_ar` flags, reads from `resume_data.header.intro`)
 - CTA button controlled by `site.resume_looking_for_work`
 
 ### 3) Dynamic section rendering
@@ -180,7 +193,8 @@ name:
   last: "Last"
 resume_title: "Job Title"
 resume_title_ar: "المسمّى الوظيفي"
-resume_header_intro: "Short executive summary paragraph."
+resume_header_intro_en: true  # Enable English intro (reads from resume_data.header.intro)
+resume_header_intro_ar: true  # Enable Arabic intro (reads from resume_data.header.intro)
 resume_avatar: true
 
 # Header contact toggles
@@ -236,8 +250,9 @@ resume_section_order:
 # Print behavior
 resume_print_social_links: true
 
-# Active data subtree for resume_data
-active_resume_path: ""
+# Active data subtree for resume_data (separate for each language)
+active_resume_path_en: "en"
+active_resume_path_ar: "ar"
 ```
 
 Per-page front matter (for multilingual SEO):
@@ -304,8 +319,8 @@ Tip: Keep date formatting and “present” text consistent with the target lang
 ## Common pitfalls and troubleshooting
 
 - Sections not rendering? Check `resume_section_order`, `resume_section.<name>` flags, and `active: true` on data items.
-- Wrong data showing? Confirm `active_resume_path` and your `_data/` structure.
-- Arabic months not displayed? Ensure `site.data.ar.months` is defined (see includes guide: `ar-date.html`).
+- Wrong data showing? Confirm `active_resume_path_en`/`active_resume_path_ar` and your `_data/` structure.
+- Arabic months not displayed? The theme includes `_data/ar/months.yml` by default. If you're using a custom data path, ensure `site.data.ar.months` is accessible (see includes guide: `ar-date.html`).
 - Icons missing? Verify the SVG exists under `/_includes/vendors/lineicons-*/` and the include path is correct.
 - SEO alternates missing? Ensure both pages share the same `t_id`, and each has a `lang` value.
 

data/docs/PROJECT_OVERVIEW.md

@@ -0,0 +1,69 @@
+## Project overview
+
+**bilingual-jekyll-resume-theme** is a Jekyll theme for creating bilingual (English & Arabic) resumes. Created by Khaldoon Mutahar.
+
+## Features
+
+1. Bilingual support
+   - Separate layouts for English (`_layouts/resume-en.html`) and Arabic (`_layouts/resume-ar.html`)
+   - RTL support for Arabic (SCSS in `_sass/_resume-rtl.scss`)
+   - Arabic date formatting via `_includes/ar-date.html` (uses `_data/ar/months.yml`)
+   - Separate name fields objects: `site.name.{first,middle,last}` and `site.name_ar.{first,middle,last}`
+   - Optional language chips in header via `resume_section.lang_header`
+
+2. Data-driven architecture
+   - Resume content in YAML files in `_data/`
+   - Supports nested data folders (e.g., `_data/en/`, `_data/ar/`, or versioned/custom paths)
+   - Dynamic data loader (in both layouts) resolves dot-separated paths using bracket notation, e.g., `"2025-06.20250621-PM"`
+   - Configurable data paths via `_config.yml` keys `active_resume_path_en` and `active_resume_path_ar`
+
+3. Resume sections (13 types)
+   - Experience, Education, Certifications, Courses, Volunteering, Projects, Skills, Recognition, Associations, Languages, Links, Interests, Header (Executive Summary)
+   - Ordering via `resume_section_order` and toggles via `resume_section.*` in `_config.yml`
+   - Active/inactive flags per entry across all sections
+
+4. Design and UX
+   - Print-friendly styling (print-only/no-print classes); optional print-only social links block
+   - Social links integration via `_includes/social-links.html` (GitHub, LinkedIn, X, YouTube, etc.)
+   - SVG icon set via Lineicons (bundled in `_includes/vendors/lineicons-*`)
+   - Profile avatar support
+   - Header contact info toggle (`display_header_contact_info`)
+   - Live vs print contact info (`enable_live`) for phone/email variants
+   - "Looking for work" contact button
+   - Languages can appear in header or separate section
+
+5. Technical features
+   - Jekyll 4.4+ compatibility
+   - SEO via `jekyll-seo-tag`; alternate language links via `_includes/hreflang.html`
+   - Analytics hooks in head/body includes (Google Tag Manager/GA4 supported)
+   - Sitemap and feed generation (`jekyll-sitemap`, `jekyll-feed`), redirects via `jekyll-redirect-from`
+   - Schema.org markup for `Person` and various sections
+
+## Project structure
+
+- `_layouts/`: HTML templates (`default.html`, `resume-en.html`, `resume-ar.html`, `profile.html`)
+- `_includes/`: Reusable components (sections, headers, social links, analytics, `hreflang.html`, SVG vendors)
+- `_sass/`: SCSS stylesheets (base, layout, resume, RTL, print)
+- `_data/`: Theme data files (Arabic month names in `ar/months.yml`)
+- `assets/`: CSS, images, favicons
+- `docs/`: Documentation (config, data, includes, layouts, SASS guides) and sample `_data/` content
+
+## Notable implementation details
+
+1. Dynamic data loading: In both `resume-en.html` and `resume-ar.html`, Liquid bracket notation iterates over a dot-separated path to resolve nested data objects (handles numeric or hyphenated keys like `"2025-06"`).
+2. Conditional rendering: Sections render from `resume_section_order` and respect per-section toggles and data availability; optional header intro blocks (`resume_header_intro_en`/`_ar`).
+3. Date formatting: Arabic dates via `_includes/ar-date.html` with month name lookup from `_data/ar/months.yml`.
+4. Print behavior: Print-only URL echoes for links and optional print-only social links block.
+
+## Documentation
+
+Includes guides for:
+- Configuration (`docs/CONFIG_GUIDE.md`)
+- Data structure (`docs/DATA_GUIDE.md`)
+- Includes (`docs/INCLUDES_GUIDE.md`)
+- Layouts (`docs/LAYOUTS_GUIDE.md`)
+- SASS (`docs/SASS_GUIDE.md`)
+
+Sample data is provided under `docs/_data/en/` and `docs/_data/ar/` and a sample `_config` at `docs/_data/_config.sample.yml`.
+
+The theme is production-ready and well-documented for creating bilingual resumes with Jekyll.

data/docs/SASS_GUIDE.md

@@ -1,6 +1,8 @@
 # SCSS/SASS Guide (_sass)
 
-A contributor- and user-friendly tour of the theme’s styling system: how styles are organized, how entrypoints compile, what each partial does, and safe ways to customize or extend.
+A contributor- and user-friendly tour of the theme's styling system: how styles are organized, how entrypoints compile, what each partial does, and safe ways to customize or extend.
+
+**For beginners:** This guide explains how the theme's CSS/SCSS works. If you're new to CSS or just want to change colors/fonts, start with the [Customization recipes](#customization-recipes) section. You can override styles without modifying the theme files directly.
 
 ---
 

data/docs/_data/ar/associations.yml

@@ -0,0 +1,27 @@
+# العضويات
+# الملف: _data/ar/associations.yml
+# المنظمات أو المجموعات المهنية أو العضويات
+
+# كل إدخال يمثل عضوية أو جمعية
+- organization: ""  # مطلوب: اسم المنظمة
+  active: true      # مطلوب: اضبط على false لإخفاء هذا الإدخال
+  role: ""          # مطلوب: دورك/منصبك في المنظمة
+  year: ""          # مطلوب: الفترة الزمنية (كنص عرض، مثلاً "2020 — الحاضر" أو "يوليو 2022 — الحاضر")
+  url: ""           # اختياري: رابط المنظمة (اتركه فارغاً إذا لم يكن هناك رابط)
+  summary: ""       # اختياري: وصف لانخراطك
+
+# مثال مع رابط
+- organization: ""
+  active: true
+  role: ""
+  year: ""
+  url: "https://example.com"
+  summary: ""
+
+# مثال بدون رابط
+- organization: ""
+  active: true
+  role: ""
+  year: ""
+  url: ""
+  summary: ""

data/docs/_data/ar/certifications.yml

@@ -0,0 +1,73 @@
+# الشهادات والتراخيص
+# الملف: _data/ar/certifications.yml
+# الشهادات والتراخيص المهنية
+
+# كل إدخال يمثل شهادة أو ترخيص
+- name: ""                    # مطلوب: اسم الشهادة
+  active: true                # مطلوب: اضبط على true للعرض في السيرة الذاتية، false للإخفاء
+  issuing_organization: ""    # مطلوب: المنظمة التي أصدرت الشهادة
+  credential_id: ""          # اختياري: رقم اعتماد/شهادة (اتركه فارغاً إذا لم يكن هناك)
+  credential_url: ""          # اختياري: رابط للتحقق من الاعتماد (اتركه فارغاً إذا لم يكن هناك)
+  issue_date:                 # مطلوب: تاريخ الإصدار (تنسيق YYYY-MM-DD، مثلاً 2024-03-15)
+  expiration:                 # اختياري: تاريخ الانتهاء (تنسيق YYYY-MM-DD، اتركه فارغاً إذا لم يكن هناك تاريخ انتهاء)
+  courses:                    # اختياري: للاستخدام الداخلي فقط - لا يتم عرضه في السيرة الذاتية
+                              # هذه الدورات المتداخلة هي للاحتفاظ بالسجلات الشخصية فقط
+                              # تربط الدورات بشهادتها الأصلية ولكن لا يتم عرضها أبداً
+    - name: ""               # اسم الدورة (للسجلات الشخصية فقط)
+      active: false           # حالة النشاط (للسجلات الشخصية فقط)
+      issuing_organization: "" # المنظمة (للسجلات الشخصية فقط)
+      credential_id: ""       # رقم الاعتماد (للسجلات الشخصية فقط)
+      credential_url: ""      # رابط الاعتماد (للسجلات الشخصية فقط)
+      issue_date:             # تاريخ الإصدار (تنسيق YYYY-MM-DD، للسجلات الشخصية فقط)
+      expiration:             # تاريخ الانتهاء (تنسيق YYYY-MM-DD، اتركه فارغاً إذا لم يكن هناك، للسجلات الشخصية فقط)
+
+# مثال مع رقم اعتماد ورابط
+- name: ""
+  active: true
+  issuing_organization: ""
+  credential_id: ""
+  credential_url: "https://example.com/cert/123"
+  issue_date:
+  expiration:
+  courses:
+    - name: ""
+      active: false
+      issuing_organization: ""
+      credential_id: ""
+      credential_url: ""
+      issue_date:
+      expiration:
+
+# مثال مع رقم اعتماد بدون رابط
+- name: ""
+  active: true
+  issuing_organization: ""
+  credential_id: ""
+  credential_url: ""
+  issue_date:
+  expiration:
+  courses:
+    - name: ""
+      active: false
+      issuing_organization: ""
+      credential_id: ""
+      credential_url: ""
+      issue_date:
+      expiration:
+
+# مثال بدون تاريخ انتهاء
+- name: ""
+  active: true
+  issuing_organization: ""
+  credential_id: ""
+  credential_url: ""
+  issue_date:
+  expiration:
+  courses:
+    - name: ""
+      active: false
+      issuing_organization: ""
+      credential_id: ""
+      credential_url: ""
+      issue_date:
+      expiration:

data/docs/_data/ar/courses.yml

@@ -0,0 +1,39 @@
+# الدورات
+# الملف: _data/ar/courses.yml
+# دورات تدريبية وورش عمل أو برامج تعليمية
+
+# كل إدخال يمثل دورة أو برنامج تدريبي
+- name: ""                    # مطلوب: اسم الدورة
+  active: true                # مطلوب: اضبط على false لإخفاء هذا الإدخال
+  issuing_organization: ""    # مطلوب: المنظمة المقدمة للدورة
+  credential_id: ""          # اختياري: رقم اعتماد/شهادة (اتركه فارغاً إذا لم يكن هناك)
+  credential_url: ""          # اختياري: رابط للتحقق من الاعتماد (اتركه فارغاً إذا لم يكن هناك)
+  startdate:                  # مطلوب: تاريخ بداية الدورة (تنسيق YYYY-MM-DD، مثلاً 2024-09-01)
+  enddate:                    # اختياري: تاريخ نهاية الدورة (تنسيق YYYY-MM-DD، اتركه فارغاً إذا كانت مستمرة)
+  expiration:                 # اختياري: تاريخ انتهاء الاعتماد (تنسيق YYYY-MM-DD، اتركه فارغاً إذا لم يكن هناك)
+  notes: ""                   # اختياري: ملاحظات شخصية (لا يتم عرضها في السيرة الذاتية)
+  summary: ""                 # اختياري: وصف الدورة (يُعرض فقط إذا كان enable_summary صحيحاً في _config.yml)
+
+# مثال مع اعتماد
+- name: ""
+  active: true
+  issuing_organization: ""
+  credential_id: ""
+  credential_url: "https://example.com/verify/certificate"
+  startdate:
+  enddate:
+  expiration:
+  notes: ""
+  summary: ""
+
+# مثال بدون اعتماد
+- name: ""
+  active: true
+  issuing_organization: ""
+  credential_id: ""
+  credential_url: ""
+  startdate:
+  enddate:
+  expiration:
+  notes: ""
+  summary: ""

data/docs/_data/ar/education.yml

@@ -0,0 +1,49 @@
+# التعليم
+# الملف: _data/ar/education.yml
+# الشهادات الأكاديمية والخلفية التعليمية
+
+# كل إدخال يمثل درجة أو برنامج تعليمي
+- degree: ""          # مطلوب: اسم الدرجة والتفاصيل (مثلاً "بكالوريوس العلوم في علوم الحاسب")
+  active: true        # مطلوب: اضبط على false لإخفاء هذا الإدخال
+  uni: ""             # مطلوب: اسم الجامعة/المؤسسة
+  year: ""            # مطلوب: الفترة الزمنية (كنص عرض، مثلاً "سبتمبر 2020 — يونيو 2024" أو "2015 — 2019")
+  location: ""        # مطلوب: موقع المؤسسة (مثلاً "المدينة، الولاية" أو "المدينة، الدولة")
+  awards:             # اختياري: قائمة الجوائز/الأوسمة المستلمة (استخدم هذا أو حقل الجائزة الواحدة أدناه)
+    - award: ""       # جائزة أو وسام (يمكن إضافة عناصر متعددة)
+  award: ""           # اختياري: جائزة واحدة (بديل لقائمة الجوائز أعلاه، مثلاً "تخرجت بمرتبة الشرف")
+                      # ملاحظة: يمكنك استخدام 'awards' (قائمة) أو 'award' (نص واحد)، أو كليهما
+  summary: ""         # اختياري: وصف إضافي أو تفاصيل عن تعليمك
+
+# مثال مع قائمة جوائز
+- degree: ""
+  active: true
+  uni: ""
+  year: ""
+  location: ""
+  awards:
+    - award: ""
+    - award: ""
+  award: ""
+  summary: ""
+
+# مثال مع حقل جائزة واحد
+- degree: ""
+  active: true
+  uni: ""
+  year: ""
+  location: ""
+  awards:
+    - award: ""
+  award: ""
+  summary: ""
+
+# مثال بسيط (بدون جوائز أو ملخص)
+- degree: ""
+  active: true
+  uni: ""
+  year: ""
+  location: ""
+  awards:
+    - award: ""
+  award: ""
+  summary: ""

data/docs/_data/ar/experience.yml

@@ -0,0 +1,50 @@
+# الخبرات العملية
+# الملف: _data/ar/experience.yml
+# الخبرة المهنية وسجل التوظيف
+
+# الوظائف مجمعة حسب اسم الشركة. الأدوار المتعددة في نفس الشركة ستظهر معاً.
+# الأدوار مرتبة حسب تاريخ البدء (الأحدث أولاً).
+
+# الخيار 1: استخدام startdate و enddate (موصى به للتوظيف المستمر)
+# كل إدخال يمثل دور/منصب
+- company: ""         # مطلوب: اسم الشركة/المنظمة
+  position: ""        # مطلوب: المسمى الوظيفي/المنصب
+  startdate:          # مطلوب: تاريخ البدء (تنسيق YYYY-MM-DD، مثلاً 2018-05-01)
+  enddate:            # اختياري: تاريخ الانتهاء (تنسيق YYYY-MM-DD) أو "Present" للأدوار الحالية
+  location: ""        # اختياري: موقع العمل (مثلاً "المدينة، الولاية" أو "عن بعد")
+  active: true        # مطلوب: اضبط على false لإخفاء هذا الإدخال
+  notes: ""           # اختياري: ملاحظات شخصية (لا يتم عرضها في السيرة الذاتية)
+  summary: ""         # اختياري: وصف الوظيفة (يُعرض فقط إذا كان enable_summary صحيحاً في _config.yml)
+
+# مثال منصب حالي
+- company: ""
+  position: ""
+  startdate:
+  enddate: Present    # استخدم "Present" للمناصب المستمرة
+  location: ""
+  active: true
+  notes: ""
+  summary: ""
+
+# الخيار 2: استخدام durations (بديل لفترات غير مستمرة في نفس الشركة)
+# استخدم هذا بدلاً من startdate/enddate عندما يكون لديك فترات زمنية منفصلة متعددة
+- company: ""
+  position: ""
+  durations:          # بديل: استخدم هذا بدلاً من startdate/enddate للفترات غير المستمرة
+    - duration: ""    # نص العرض للفترة الأولى (مثلاً "يونيو 2020 — يناير 2021")
+    - duration: ""    # نص العرض للفترة الثانية (مثلاً "& يونيو 2022 — ديسمبر 2022")
+                      # استخدم & للرمز (&) و — للشرطة الطويلة (—)
+  location: ""
+  active: true
+  notes: ""
+  summary: ""
+
+# مثال مع أدوار متعددة في نفس الشركة (ستكون مجمعة معاً)
+- company: ""
+  position: ""
+  startdate:
+  enddate:
+  location: ""
+  active: true
+  notes: ""
+  summary: ""

data/docs/_data/ar/header.yml

@@ -0,0 +1,6 @@
+# Header intro paragraph
+# This file contains the executive summary/intro paragraph that appears below your name and title
+# Enable this in _config.yml with: resume_header_intro_ar: true
+
+intro: "ملخصك المهني أو نبذتك المختصرة هنا. هذه هي النسخة العربية."
+

data/docs/_data/ar/interests.yml

@@ -0,0 +1,13 @@
+# الاهتمامات
+# الملف: _data/ar/interests.yml
+# الاهتمامات الشخصية والهوايات
+
+# قائمة بسيطة من الاهتمامات والهوايات
+# ملاحظة: لا يوجد مفتاح نشط/غير نشط - إذا كان في الملف، سيظهر
+# كل إدخال يمثل اهتمام واحد
+
+- description: ""  # مطلوب: وصف الاهتمام
+
+- description: ""
+
+- description: ""

data/docs/_data/ar/languages.yml

@@ -0,0 +1,29 @@
+# اللغات
+# الملف: _data/ar/languages.yml
+# مستويات إتقان اللغات
+
+# قسم اللغات يظهر في جدول من عمودين
+# إذا تم تفعيل lang_header في _config.yml، تظهر اللغات في رأس الصفحة بدلاً من ذلك
+# كل إدخال يمثل إتقان لغة
+
+- language: ""         # مطلوب: اسم اللغة (مثلاً "الإنجليزية"، "العربية"، "الإسبانية")
+  active: true         # مطلوب: اضبط على false لإخفاء هذا الإدخال
+  description: ""      # مطلوب: وصف الإتقان الكامل (مثلاً "إتقان كلغة أم"، "إتقان مهني")
+  descrp_short: ""     # مطلوب: النموذج القصير للعرض في الرأس (مثلاً "لغة أم"، "مهني"، "محدود"، "ابتدائي")
+
+# مستويات الإتقان المقترحة:
+# - لغة أم / ثنائي اللغة
+# - إتقان مهني
+# - إتقان محدود
+# - إتقان ابتدائي
+
+# أمثلة إدخالات
+- language: ""
+  active: true
+  description: ""
+  descrp_short: ""
+
+- language: ""
+  active: true
+  description: ""
+  descrp_short: ""

data/docs/_data/ar/links.yml

@@ -0,0 +1,17 @@
+# الروابط
+# الملف: _data/ar/links.yml
+# روابط إضافية (معرض أعمال، مدونة، GitHub، إلخ)
+
+# كل إدخال يمثل رابط
+- description: ""  # مطلوب: وصف/عنوان الرابط (مثلاً "المعرض الشخصي"، "ملف GitHub"، "مدونة شخصية")
+  active: true      # مطلوب: اضبط على false لإخفاء هذا الرابط
+  url: ""           # مطلوب: الرابط (مثلاً "https://github.com/username" أو "https://example.com")
+
+# أمثلة إدخالات
+- description: ""
+  active: true
+  url: ""
+
+- description: ""
+  active: true
+  url: ""

data/docs/_data/ar/projects.yml

@@ -0,0 +1,28 @@
+# المشاريع
+# الملف: _data/ar/projects.yml
+# مشاريع شخصية أو مهنية
+
+# كل إدخال يمثل مشروع
+- project: ""        # مطلوب: اسم المشروع
+  active: true       # مطلوب: اضبط على false لإخفاء هذا الإدخال
+  role: ""           # مطلوب: دورك في المشروع (مثلاً "مطور رئيسي"، "قائد فريق"، "مشرف")
+  duration: ""       # مطلوب: الفترة الزمنية (كنص عرض، مثلاً "مايو 2021 — الحاضر" أو "يناير 2023 — يونيو 2024")
+                     # استخدم — للشرطة الطويلة (—)
+  url: ""            # اختياري: رابط المشروع (اتركه فارغاً إذا لم يكن هناك رابط، مثلاً مستودع GitHub أو موقع المشروع)
+  description: ""    # مطلوب: وصف المشروع
+
+# مثال مع رابط
+- project: ""
+  active: true
+  role: ""
+  duration: ""
+  url: "https://github.com/username/project"
+  description: ""
+
+# مثال بدون رابط
+- project: ""
+  active: true
+  role: ""
+  duration: ""
+  url: ""
+  description: ""