jekyll-theme-resume 1.3.0 → 1.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e076d6b78d7877746a77bdc4a8d059ae08cb2e7bdd377152ab4567b32a2ed78
-  data.tar.gz: 8e9ea90a8e10b66755160e3e39475489c9965a4a47f2aa73446db9eb8c2b294c
+  metadata.gz: f52cbf7a52fc458e7c41a07de7dbf3a48a397c8f6e78456e507afe7cc2882df6
+  data.tar.gz: df0da124295d8a02e85189962387c5b908a40632a4a23fc7739cc86de9a1f6b1
 SHA512:
-  metadata.gz: b569cdd97368ba6b59c593cde172b12fc828082291bc8920ca7acfe4459e086e39f334c51f4692c38a4173162d6266a27483342ebd0f4f4435b63f0da39d225f
-  data.tar.gz: a341f452fce3e1c298b7f3b106a35d1d1b46a6979795dc9ded191e6e9cb5521df4deb198498520b8ac2c1c1b5a4636416089a5a1227bb4e177cb9a2db70b056c
+  metadata.gz: 3303c1b21f23fb2e08a0aaf1932219a11ab1f254da4d15a4d4f205cb7087bdfbf8c3069b9de52af22c1365db9be597448a97e99be16f9a2e536dad9a5bd69394
+  data.tar.gz: 83565e16549fb42737512e3efbb18fba991603f07b7ddbc79b40e055511d2aac6b22ebf575b17d0255c826a98a0f41a2b4b310019c54afc90b99f5a8a38d1f02

data/CHANGELOG.md

@@ -4,6 +4,50 @@ 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.3.2] - 2026-10-26
+
+### Added
+* Add initial trail setup and documentation for coding sessions ([`907835b`](https://github.com/kmutahar/jekyll-theme-resume/commit/907835b55da7d4f0f84f0028f22e6868e5458186))
+
+* Add Windows and JRuby gems to the sample Gemfile ([`ec1223d`](https://github.com/kmutahar/jekyll-theme-resume/commit/ec1223da04393f4abc5dd5673b978044deede65c))
+
+* Add Discord and Behance icons ([`49ede2c`](https://github.com/kmutahar/jekyll-theme-resume/commit/49ede2c9e0eea0fe0edf2440d11e1f11e52bc34a))
+
+
+### Changed
+* Update trail learnings ([`05dfe16`](https://github.com/kmutahar/jekyll-theme-resume/commit/05dfe164f2760e936773d43ee7a82e41d3c8f790))
+
+* Retire SEC-04 ([`aea06d8`](https://github.com/kmutahar/jekyll-theme-resume/commit/aea06d8ef42716613ad9959445130da1c46fb030))
+
+* Link every feature to a GitHub issue and trim shipped social platforms ([`3aca714`](https://github.com/kmutahar/jekyll-theme-resume/commit/3aca7141e89864973cbd504dfec0539f0fa9b222))
+
+* Emit JSON-LD ProfilePage/Person structured data ([`5f7a989`](https://github.com/kmutahar/jekyll-theme-resume/commit/5f7a989d1ccec6190d3c381ec2ac3d0abeaf0079))
+
+* Drop duplicated lists, derive export networks, cover aria-hidden ([`ec6dda8`](https://github.com/kmutahar/jekyll-theme-resume/commit/ec6dda87d8430d89c17882d44afd11cab48b151f))
+
+
+### Fixed
+* Order full dates by locale pattern ([`87c892c`](https://github.com/kmutahar/jekyll-theme-resume/commit/87c892c74f1ddc1ce633f2b110e581d8edf9f9d4))
+
+* Correct homepage URL formatting in documentation and gemspec ([`b649efd`](https://github.com/kmutahar/jekyll-theme-resume/commit/b649efdcc270d91bc639be35aa5d71d7367a48b5))
+
+* Reject plain-string education awards ([`15aa799`](https://github.com/kmutahar/jekyll-theme-resume/commit/15aa7998bda7da8e670ecc1e2ead55b13d1200d0))
+
+## [1.3.1] - 2026-10-05
+
+### Added
+* Add Rule 9, release files are owned by bin/release ([`4324433`](https://github.com/kmutahar/jekyll-theme-resume/commit/43244338cc4a027a8c2296f4a028ef0ce67dd4ee))
+
+
+### Changed
+* Stop tracking local implementation plan ([`0ad72dc`](https://github.com/kmutahar/jekyll-theme-resume/commit/0ad72dc330ca8205b248c382c9980462ba6eb557))
+
+* Publish to RubyGems via Trusted Publishing (SEC-04) ([`02a4c4b`](https://github.com/kmutahar/jekyll-theme-resume/commit/02a4c4bec139568aae4c673bf7d00bbafd85a71b))
+
+
+### Fixed
+* Read files as UTF-8 so the gem loads under a US-ASCII default encoding ([`0fb3e43`](https://github.com/kmutahar/jekyll-theme-resume/commit/0fb3e43d9943021308150e93b25bed54d5a0fc57))
+
 ## [1.3.0] - 2026-10-04
 
 ### Added
@@ -476,6 +520,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * Initial commit (New Theme Template) ([`00af662`](https://github.com/kmutahar/jekyll-theme-resume/commit/00af6628dfec7aefe0ef7d7083bf98c9713a5ffd))
 
+[1.3.2]: https://github.com/kmutahar/jekyll-theme-resume/compare/v1.3.1...v1.3.2
+[1.3.1]: https://github.com/kmutahar/jekyll-theme-resume/compare/v1.3.0...v1.3.1
 [1.3.0]: https://github.com/kmutahar/jekyll-theme-resume/compare/v1.1.0...v1.3.0
 [1.1.0]: https://github.com/kmutahar/jekyll-theme-resume/compare/v1.0.2...v1.1.0
 [1.0.2]: https://github.com/kmutahar/jekyll-theme-resume/compare/v1.0.1...v1.0.2

data/README.md

@@ -4,7 +4,7 @@
 
 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)
+**Links:** [RubyGems](https://rubygems.org/gems/jekyll-theme-resume) · [Live demo](https://www.mutahar.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
@@ -17,6 +17,7 @@ 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
+- **JSON-LD structured data**: Each CV page carries a Schema.org `ProfilePage` + `Person` block built from the same data as the JSON Resume export (on by default; opt out with `json_ld.enabled: false`). It does not guarantee ATS parsing or rich results.
 - **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

data/_config.sample.yml

@@ -88,6 +88,8 @@ social_links:
   # dribbble: https://dribbble.com/yourhandle
   # flickr: https://flickr.com/people/yourhandle
   # pinterest: https://pinterest.com/yourhandle
+  # discord: https://discord.gg/yourinvite
+  # behance: https://behance.net/yourhandle
   # mastodon: https://mastodon.social/@yourhandle # Emits <link rel="me"> in default layout
 
 # ==============================================================================
@@ -324,6 +326,11 @@ json_resume:
   languages: [] # Empty/missing: all configured languages
   privacy:
     export_contact_info: true # False removes email, phone, location, WhatsApp from JSON
+# JSON-LD (Schema.org ProfilePage + Person) in each CV page's <head>.
+# Independent of json_resume.enabled; honors json_resume.privacy.export_contact_info.
+# Details: docs/reference/json-ld-fields.md in the theme repository.
+json_ld:
+  enabled: true
 # Optional; social_links values remain URL strings.
 # social_usernames:
 #   github: octocat

data/_data/locales/ar.yml

@@ -53,6 +53,8 @@ ui:
     pinterest: "بينتيريست"
     telegram: "تيليجرام"
     youtube: "يوتيوب"
+    discord: "ديسكورد"
+    behance: "بيهانس"
 error_pages:
   "404":
     title: "الصفحة غير موجودة"
@@ -70,6 +72,7 @@ present_values:
   - "present"
   - "حتى الآن"
   - "حاليًا"
+date_format_mdy: "{day} {month} {year}"
 months:
   - "يناير"
   - "فبراير"

data/_data/locales/de.yml

@@ -53,6 +53,8 @@ ui:
     pinterest: "Pinterest"
     telegram: "Telegram"
     youtube: "YouTube"
+    discord: "Discord"
+    behance: "Behance"
 error_pages:
   "404":
     title: "Seite Nicht Gefunden"
@@ -71,6 +73,7 @@ present_values:
   - "heute"
   - "aktuell"
   - "gegenwärtig"
+date_format_mdy: "{day}. {month} {year}"
 months:
   - "Januar"
   - "Februar"

data/_data/locales/en.yml

@@ -53,6 +53,8 @@ ui:
     pinterest: "Pinterest"
     telegram: "Telegram"
     youtube: "YouTube"
+    discord: "Discord"
+    behance: "Behance"
 error_pages:
   "404":
     title: "Page Not Found"
@@ -69,6 +71,7 @@ error_pages:
 present_values:
   - "present"
   - "current"
+date_format_mdy: "{month} {day}, {year}"
 months:
   - "January"
   - "February"

data/_data/locales/es.yml

@@ -53,6 +53,8 @@ ui:
     pinterest: "Pinterest"
     telegram: "Telegram"
     youtube: "YouTube"
+    discord: "Discord"
+    behance: "Behance"
 error_pages:
   "404":
     title: "Página No Encontrada"
@@ -71,6 +73,7 @@ present_values:
   - "actualidad"
   - "actualmente"
   - "presente"
+date_format_mdy: "{day} de {month} de {year}"
 months:
   - "enero"
   - "febrero"

data/_data/locales/fr.yml

@@ -53,6 +53,8 @@ ui:
     pinterest: "Pinterest"
     telegram: "Telegram"
     youtube: "YouTube"
+    discord: "Discord"
+    behance: "Behance"
 error_pages:
   "404":
     title: "Page Introuvable"
@@ -71,6 +73,7 @@ present_values:
   - "actuel"
   - "actuellement"
   - "présent"
+date_format_mdy: "{day} {month} {year}"
 months:
   - "janvier"
   - "février"

data/_data/locales/ur.yml

@@ -53,6 +53,8 @@ ui:
     pinterest: "پن ٹریسٹ"
     telegram: "ٹیلیگرام"
     youtube: "یوٹیوب"
+    discord: "ڈسکورڈ"
+    behance: "بیہانس"
 error_pages:
   "404":
     title: "صفحہ نہیں ملا"
@@ -71,6 +73,7 @@ present_values:
   - "حال"
   - "موجودہ"
   - "تاحال"
+date_format_mdy: "{day} {month} {year}"
 months:
   - "جنوری"
   - "فروری"

data/_data/social_networks.yml

@@ -7,11 +7,21 @@
 # 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: behance
+  icon: behance
+  itemprop: sameAs
+  label: Behance
+
 - key: devto
   icon: dev
   itemprop: url
   label: Dev.to
 
+- key: discord
+  icon: discord
+  itemprop: url
+  label: Discord
+
 - key: dribbble
   icon: dribbble-symbol
   itemprop: sameAs

data/_includes/date-formatter.html

@@ -12,7 +12,7 @@
 
   Parameters:
     - date: the date to format, or a present-tense marker string (e.g. "Present"). Required.
-    - style: "MDY" for "Month Day, Year"; anything else (default "MY") for "Month Year".
+    - style: "MDY" for a full date, ordered by the locale's date_format_mdy; anything else (default "MY") for "Month Year".
     - lang: locale code to format in. Defaults to the active page/site language.
 {%- endcomment -%}
 {%- assign lang = include.lang | default: page.lang | default: site.default_lang | default: 'en' -%}
@@ -55,7 +55,9 @@
     {%- elsif month_name == nil -%}
       {{ include.date }}
     {%- elsif style == "MDY" and date_parts.size == 3 and day > 0 -%}
-      {{ month_name }} {{ day }}, {{ year }}
+      {%- assign mdy_pattern = locale.date_format_mdy | default: "{month} {day}, {year}" -%}
+      {%- assign mdy_text = mdy_pattern | replace: "{month}", month_name | replace: "{day}", day | replace: "{year}", year -%}
+      {{ mdy_text }}
     {%- else -%}
       {{ month_name }} {{ year }}
     {%- endif -%}

data/_includes/json-ld-resume.html

@@ -0,0 +1,12 @@
+{%- comment -%}
+Include: JSON-LD structured data (Schema.org ProfilePage + Person) for a CV page.
+- Parameters: lang: the active language key.
+- Source: site.json_ld_pages[lang].script, built in Ruby by JsonLdBuilder from the JSON Resume export,
+  so inactive entries, live contacts and privacy match /<lang>/resume.json. Already JSON-escaped
+  ("<" as \u003c): print it as is, never through jsonify or escape.
+- Emits nothing when json_ld.enabled is false or the language has no export.
+{%- endcomment -%}
+{%- assign json_ld_page = site.json_ld_pages[include.lang] -%}
+{%- if json_ld_page.script -%}
+<script type="application/ld+json">{{ json_ld_page.script }}</script>
+{%- endif -%}

data/_includes/social-links.html

@@ -1,8 +1,7 @@
 {%- comment -%}
   Component: Social & Professional Links List
   - Purpose: Renders interactive social network and contact links defined in `site.social_links` in `_config.yml`.
-  - Supported Platforms: Email, GitHub, LinkedIn, Telegram, Twitter/X, Medium, Dribbble, Facebook, Instagram,
-    Website, WhatsApp, Dev.to, Flickr, Pinterest, YouTube.
+  - Supported Platforms: see `_data/social_networks.yml`.
 
   Architecture & Implementation Details:
   1. Bundled Local SVGs: Vector icons are sourced locally from `_includes/vendors/svg-icons/`.

data/_includes/vendors/svg-icons/ATTRIBUTION.md

@@ -27,6 +27,8 @@ folders. Original folder (version) each file shipped in:
 | `flickr.svg` | `vendors/lineicons-v5.1/` |
 | `pinterest.svg` | `vendors/lineicons-v5.1/` |
 | `youtube.svg` | `vendors/lineicons-v5.1/` |
+| `discord.svg` | `vendors/lineicons-v5.1/` |
+| `behance.svg` | `vendors/lineicons-v5.1/` |
 
 To add a new icon (from Lineicons or elsewhere), drop the SVG into this folder and reference it
 by filename — from `_data/social_networks.yml` for a social platform, or directly via

data/_includes/vendors/svg-icons/behance.svg

@@ -0,0 +1,5 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false">
+<path d="M10.0968 11.3229C10.6452 11.0971 11.0645 10.7422 11.3226 10.3229C11.5806 9.90351 11.7419 9.35512 11.7419 8.77448C11.7419 8.22609 11.6452 7.74222 11.4839 7.32286C11.2903 6.90351 11.0323 6.58093 10.6774 6.35512C10.3226 6.12932 9.93548 5.93577 9.45161 5.83899C8.93548 5.74222 8.41936 5.70996 7.87097 5.70996H2V17.968H7.96774C8.51613 17.968 9.06452 17.9358 9.54839 17.7422C10.0968 17.6132 10.5484 17.3874 10.9677 17.0971C11.3871 16.839 11.7097 16.4519 11.9355 15.968C12.1613 15.5164 12.2903 14.968 12.2903 14.3229C12.2903 13.5487 12.0968 12.8713 11.7419 12.3551C11.3548 11.9035 10.8065 11.5487 10.0968 11.3229ZM4.74194 7.83899H7.29032C7.51613 7.83899 7.74194 7.87125 7.96774 7.87125C8.19355 7.87125 8.41935 8.00028 8.54839 8.09706C8.74194 8.19383 8.87097 8.32286 8.96774 8.54867C9.06452 8.74222 9.09677 8.96803 9.09677 9.29061C9.09677 9.77448 8.96774 10.1938 8.64516 10.4196C8.32258 10.6132 7.90323 10.7422 7.45161 10.7422H4.74194C4.74194 10.6777 4.74194 7.83899 4.74194 7.83899ZM9.45161 15.0971C9.35484 15.3229 9.22581 15.4519 9 15.5809C8.80645 15.71 8.58065 15.8067 8.35484 15.8067C8.12903 15.839 7.87097 15.839 7.6129 15.839H4.70968V12.5164H7.67742C8.25806 12.5164 8.70968 12.6454 9.09677 12.9358C9.45161 13.1938 9.64516 13.6777 9.64516 14.2906C9.58065 14.6132 9.58065 14.8713 9.45161 15.0971Z" fill="#323544"/>
+<path d="M21.8065 12.1938C21.6774 11.5486 21.3871 11.0002 21.0323 10.5164C20.6774 10.0325 20.2258 9.64541 19.6774 9.32283C19.129 9.06476 18.4516 8.87121 17.7097 8.87121C17.0323 8.87121 16.3871 9.00024 15.9032 9.22605C15.3548 9.45186 14.871 9.77444 14.4516 10.2261C14.0323 10.6454 13.7097 11.1293 13.4839 11.7099C13.2581 12.2583 13.129 12.9035 13.129 13.5809C13.129 14.2583 13.2258 14.9035 13.4516 15.4841C13.6774 16.0648 14 16.5164 14.3548 16.968C14.7742 17.3873 15.2258 17.7099 15.8065 17.9357C16.3548 18.1615 17 18.2906 17.7097 18.2906C18.7097 18.2906 19.5806 18.0648 20.2903 17.6131C21.0323 17.1615 21.5161 16.3873 21.871 15.2906H19.7419C19.6452 15.5486 19.4194 15.839 19.0968 16.0648C18.7742 16.2906 18.3226 16.4196 17.8387 16.4196C17.1613 16.4196 16.6129 16.2261 16.2581 15.8712C15.9032 15.5164 15.6774 14.839 15.6774 14.1293H22C22 13.4519 21.9677 12.7744 21.8065 12.1938ZM15.5484 12.6131C15.5484 12.3873 15.6452 12.1615 15.7097 11.968C15.8065 11.7422 15.9032 11.5164 16.0645 11.3551C16.2581 11.1615 16.5161 10.968 16.7742 10.839C17.0323 10.7099 17.3548 10.7099 17.6452 10.7099C18.2258 10.7099 18.7419 10.9035 19 11.1938C19.2581 11.5164 19.4839 11.968 19.5484 12.6131H15.5484Z" fill="#323544"/>
+<path d="M20.0319 6.54859H15.0319V7.7744H20.0319V6.54859Z" fill="#323544"/>
+</svg>

data/_includes/vendors/svg-icons/discord.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false">
+<path d="M18.9419 5.55541C17.6473 4.94967 16.263 4.50945 14.8158 4.25879C14.638 4.58013 14.4304 5.01234 14.2872 5.35616C12.7488 5.1248 11.2244 5.1248 9.71431 5.35616C9.57116 5.01234 9.35878 4.58013 9.17947 4.25879C7.73069 4.50945 6.34478 4.95129 5.05016 5.5586C2.43887 9.5046 1.73099 13.3526 2.08493 17.1459C3.81688 18.4393 5.49534 19.225 7.14547 19.7391C7.55291 19.1784 7.91628 18.5823 8.22931 17.9541C7.63313 17.7276 7.06209 17.448 6.52256 17.1235C6.66569 17.0174 6.80572 16.9066 6.94097 16.7925C10.2318 18.3317 13.8074 18.3317 17.0589 16.7925C17.1958 16.9066 17.3358 17.0174 17.4774 17.1235C16.9362 17.4496 16.3637 17.7292 15.7675 17.9557C16.0805 18.5823 16.4423 19.18 16.8513 19.7407C18.503 19.2266 20.1831 18.4409 21.915 17.1459C22.3303 12.7485 21.2056 8.93585 18.9419 5.55541ZM8.67766 14.8131C7.68978 14.8131 6.87963 13.8908 6.87963 12.7678C6.87963 11.6447 7.67247 10.7209 8.67766 10.7209C9.68284 10.7209 10.493 11.6431 10.4757 12.7678C10.4772 13.8908 9.68284 14.8131 8.67766 14.8131ZM15.3223 14.8131C14.3344 14.8131 13.5243 13.8908 13.5243 12.7678C13.5243 11.6447 14.3171 10.7209 15.3223 10.7209C16.3275 10.7209 17.1376 11.6431 17.1203 12.7678C17.1203 13.8908 16.3275 14.8131 15.3223 14.8131Z" fill="#323544"/>
+</svg>

data/_includes/vendors/svg-icons/envelope.svg

@@ -1,4 +1,4 @@
-<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false">
 <path d="M3.73586 4.5C2.7772 4.5 2.00008 5.27724 2.00025 6.2359L2.00024 6.26829C2.01058 6.81904 2.28193 7.33272 2.73193 7.65165L2.7428 7.65929L10.713 13.2171C11.3896 13.689 12.2608 13.7479 12.9861 13.3941C13.0897 13.3435 13.1903 13.2845 13.287 13.2171L21.2569 7.65949C21.7224 7.33485 21.9998 6.8031 21.9998 6.23554C21.9996 5.27702 21.2229 4.5 20.2644 4.5H3.73586Z" fill="#323544"/>
 <path opacity="0.4" d="M22.0001 8.96973L14.145 14.4473C12.8562 15.346 11.1438 15.346 9.85507 14.4473L2.00023 8.96991L2 17.2498C2 18.4924 3.00736 19.4998 4.25 19.4998H19.75C20.9926 19.4998 22 18.4924 22 17.2498L22.0001 8.96973Z" fill="#323544"/>
 </svg>

data/_includes/vendors/svg-icons/globe-1.svg

@@ -1,3 +1,3 @@
-<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false">
 <path d="M12.0014 2.75C17.1095 2.75 21.2505 6.89178 21.2505 11.9999C21.2505 17.108 17.1095 21.2498 12.0014 21.2498M12.0014 2.75C6.89329 2.75 2.75235 6.89178 2.75235 11.9999C2.75235 17.108 6.89329 21.2498 12.0014 21.2498M12.0014 2.75C14.2101 2.75 16.0005 6.89136 16.0005 11.9993C16.0005 17.1073 14.2102 21.2498 12.0014 21.2498M12.0014 2.75C9.79266 2.75 8.00196 6.89137 8.00196 11.9993C8.00196 17.1073 9.79266 21.2498 12.0014 21.2498M11.9996 15.9986C17.1076 15.9986 21.2492 14.2081 21.2492 11.9993C21.2492 9.79058 17.1076 8.00004 11.9996 8.00004C6.89165 8.00004 2.75 9.79058 2.75 11.9993C2.75 14.2081 6.89166 15.9986 11.9996 15.9986Z" stroke="#323544" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
 </svg>

data/_layouts/resume.html

@@ -12,6 +12,7 @@
         - shared-head: Shared charset, viewport, SEO base, and favicon links
         - Locale web font (locale.font_url) and locale-driven CSS (assets/css/cv-{{ locale.direction }}.css)
         - seo: Jekyll SEO tag for social graph, search indexing, and canonical URLs
+        - json-ld-resume: Schema.org ProfilePage + Person JSON-LD for this CV (built in Ruby from the JSON Resume export)
         - analytics-head: Google Analytics / GTM tracking scripts (optional)
         {%- endcomment -%}
         {% include shared-head.html %}
@@ -41,6 +42,8 @@
 
         {% seo %}
 
+        {% include json-ld-resume.html lang=lang %}
+
         {% include analytics-head.html %}
     </head>
 
@@ -51,28 +54,35 @@
         <!-- Analytics body snippet (noscript, dataLayer, etc.) -->
         {% include analytics-body.html %}
 
-        <div class="wrapper" itemscope itemtype="https://schema.org/Person">
+        {%- assign person_id = site.json_ld_pages[lang].person_id -%}
+        <div class="wrapper" itemscope itemtype="https://schema.org/Person"{% if person_id %} itemid="{{ person_id | escape }}"{% endif %}>
             {% include dark-mode-toggle.html %}
             {% include language-switcher.html %}
 
             {%- comment -%}
             Schema.org Microdata & Live Contact Protection:
+            Telephone and address are emitted only when site.display_header_contact_info is true;
+            email also when site.resume_looking_for_work is true (same rule as the JSON Resume export).
             When site.enable_live is true, phone_live and email_live are used for privacy.
             Fallback to standard phone/email if live versions are not provided.
             {%- endcomment -%}
-            {% if site.enable_live == true and site.contact_info.phone_live %}
-            <meta itemprop="telephone" content="{{ site.contact_info.phone_live }}" />
-            {% elsif site.contact_info.phone %}
-            <meta itemprop="telephone" content="{{ site.contact_info.phone }}" />
+            {% if site.display_header_contact_info == true %}
+                {% if site.enable_live == true and site.contact_info.phone_live %}
+                <meta itemprop="telephone" content="{{ site.contact_info.phone_live }}" />
+                {% elsif site.contact_info.phone %}
+                <meta itemprop="telephone" content="{{ site.contact_info.phone }}" />
+                {% endif %}
             {% endif %}
 
-            {% if site.enable_live == true and site.contact_info.email_live %}
-            <meta itemprop="email" content="{{ site.contact_info.email_live }}" />
-            {% elsif site.contact_info.email %}
-            <meta itemprop="email" content="{{ site.contact_info.email }}" />
+            {% if site.display_header_contact_info == true or site.resume_looking_for_work == true %}
+                {% if site.enable_live == true and site.contact_info.email_live %}
+                <meta itemprop="email" content="{{ site.contact_info.email_live }}" />
+                {% elsif site.contact_info.email %}
+                <meta itemprop="email" content="{{ site.contact_info.email }}" />
+                {% endif %}
             {% endif %}
 
-            {% if lang_cfg.address %}
+            {% if site.display_header_contact_info == true and lang_cfg.address %}
             <meta itemprop="address" content="{{ lang_cfg.address }}" />
             {% endif %}
 

data/_plugins/json_resume_generator.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "../lib/jekyll-theme-resume/json_ld_builder"
 require_relative "../lib/jekyll-theme-resume/json_resume_exporter"
 require_relative "../lib/jekyll-theme-resume/resume_validator"
 
@@ -21,15 +22,29 @@ module JekyllThemeResume
     end
   end
 
+  # Publishes each language's JSON Resume export as /<lang>/resume.json and the matching JSON-LD
+  # script and Person @id to site.json_ld_pages[lang] (read by _includes/json-ld-resume.html).
+  # Each language is exported at most once per build, so export warnings are not repeated.
   class JsonResumeGenerator < Jekyll::Generator
     safe true
     priority :lowest
 
     def generate(site)
       site.config["json_resume_routes"] = {}
-      options = site.config["json_resume"].is_a?(Hash) ? site.config["json_resume"] : {}
+      site.config["json_ld_pages"] = {}
       languages = site.config["languages"]
-      return if options["enabled"] == false || !languages.is_a?(Hash)
+      return unless languages.is_a?(Hash)
+
+      documents = Hash.new { |cache, lang| cache[lang] = JsonResumeExporter.export(site, lang) }
+      publish_json_resume(site, languages, documents)
+      publish_json_ld(site, languages, documents)
+    end
+
+    private
+
+    def publish_json_resume(site, languages, documents)
+      options = site.config["json_resume"].is_a?(Hash) ? site.config["json_resume"] : {}
+      return if options["enabled"] == false
 
       selected_languages(languages, options).each do |lang|
         unless ResumeValidator::LANG_KEY_REGEX.match?(lang.to_s)
@@ -39,19 +54,34 @@ module JekyllThemeResume
         route = "/#{lang}/resume.json"
         next if collision?(site, route)
 
-        document = JsonResumeExporter.export(site, lang)
+        document = documents[lang]
         next unless document
 
         site.pages << JsonResumePage.new(site, route, document)
         site.config["json_resume_routes"][lang] = route
-        next unless lang == (site.config["default_lang"] || "en") && options["root_export"] != false
-        next if collision?(site, "/resume.json")
-
-        site.pages << JsonResumePage.new(site, "/resume.json", document)
+        publish_root_export(site, lang, document, options)
       end
     end
 
-    private
+    def publish_root_export(site, lang, document, options)
+      return unless lang == (site.config["default_lang"] || "en") && options["root_export"] != false
+      return if collision?(site, "/resume.json")
+
+      site.pages << JsonResumePage.new(site, "/resume.json", document)
+    end
+
+    def publish_json_ld(site, languages, documents)
+      options = site.config["json_ld"].is_a?(Hash) ? site.config["json_ld"] : {}
+      return if options["enabled"] == false
+
+      languages.each_key do |lang|
+        next unless ResumeValidator::LANG_KEY_REGEX.match?(lang.to_s) && documents[lang]
+
+        graph = JsonLdBuilder.build(documents[lang], lang)
+        site.config["json_ld_pages"][lang] = { "script" => JsonLdBuilder.script(graph),
+                                               "person_id" => graph.dig("mainEntity", "@id") }
+      end
+    end
 
     def selected_languages(languages, options)
       requested = options["languages"]

data/docs/README.md

@@ -35,6 +35,7 @@ Steps for one task each.
 | [Show language proficiency in the header](how-to/show-language-proficiency-in-header.md) | Site owners | Show a one-line language summary in the resume header. |
 | [Switch resume versions](how-to/switch-resume-versions.md) | Site owners | Load a different set of resume data for a language. |
 | [Troubleshoot builds](how-to/troubleshoot-builds.md) | Site owners and theme developers | Diagnose a build problem from the symptom. |
+| [Validate structured data](how-to/validate-structured-data.md) | Site owners | Check the JSON-LD block of a CV page and turn it off. |
 | [Validate resume data in CI](how-to/validate-in-ci.md) | Site owners and theme developers | Gate builds on validation and run the checks in GitHub Actions. |
 | [Verify accessibility](how-to/verify-accessibility.md) | Site owners and theme developers | Run the automated and manual accessibility checks. |
 
@@ -48,6 +49,7 @@ Facts to look up: keys, schemas, flags, and structure.
 | [Data schemas](reference/data-schemas.md) | Site owners | The YAML schema of every resume data file. |
 | [Locale keys](reference/locale-keys.md) | Site owners and theme developers | The locale file schema, shipped locales, and override rules. |
 | [JSON Resume export reference](reference/json-resume-fields.md) | Site owners | Export configuration, privacy, and field mappings. |
+| [JSON-LD fields reference](reference/json-ld-fields.md) | Site owners | The JSON-LD output, field mappings, and privacy rules. |
 | [Validator and build checks](reference/validator-cli.md) | Site owners and theme developers | `validate-resume`, `check-data-keys`, rules by section, and the Ruby API. |
 | [Accessibility coverage](reference/accessibility-coverage.md) | Site owners and theme developers | What the theme implements and what the automated checks cover. |
 | [Layouts reference](reference/layouts.md) | Site owners and theme developers | The layouts, language resolution, and data loading. |

data/docs/how-to/validate-structured-data.md

@@ -0,0 +1,48 @@
+# Validate structured data
+
+*Audience: site owners*
+
+Check the JSON-LD block on a built CV page, run it through the public validators, and turn it off if you do not want it. What the block contains is in the [JSON-LD fields reference](../reference/json-ld-fields.md).
+
+JSON-LD does not guarantee ATS parsing or rich results. These checks show that the markup is valid, not that a crawler will use it.
+
+## 1. Build and extract the block
+
+Build the site, then print the JSON-LD from a CV page. With Ruby and Nokogiri (already in the theme's bundle):
+
+```bash
+bundle exec jekyll build
+bundle exec ruby -rnokogiri -rjson -e '
+  doc = Nokogiri::HTML(File.read("_site/en/cv/index.html"))
+  doc.css(%q(script[type="application/ld+json"])).each do |node|
+    data = JSON.parse(node.text)
+    puts JSON.pretty_generate(data) if data["@type"] == "ProfilePage"
+  end'
+```
+
+Adjust the path to your CV page. The page has two JSON-LD blocks: the theme's `ProfilePage` and the `WebPage` block from `jekyll-seo-tag`. The filter above prints ours.
+
+In a browser, open the page, view source, and search for `application/ld+json`.
+
+## 2. Check it with the validators
+
+To check syntax and vocabulary, paste the block into [validator.schema.org](https://validator.schema.org/). To see how Google reads it, use the [Rich Results Test](https://search.google.com/test/rich-results) with the published URL, or with pasted code for a local build.
+
+## 3. Read the common warnings
+
+| Warning | Cause | Fix |
+|---|---|---|
+| The block has no `@id`, `url` or `Person.@id` | `site.url` is not set, so the theme cannot build absolute URLs. | Set `url` in `_config.yml`. |
+| No `email`, `telephone` or `address` | The CV hides them, or `json_resume.privacy.export_contact_info` is `false`. | See [Visibility and privacy](../reference/json-ld-fields.md#visibility-and-privacy). |
+| No `worksFor` | `worksFor` lists only roles with a start date and no end date. | Give the current role a `startdate` and set `enddate` to `Present` or a word from the locale's `present_values`, or leave it out. |
+| No `description` or `image` | Only emitted when `header_intro: true` and `resume_avatar: true`. | Enable them if you want the values. |
+| Two blocks, different `author` | `site.author` feeds `jekyll-seo-tag`'s block. | Set `site.author` to the CV name. |
+
+## 4. Turn it off
+
+```yaml
+json_ld:
+  enabled: false
+```
+
+The block disappears from every CV page. The JSON Resume files are not affected; control them with [`json_resume.enabled`](../reference/config.md#13-json-resume-export).

data/docs/reference/config.md

@@ -152,6 +152,8 @@ social_links:
   dribbble: https://dribbble.com/yourhandle
   flickr: https://flickr.com/people/yourhandle
   pinterest: https://pinterest.com/yourhandle
+  discord: https://discord.gg/yourinvite
+  behance: https://behance.net/yourhandle
   # mastodon emits <link rel="me"> in default.html and profile.html for Fediverse verification:
   mastodon: https://mastodon.social/@yourhandle
 ```
@@ -331,6 +333,23 @@ social_usernames:
 
 Routes, collision rules, visibility, and field mappings: [JSON Resume export configuration and privacy](json-resume-fields.md#configuration).
 
+### 13a. JSON-LD structured data
+
+On by default. The key is optional.
+
+| Setting | Type | Default | Description |
+|---|---|---|---|
+| `json_ld.enabled` | Boolean | `true` | `false` removes the `application/ld+json` block from every CV page. |
+
+`json_ld` is independent of `json_resume.enabled` and `json_resume.languages`: turning off the JSON Resume files does not turn off JSON-LD, and every configured language whose export passes validation gets a block. It does honor `json_resume.privacy.export_contact_info`: with `false`, the block omits email, phone, address and the WhatsApp profile.
+
+```yaml
+json_ld:
+  enabled: true
+```
+
+Output shape, field mappings and limits: [JSON-LD fields reference](json-ld-fields.md). Checking the output: [Validate structured data](../how-to/validate-structured-data.md).
+
 ### 14. Content Security Policy
 
 The theme ships no CSP header (static sites set headers at the host). It does emit inline code, so a strict `script-src` needs a hash for each inline script, or `'unsafe-inline'`.
@@ -341,6 +360,7 @@ The theme ships no CSP header (static sites set headers at the host). It does em
 | Dark-mode toggle handler | `dark-mode-toggle.html`, when the toggle is enabled | `script-src` |
 | Error-page language detection | `404`/`403`/`500`/`503` pages (`error.html`) | `script-src` |
 | Google Tag Manager or `gtag` snippet | `analytics-head.html`, when `analytics.gtm` / `analytics.gtag` is set | `script-src`, plus `connect-src`/`img-src`/`frame-src` for Google hosts |
+| JSON-LD block (`<script type="application/ld+json">`, `json-ld-resume.html`) | `<head>` of CV pages | None. It is a data block that browsers never run, so `script-src` does not govern it and it needs no hash |
 | Locale font and line-height variables | `<style>` in `resume.html` | `style-src` |
 | `onclick="window.location.reload();"` on the error-page Reload button | 500/503 error pages | `script-src-attr` |
 | Some `style="..."` attributes (project and association titles, GTM `<noscript>` iframe) | resume sections, `analytics-body.html` | `style-src-attr` |

data/docs/reference/includes.md

@@ -15,6 +15,7 @@ _layouts/resume.html
  ├── data-loader.html        (binds resume_data from languages.<lang>.data_path)
  ├── shared-head.html        (anti-FOUC script, metadata, favicon suite)
  ├── hreflang.html           (alternate-language links)
+ ├── json-ld-resume.html     (Schema.org JSON-LD script for this CV)
  ├── analytics-head.html     (GTM / GA4 head script)
  ├── analytics-body.html     (GTM noscript iframe)
  ├── dark-mode-toggle.html   (floating theme toggle)
@@ -45,6 +46,15 @@ _layouts/resume.html
 - **Favicons:** `favicon`, `apple_touch_icon`, `favicon_32`, `favicon_16`, and the web manifest, all through `relative_url`.
 - **Robots:** `noindex noarchive nosnippet noimageindex` when `page.noindex: true`.
 
+### 1a. `json-ld-resume.html`
+
+- **Consumed by:** `resume.html`, right after `{% seo %}`.
+- **Parameters:** `lang` (the active language key).
+- **Source:** `site.json_ld_pages[lang].script`, built in Ruby by `JsonLdBuilder` from the JSON Resume export and published by `json_resume_generator.rb`.
+- **Output:** one `<script type="application/ld+json">` block. Nothing is emitted when `json_ld.enabled` is `false` or the language has no export.
+- **Escaping:** the script is already JSON-escaped (`<` as `\u003c`). Print it as is; do not pass it through `jsonify` or `escape`.
+- **Override:** a site can replace the include by adding `_includes/json-ld-resume.html`. The override then owns the output and its escaping. See [JSON-LD fields](json-ld-fields.md).
+
 ### 2. Stylesheet links (inline in each layout)
 
 - `default.html` (therefore also error pages) links `assets/css/main.css` directly, no include.
@@ -101,7 +111,7 @@ _layouts/resume.html
 ### 7. `social-links.html`
 
 - **Consumed by:** `resume.html` and `profile.html`, inside `<ul class="social-links">`, when `site.social_links` is set.
-- `email` renders a `mailto:` link with `itemprop="email"`. The other 14 platforms (`github`, `linkedin`, `telegram`, `twitter`, `medium`, `dribbble`, `facebook`, `instagram`, `website`, `whatsapp`, `devto`, `flickr`, `pinterest`, `youtube`) open in a new tab with `rel="noopener nofollow noreferrer"`.
+- `email` renders a `mailto:` link with `itemprop="email"`. Every other platform in `_data/social_networks.yml` opens in a new tab with `rel="noopener nofollow noreferrer"`.
 - Every icon link carries `aria-label`, `title`, and a `.sr-only` text span, all taken from the page locale's `ui.social_labels.<key>` (falling back to the English `label` in `_data/social_networks.yml`).
 - `profile.html` adds one extra email icon for `contact_info.email` only when `social_links.email` is not set, so the profile never shows two email icons.
 

data/docs/reference/json-ld-fields.md

@@ -0,0 +1,84 @@
+# JSON-LD fields reference
+
+*Audience: site owners and theme developers*
+
+Reference for the Schema.org JSON-LD block on each CV page: output shape, field mappings, visibility and privacy rules, and limits. To check the output, see [Validate structured data](../how-to/validate-structured-data.md).
+
+JSON-LD is metadata for search engines and other crawlers. It does not guarantee that an applicant tracking system (ATS) parses the CV, and it does not guarantee rich results in search. Crawlers decide for themselves what to use.
+
+## Output
+
+Each CV page has one `<script type="application/ld+json">` in `<head>`, right after `{% seo %}`. It is a `ProfilePage` whose `mainEntity` is a `Person`.
+
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "ProfilePage",
+  "@id": "https://example.org/en/cv/",
+  "url": "https://example.org/en/cv/",
+  "inLanguage": "en",
+  "dateModified": "2026-10-05T12:00:00Z",
+  "mainEntity": {
+    "@type": "Person",
+    "@id": "https://example.org/en/cv/#person",
+    "name": "Sherlock Holmes",
+    "jobTitle": "Consulting Detective",
+    "worksFor": [{ "@type": "Organization", "name": "Acme" }],
+    "knowsAbout": ["Ruby"]
+  }
+}
+```
+
+The example is shortened; the full property list is below. The theme builds the block in Ruby (`JsonLdBuilder`) from the [JSON Resume export](json-resume-fields.md) of the same language, then prints it through [`json-ld-resume.html`](includes.md#1a-json-ld-resumehtml). Because it reads the export, inactive entries, live contact values, privacy settings, HTML stripping and URL checks are already applied.
+
+Every empty string, `nil`, empty array and empty object is dropped at every level. A node left with only `@type` is dropped too.
+
+## Field mapping
+
+| Schema.org | JSON Resume source | Rule |
+|---|---|---|
+| `ProfilePage.@id`, `ProfilePage.url`, `Person.url` | `basics.url` | All omitted when the export has no URL (no `site.url`). Relative values are never emitted. |
+| `ProfilePage.inLanguage` | the language key | Same value as `<html lang>`. |
+| `ProfilePage.dateModified` | `meta.lastModified` | Build time, UTC, ISO 8601. |
+| `Person.@id` | `basics.url` plus `#person` | Omitted when `basics.url` is absent. |
+| `name`, `jobTitle`, `description`, `image` | `basics.name`, `basics.label`, `basics.summary`, `basics.image` | `summary` exists only when `header_intro: true`; `image` only when `resume_avatar: true`. |
+| `email`, `telephone` | `basics.email`, `basics.phone` | See [Visibility and privacy](#visibility-and-privacy). |
+| `address` (`PostalAddress`) | `basics.location` | `address` to `streetAddress`, `postalCode` to `postalCode`, `city` to `addressLocality`, `region` to `addressRegion`, `countryCode` to `addressCountry`. Omitted when no part is set. |
+| `sameAs` | `basics.profiles[].url` | Same order as the export. |
+| `worksFor` | `work[]` with `startDate` and no `endDate` | Current roles only. Entries with no dates are not current. Deduplicated by name, first-seen order. Type `Organization`. |
+| `alumniOf` | `education[].institution` | Type `EducationalOrganization`, deduplicated by name. |
+| `hasCredential` | `certificates[]` | `EducationalOccupationalCredential` with `name`, `url`, `dateCreated` (from `date`) and `recognizedBy` (from `issuer`, only when present). |
+| `award` | `awards[].title` | List of text. |
+| `knowsAbout` | `skills[].name` | List of text. |
+| `knowsLanguage` | `languages[].language` | `Language` objects. |
+
+## Visibility and privacy
+
+The block follows the same rules as `resume.json`; see [Visibility and privacy](json-resume-fields.md#visibility-and-privacy) for the table.
+
+- `telephone` and `address` appear only when `display_header_contact_info: true`.
+- `email` appears when `display_header_contact_info: true` or `resume_looking_for_work: true`.
+- With `enable_live: true`, the live email and phone values are used, as on the page.
+- `json_resume.privacy.export_contact_info: false` removes email, phone, address and the WhatsApp profile from the block. There is no separate JSON-LD privacy key.
+
+`json_ld.enabled` is independent of `json_resume.enabled` and `json_resume.languages`. See [JSON-LD structured data](config.md#13a-json-ld-structured-data).
+
+## Not mapped
+
+Volunteering, projects, publications, references, interests, courses, associations and links have no clean `Person` property. They stay in the JSON Resume export and the visible HTML.
+
+## Coexistence with `jekyll-seo-tag`
+
+`{% seo %}` always emits its own `WebPage` JSON-LD and the page's only canonical link; it has no option to turn that off. The theme leaves it in place and does not emit a canonical link of its own. The `ProfilePage` `url` and `@id` equal the canonical URL.
+
+If `site.author` is set, `jekyll-seo-tag` publishes it as the `author` of its block. Set it to the same name as the CV so the two blocks agree.
+
+## Link to the Person microdata
+
+The `.wrapper` element in [`resume.html`](layouts.md#3-resumehtml-resume-every-language) is also a Schema.org `Person` (microdata). It carries `itemid` equal to the JSON-LD `Person.@id`, so parsers can merge the two into one Person. Its `telephone`, `email` and `address` follow the same contact-bar and looking-for-work rules as the JSON-LD block. `json_resume.privacy.export_contact_info` does not apply to the microdata, because it only describes values the page already shows.
+
+## Escaping
+
+The script is serialized with `JSON.generate`, and every `<` is replaced with the six characters `\u003c`, which any JSON parser reads as `<`. Resume text such as `</script>` or `<!--<script` therefore cannot end or corrupt the block. If you override `json-ld-resume.html`, keep this escaping.
+
+Test coverage: [Testing suites](testing-suites.md).

data/docs/reference/json-resume-fields.md

@@ -19,6 +19,8 @@ collection document, or existing generated page preserves that resource and logs
 a warning. A collision at the localized route also suppresses its root copy.
 A root-only collision does not suppress the localized export.
 
+The same export also feeds the CV page's [JSON-LD block](json-ld-fields.md), so the visibility and privacy rules below apply to both.
+
 Discovery links on CV pages and the `application/json` hosting requirement are covered in [Publish the JSON Resume export](../how-to/publish-json-resume.md).
 
 ## Visibility and privacy
@@ -95,10 +97,8 @@ camelCase names on the right belong only to the JSON output.
 | `references.name`, `reference` | `references[].name`, `reference` |
 
 Experience and volunteering remain one record per role; company groups and
-newest-first role ordering follow the HTML renderer. Supported social networks
-are the ones rendered by the existing social include: GitHub, LinkedIn,
-Telegram, Twitter, Medium, Dribbble, Facebook, Instagram, Website, WhatsApp,
-Dev.to, Flickr, Pinterest, and YouTube. Their configured keys identify networks
+newest-first role ordering follow the HTML renderer. Every network in `_data/social_networks.yml` except
+`email` is exported. Their configured keys identify networks
 in the export. Social URLs remain strings; nested `{url, username}` objects are
 not introduced by this feature.
 

data/docs/reference/layouts.md

@@ -68,7 +68,8 @@ The locale schema is in [Locale keys](locale-keys.md); the `languages` schema is
   - Loads `locale.font_url` when set, else the default Lora and Open Sans stylesheet; neither loads when `disable_google_fonts: true` or `resume_theme: no-custom-fonts`.
   - Emits `--font-locale` (from `locale.font_family`, when non-empty) and `--line-height-locale` (from `locale.line_height`) in an inline `:root` style.
   - Links `assets/css/cv-{{ locale.direction }}.css`, so LTR locales get `cv-ltr.css` and RTL locales get `cv-rtl.css`.
-  - Includes [`hreflang.html`](../../_includes/hreflang.html), `{% seo %}`, and the analytics head include.
+  - Includes [`hreflang.html`](../../_includes/hreflang.html), `{% seo %}`, [`json-ld-resume.html`](../../_includes/json-ld-resume.html) (after `{% seo %}`), and the analytics head include.
+- **Person microdata:** the `.wrapper` element is a Schema.org `Person` with `itemid` set to the JSON-LD Person `@id` (`<site url>/<path>/#person`), so parsers merge it with the JSON-LD block. The `itemid` is omitted when no absolute URL is available. Microdata `telephone` and `address` are emitted only when `display_header_contact_info: true`; `email` also when `resume_looking_for_work: true`. This is the same rule as the [JSON Resume export](json-resume-fields.md#visibility-and-privacy).
 - **Header:** avatar (when `resume_avatar: true`), `lang_cfg.name`, the contact row (when `display_header_contact_info: true`), the header language list (when `display_header_contact_info: true` and `resume_section.lang_header` is set), `lang_cfg.resume_title`, social icons (when `social_links` is set), the `header.yml` intro (when `lang_cfg.header_intro: true`), and the contact button (per `resume_looking_for_work`).
 - **Contact row:** icon first, then text, in every direction. Phone numbers and emails carry `dir="ltr"`. The date of birth goes through [`date-formatter.html`](../../_includes/date-formatter.html).
 - **Body:** loops `site.resume_section_order` through [`resume-section.html`](../../_includes/resume-section.html), then the print-only social links section when `resume_print_social_links` is set.
@@ -122,7 +123,7 @@ The order of operations for one resume page:
 
 ```text
 1. Resolve lang, locale, lang_cfg; load resume_data from lang_cfg.data_path
-2. <head>: shared-head, locale font + CSS variables, cv-<direction>.css, hreflang, SEO, analytics
+2. <head>: shared-head, locale font + CSS variables, cv-<direction>.css, hreflang, SEO, JSON-LD, analytics
 3. Body start: analytics-body, dark-mode-toggle, language-switcher
 4. Header: avatar, name, contact row, header languages, title, social icons, intro, contact button
 5. Sections: for each name in site.resume_section_order

data/docs/reference/locale-keys.md

@@ -31,6 +31,7 @@ Every locale file has the same key set. The validator warns when a language's ef
 | `ui.social_labels.*` | Platform names: the accessible name (`aria-label`, `title`, screen-reader text) of each social icon and the labels of the print-only contact list. |
 | `error_pages."404"` / `"403"` / `"500"` / `"503"` | `title` and `message` for each HTTP error page. |
 | `present_values` | Case-insensitive words that mean "ongoing" in `enddate` fields. A match renders `ui.present` instead of a date. |
+| `date_format_mdy` | Pattern for full dates (`style="MDY"`: certifications, courses, publications, date of birth), using `{day}`, `{month}`, `{year}`. Defaults to `{month} {day}, {year}`. |
 | `months` | The 12 month names, January first. Dates render as `<month> <year>`; a year-only date renders as the year. |
 
 Read the shipped files in [`../../_data/locales/`](../../_data/locales/) for the full key list and current values.

data/docs/reference/repository-map.md

@@ -27,6 +27,7 @@ jekyll-theme-resume/
 │   ├── social-links.html         # Social icons (email + 14 platforms)
 │   ├── print-social-links.html   # Print-only social links text list
 │   ├── hreflang.html             # Alternate-language SEO links
+│   ├── json-ld-resume.html       # Schema.org JSON-LD script for a CV page
 │   ├── analytics-head.html       # GTM / GA4 head script
 │   ├── analytics-body.html       # GTM noscript body fallback
 │   └── vendors/svg-icons/        # Bundled Lineicons SVGs (MIT; see ATTRIBUTION.md inside)
@@ -57,13 +58,14 @@ jekyll-theme-resume/
 │
 ├── _plugins/
 │   ├── error_pages_generator.rb  # Synthesizes missing HTTP error pages
-│   ├── json_resume_generator.rb  # Publishes /<lang>/resume.json (and /resume.json for default_lang) via JsonResumeExporter
+│   ├── json_resume_generator.rb  # Publishes /<lang>/resume.json (and /resume.json for default_lang) via JsonResumeExporter, and site.json_ld_pages for the JSON-LD include
 │   ├── resume_pages_generator.rb # Synthesizes missing CV/profile pages per language
 │   └── resume_validator.rb       # Build-time validation (on by default)
 │
 ├── lib/
 │   ├── jekyll-theme-resume.rb          # Gem entrypoint
 │   └── jekyll-theme-resume/
+│       ├── json_ld_builder.rb      # Maps the JSON Resume export to a Schema.org ProfilePage + Person
 │       ├── json_resume_exporter.rb # Maps resume data to a JSON Resume v1.0.0 document
 │       ├── resume_validator.rb   # Validator engine
 │       ├── template_key_checker.rb # Template checker (repository-only)

data/docs/reference/testing-suites.md

@@ -18,13 +18,14 @@ Every test goes through a public interface; see [Tests use public interfaces onl
 
 | Suite | Interface under test | Covers |
 |---|---|---|
-| [`test_rendered_site.rb`](../../test/test_rendered_site.rb) | Generated HTML of a fixture site built from the theme's real `_layouts`, `_includes`, `_sass`, `_data`, `assets` | Each of the sections (fields, separators, inactive entries, grouping, RTL `dir="ltr"` isolation); date formats; header, contact bar, avatar, microdata; social and print links; hreflang; profile, default and error layouts (including the URL-language script and `baseurl`); config switches such as `enable_live`, `lang_header`, `baseurl`, analytics, dark mode |
+| [`test_rendered_site.rb`](../../test/test_rendered_site.rb) | Generated HTML of a fixture site built from the theme's real `_layouts`, `_includes`, `_sass`, `_data`, `assets` | Each of the sections (fields, separators, inactive entries, grouping, RTL `dir="ltr"` isolation); date formats; header, contact bar, avatar, microdata (including the contact visibility gate and `itemid`); the JSON-LD block (`json_ld.enabled`, `<` escaping, privacy); social and print links; hreflang; profile, default and error layouts (including the URL-language script and `baseurl`); config switches such as `enable_live`, `lang_header`, `baseurl`, analytics, dark mode |
 | [`test_language_switcher.rb`](../../test/test_language_switcher.rb) | Generated HTML, six languages | Switcher links, labels, direction, page/site opt-out, error layout |
 | [`test_resume_validator.rb`](../../test/test_resume_validator.rb) | `ResumeValidator#validate`, `bin/validate-resume`, build plugin | Every schema rule per section, dates, "Present" values, URLs, alias keys, locale merge and parity, config resolution, strict mode, CLI flags |
 | [`test_template_key_checker.rb`](../../test/test_template_key_checker.rb) | `TemplateKeyChecker#check`, `bin/check-data-keys` | Liquid binding resolution, include boundaries, advisory exit codes |
 | [`test_error_pages_generator.rb`](../../test/test_error_pages_generator.rb) | Site build | Generated 404/403/500 pages, site overrides, generator registration |
 | [`test_resume_pages_generator.rb`](../../test/test_resume_pages_generator.rb) | Site build | Generated CV/profile pages, collisions, per-language and global toggles |
-| [`test_json_resume_exporter.rb`](../../test/test_json_resume_exporter.rb) | `JsonResumeExporter.export`, site build | JSON Resume mapping, privacy, visibility, schema validation, routes; see [json-resume-fields.md](json-resume-fields.md) |
+| [`test_json_resume_exporter.rb`](../../test/test_json_resume_exporter.rb) | `JsonResumeExporter.export`, site build | JSON Resume mapping, privacy, visibility, schema validation, routes; the generator's `site.json_ld_pages` output and its independence from `json_resume.*`; see [json-resume-fields.md](json-resume-fields.md) |
+| [`test_json_ld_builder.rb`](../../test/test_json_ld_builder.rb) | `JsonLdBuilder.build` and `.script` | Mapping to ProfilePage + Person, dropping empty values, current-role and dedupe rules, `<` escaping; see [json-ld-fields.md](json-ld-fields.md) |
 | [`test_packaging.rb`](../../test/test_packaging.rb) | Gemspec, shipped `_data` | Gem file list, six-locale key parity, unused locale keys, social icons and labels, demo data parity |
 | [`test_doc_links.rb`](../../test/test_doc_links.rb) | The tracked Markdown files | Every relative link and `#anchor` in the docs resolves; links in code blocks and external URLs are skipped |
 

data/docs/tutorials/getting-started.md

@@ -42,6 +42,15 @@ source "https://rubygems.org"
 group :jekyll_plugins do
   gem "jekyll-theme-resume"
 end
+
+# Windows and JRuby do not include zoneinfo files, so bundle tzinfo-data.
+platforms :windows, :jruby do
+  gem "tzinfo"
+  gem "tzinfo-data"
+end
+
+# Faster directory watching on Windows
+gem "wdm", platforms: [:windows]
 ```
 
 The theme must be inside `group :jekyll_plugins`. That group loads the theme's build-time generators and validator. A plain `gem` line outside the group does not load them.

data/lib/jekyll-theme-resume/json_ld_builder.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require "json"
+
+module JekyllThemeResume
+  # Maps a JSON Resume document (JsonResumeExporter output) to a Schema.org ProfilePage + Person.
+  # Reusing the export means inactive entries, live contacts, privacy, HTML stripping and URL
+  # checks are already applied, so JSON-LD and JSON Resume never disagree.
+  module JsonLdBuilder
+    module_function
+
+    def build(resume, lang)
+      basics = resume["basics"] || {}
+      url = basics["url"]
+      compact("@context" => "https://schema.org", "@type" => "ProfilePage", "@id" => url, "url" => url,
+              "inLanguage" => lang, "dateModified" => resume.dig("meta", "lastModified"),
+              "mainEntity" => person(resume, basics, url))
+    end
+
+    # jsonify/to_json leave "<" raw, so "</script x" or "<!--<script" in resume text could end or
+    # corrupt the <script> block. "\u003c" is the same character to any JSON parser.
+    def script(graph)
+      JSON.generate(graph).gsub("<", "\\u003c")
+    end
+
+    def person(resume, basics, url)
+      {
+        "@type" => "Person", "@id" => url && "#{url}#person", "name" => basics["name"],
+        "jobTitle" => basics["label"], "description" => basics["summary"], "image" => basics["image"],
+        "url" => url, "email" => basics["email"], "telephone" => basics["phone"],
+        "address" => address(basics["location"]),
+        "sameAs" => Array(basics["profiles"]).filter_map { |profile| profile["url"] },
+        "worksFor" => organizations(current_roles(resume).map { |role| role["name"] }, "Organization"),
+        "alumniOf" => organizations(Array(resume["education"]).map { |item| item["institution"] },
+                                    "EducationalOrganization"),
+        "hasCredential" => Array(resume["certificates"]).map { |item| credential(item) },
+        "award" => Array(resume["awards"]).filter_map { |item| item["title"] },
+        "knowsAbout" => Array(resume["skills"]).filter_map { |item| item["name"] },
+        "knowsLanguage" => Array(resume["languages"]).map { |item| { "@type" => "Language", "name" => item["language"] } }
+      }
+    end
+
+    # Current roles only: a start date and no end date. Dateless entries are not current.
+    def current_roles(resume)
+      Array(resume["work"]).select { |role| role["startDate"] && !role["endDate"] }
+    end
+
+    def organizations(names, type)
+      names.compact.uniq.map { |name| { "@type" => type, "name" => name } }
+    end
+
+    def credential(item)
+      { "@type" => "EducationalOccupationalCredential", "name" => item["name"], "url" => item["url"],
+        "dateCreated" => item["date"], "recognizedBy" => { "@type" => "Organization", "name" => item["issuer"] } }
+    end
+
+    def address(location)
+      return unless location
+
+      { "@type" => "PostalAddress", "streetAddress" => location["address"], "postalCode" => location["postalCode"],
+        "addressLocality" => location["city"], "addressRegion" => location["region"],
+        "addressCountry" => location["countryCode"] }
+    end
+
+    # Drops nil/empty values at every depth; a node left with only "@type" is dropped too.
+    def compact(value)
+      case value
+      when Hash
+        result = value.transform_values { |item| compact(item) }.reject { |_key, item| blank?(item) }
+        result.keys == ["@type"] ? nil : result
+      when Array then value.map { |item| compact(item) }.reject { |item| blank?(item) }
+      else value
+      end
+    end
+
+    def blank?(value)
+      value.nil? || (value.respond_to?(:empty?) && value.empty?)
+    end
+  end
+end

data/lib/jekyll-theme-resume/json_resume_exporter.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "json"
+require "yaml"
 require "date"
 require "time"
 require "cgi"
@@ -13,7 +14,7 @@ module JekyllThemeResume
   # Returns nil when final validation fails; callers must never publish that export.
   class JsonResumeExporter
     SCHEMA_URL = "https://raw.githubusercontent.com/jsonresume/resume-schema/v1.0.0/schema.json"
-    SCHEMA = JSONSchemer.schema(JSON.parse(File.read(File.join(__dir__, "schemas/json_resume_v1.0.0.json"))))
+    SCHEMA = JSONSchemer.schema(JSON.parse(File.read(File.join(__dir__, "schemas/json_resume_v1.0.0.json"), encoding: "UTF-8")))
     SECTIONS = {
       "experience" => "work", "volunteering" => "volunteer", "education" => "education",
       "certifications" => "certificates", "recognitions" => "awards", "skills" => "skills",
@@ -37,8 +38,8 @@ module JekyllThemeResume
       "experience" => %w[highlights], "volunteering" => %w[highlights], "education" => %w[courses],
       "skills" => %w[keywords], "interests" => %w[keywords], "projects" => %w[highlights keywords]
     }.freeze
-    NETWORKS = %w[github linkedin telegram twitter medium dribbble facebook instagram website whatsapp devto flickr pinterest
-                  youtube].freeze
+    NETWORKS = (YAML.safe_load_file(File.expand_path("../../_data/social_networks.yml", __dir__)).map { |n| n["key"] } -
+                %w[email]).freeze
     COUNTRY_CODES = %w[
       AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ
       CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR

data/lib/jekyll-theme-resume/resume_validator.rb

@@ -624,6 +624,14 @@ module JekyllThemeResume
       validate_date(entry["startdate"], context, "startdate") if entry["startdate"]
       validate_date_or_present(entry["enddate"], context, "enddate", lang: lang) if entry["enddate"]
       validate_date_range(entry["startdate"], entry["enddate"], context, lang: lang) if entry["startdate"] && entry["enddate"]
+      validate_education_awards(entry["awards"], context) if entry.key?("awards")
+    end
+
+    # The template prints `award.award`, so plain strings would render as empty bullets.
+    def validate_education_awards(awards, context)
+      return if awards.is_a?(Array) && awards.all? { |award| award.is_a?(Hash) && !award["award"].to_s.strip.empty? }
+
+      add_error(context, "'awards' must be a list of `- award: text` items")
     end
 
     def validate_certification_entry(entry, context, lang: nil)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-resume
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.3.2
 platform: ruby
 authors:
 - Khaldoon Mutahar
@@ -236,6 +236,7 @@ files:
 - _includes/date-formatter.html
 - _includes/grouped-item-list.html
 - _includes/hreflang.html
+- _includes/json-ld-resume.html
 - _includes/language-switcher.html
 - _includes/print-social-links.html
 - _includes/resume-section.html
@@ -243,7 +244,9 @@ files:
 - _includes/shared-head.html
 - _includes/social-links.html
 - _includes/vendors/svg-icons/ATTRIBUTION.md
+- _includes/vendors/svg-icons/behance.svg
 - _includes/vendors/svg-icons/dev.svg
+- _includes/vendors/svg-icons/discord.svg
 - _includes/vendors/svg-icons/dribbble-symbol.svg
 - _includes/vendors/svg-icons/envelope.svg
 - _includes/vendors/svg-icons/facebook.svg
@@ -314,12 +317,14 @@ files:
 - docs/how-to/switch-resume-versions.md
 - docs/how-to/troubleshoot-builds.md
 - docs/how-to/validate-in-ci.md
+- docs/how-to/validate-structured-data.md
 - docs/how-to/verify-accessibility.md
 - docs/reference/accessibility-coverage.md
 - docs/reference/config.md
 - docs/reference/data-schemas.md
 - docs/reference/glossary.md
 - docs/reference/includes.md
+- docs/reference/json-ld-fields.md
 - docs/reference/json-resume-fields.md
 - docs/reference/layouts.md
 - docs/reference/locale-keys.md
@@ -329,18 +334,19 @@ files:
 - docs/reference/validator-cli.md
 - docs/tutorials/getting-started.md
 - lib/jekyll-theme-resume.rb
+- lib/jekyll-theme-resume/json_ld_builder.rb
 - lib/jekyll-theme-resume/json_resume_exporter.rb
 - lib/jekyll-theme-resume/resume_validator.rb
 - lib/jekyll-theme-resume/schemas/LICENSE.md
 - lib/jekyll-theme-resume/schemas/json_resume_v1.0.0.json
-homepage: https://www.mutahr.me/jekyll-theme-resume
+homepage: https://www.mutahar.me/jekyll-theme-resume
 licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/kmutahar/jekyll-theme-resume/issues
   changelog_uri: https://github.com/kmutahar/jekyll-theme-resume/blob/master/CHANGELOG.md
   documentation_uri: https://github.com/kmutahar/jekyll-theme-resume#readme
-  homepage_uri: https://www.mutahr.me/jekyll-theme-resume
+  homepage_uri: https://www.mutahar.me/jekyll-theme-resume
   source_code_uri: https://github.com/kmutahar/jekyll-theme-resume/
   allowed_push_host: https://rubygems.org
 post_install_message: |