jekyll-theme-resume 1.3.0

data/_includes/resume-section.html

@@ -0,0 +1,547 @@
+{% comment %}
+  Unified Section Dispatcher (all locales)
+  Renders a single resume section based on the 'section_name' parameter, replacing the
+  separate resume-section-en.html / resume-section-ar.html per-language dispatchers.
+  Usage: {% include resume-section.html section_name="experience" %}
+
+  Dispatcher Architecture:
+  - Iterated over by the active resume layout, looping through `site.resume_section_order`.
+  - Dual-Condition Gate: Each section is evaluated against `include.section_name == "<name>"`
+    and its configuration flag `site.resume_section.<name>` in `_config.yml`.
+  - Data Source: Binds to `resume_data.<section>` resolved dynamically by the parent layout.
+  - Locale Resolution: Resolves `lang`/`locale` the same way every other template does
+    (page.lang, falling back to site.default_lang), and reads section headers from
+    `locale.ui.section_titles`.
+  - Dates: Uses `_includes/date-formatter.html` for every date interval. A blank/omitted
+    `enddate` is passed through as "Present" (matched by every locale's `present_values`),
+    so ongoing roles render the locale's present-tense string automatically.
+  - RTL Bidi Protection: When `locale.direction == 'rtl'`, wraps URLs and credential IDs in
+    `dir="ltr"` so Latin punctuation and alphanumeric IDs aren't scrambled by the bidi
+    algorithm. No-op for LTR locales.
+  - Recognitions: Accepts only the plural `site.resume_section.recognitions` flag; the legacy
+    singular `site.resume_section.recognition` fallback is dropped (Task 3.4 confirms no
+    references remain).
+  - Microdata: Incorporates Schema.org semantic tags (Organization, CollegeOrUniversity, CreativeWork).
+  - Print Media: Hyperlinks include print-only text fallbacks to ensure URLs remain legible on physical paper or exported PDFs.
+{% endcomment %}
+{%- assign lang = include.lang | default: page.lang | default: site.default_lang | default: 'en' -%}
+{%- assign locale = site.data.locales[lang] | default: site.data.locales[site.default_lang] -%}
+{%- assign rtl = false -%}
+{%- if locale.direction == 'rtl' -%}
+  {%- assign rtl = true -%}
+{%- endif -%}
+
+{%- comment -%}
+  Section: Experience
+  - Data: `resume_data.experience` filtered by `active: true`.
+  - Grouping: Groups multiple sequential roles under the same organization via `group_by: "company"`.
+  - Sorting: Sorts positions chronologically by `startdate` in reverse order (newest first).
+  - Formatting: Dynamically displays position, dates, and location with bullet separators (`&bull;`) only between non-empty fields.
+  - Durations vs Date Ranges: Renders explicit `durations` array if present (pre-formatted, not
+    passed through date-formatter.html), otherwise formats startdate to enddate/Present.
+  - Microdata: Schema.org `Organization` with `worksFor` itemprop.
+{%- endcomment -%}
+{% if include.section_name == "experience" and site.resume_section.experience %}
+    <!-- begin Experience -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.experience }}</h2>
+        </header>
+
+        {% include grouped-item-list.html items=resume_data.experience lang=lang %}
+    </section>
+    <!-- end Experience -->
+
+
+{%- comment -%}
+  Section: Education
+  - Data: `resume_data.education` filtered by `active == true`.
+  - Microdata: Schema.org `CollegeOrUniversity` with `alumniOf` itemprop.
+  - Awards: Supports both single `award` string (h5) and multiple `awards` list (ul/li).
+{%- endcomment -%}
+{% elsif include.section_name == "education" and site.resume_section.education %}
+    <!-- begin Education -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.education }}</h2>
+        </header>
+
+        {% for education in resume_data.education %}
+            {% if education.active == true %}
+                <div class="resume-item" itemscope itemprop="alumniOf" itemtype="http://schema.org/CollegeOrUniversity">
+                    <h3 class="resume-item-title" itemprop="name">{{ education.uni }}</h3>
+                    {%- if education.degree.size > 0 or education.year.size > 0 or education.location.size > 0 -%}
+                        <h4 class="resume-item-details group" itemprop="description">
+                            {%- if education.degree.size > 0 -%}
+                                {{ education.degree }}
+                            {%- endif -%}
+                            {%- if education.year.size > 0 -%}
+                                {% if education.degree.size > 0 %} &bull; {% endif %}
+                                {{ education.year }}
+                            {%- endif -%}
+                            {%- if education.location.size > 0 -%}
+                                {% if education.degree.size > 0 or education.year.size > 0 %} &bull; {% endif %}
+                                {{ education.location }}
+                            {%- endif -%}
+                        </h4>
+                    {%- endif -%}
+
+                    {% if education.award %}
+                        <h5 class="resume-item-details award-title" itemprop="description">{{ education.award }}</h5>
+                    {% endif %}
+
+                    {% if education.awards and education.awards.size > 0 %}
+                    <div class="resume-item-copy" itemprop="description">
+                        <ul class="resume-item-list">
+                            {% for award in education.awards %}
+                                <li>{{ award.award }}</li>
+                            {% endfor %}
+                        </ul>
+                    </div>
+                    {% endif %}
+
+                    {% if education.summary %}
+                        <p class="resume-item-copy">{{ education.summary }}</p>
+                    {% endif %}
+                </div>
+            {% endif %}
+        {% endfor %}
+    </section>
+    <!-- end Education -->
+
+{%- comment -%}
+  Section: Licenses & Certifications
+  - Data: `resume_data.certifications` filtered by `active == true`.
+  - Date Localization: Formats issue and expiration dates with `date-formatter.html` (style="MDY").
+  - Credential Verification: Renders credential ID with optional verification link; wraps the
+    credential ID and the print-only URL fallback in dir="ltr" for RTL locales.
+{%- endcomment -%}
+{% elsif include.section_name == "certifications" and site.resume_section.certifications %}
+    <!-- begin Licenses & Certifications -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.certifications }}</h2>
+        </header>
+
+        {% for certification in resume_data.certifications %}
+            {% if certification.active == true %}
+                <div class="resume-item">
+                    <h3 class="resume-item-title" itemprop="award">{{ certification.name }}</h3>
+                    {%- if certification.issuing_organization.size > 0 or certification.issue_date or certification.credential_id.size > 0 -%}
+                        <h4 class="resume-item-details">
+                            {%- if certification.issuing_organization.size > 0 -%}
+                                {{ certification.issuing_organization }}
+                            {%- endif -%}
+                            {%- if certification.issue_date -%}
+                                {% if certification.issuing_organization.size > 0 %} &bull; {% endif %}
+                                {% include date-formatter.html date=certification.issue_date lang=lang style="MDY" %}
+                                {% if certification.expiration %} &ndash; {% include date-formatter.html date=certification.expiration lang=lang style="MDY" %} {% endif %}
+                            {%- endif -%}
+                            {%- if certification.credential_id.size > 0 -%}
+                                {% if certification.issuing_organization.size > 0 or certification.issue_date %} &bull; {% endif %}
+                                <span class="resume-item-copy-license-cert-id">{{ locale.ui.credential_id }}
+                                {% if certification.credential_url and certification.credential_url != "" %}
+                                    <a href="{{ certification.credential_url }}" target="_blank" rel="noopener nofollow noreferrer"{% if rtl %} dir="ltr"{% endif %}>{{ certification.credential_id }}</a>
+                                    <span class="print-only-inline"{% if rtl %} dir="ltr"{% endif %}>&nbsp;({{ certification.credential_url }})</span>
+                                {% else %}
+                                    <span{% if rtl %} dir="ltr"{% endif %}>{{ certification.credential_id }}</span>
+                                {% endif %}
+                                </span>
+                            {%- endif -%}
+                        </h4>
+                    {%- endif -%}
+                </div>
+            {% endif %}
+        {% endfor %}
+    </section>
+    <!-- end Licenses & Certifications -->
+
+{%- comment -%}
+  Section: Courses
+  - Data: `resume_data.courses` filtered by `active == true`.
+  - Content: Displays course name, issuing organization, date ranges (style="MDY"), summary,
+    and credential ID, with the same RTL dir="ltr" protection as Certifications.
+{%- endcomment -%}
+{% elsif include.section_name == "courses" and site.resume_section.courses %}
+    <!-- begin Courses -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.courses }}</h2>
+        </header>
+
+        {% for course in resume_data.courses %}
+            {% if course.active == true %}
+                <div class="resume-item">
+                    <h3 class="resume-item-title" itemprop="award">{{ course.name }}</h3>
+                    {%- if course.issuing_organization.size > 0 or course.startdate -%}
+                        <h4 class="resume-item-details">
+                            {%- if course.issuing_organization.size > 0 -%}
+                                {{ course.issuing_organization }}
+                            {%- endif -%}
+                            {%- if course.startdate -%}
+                                {% if course.issuing_organization.size > 0 %} &bull; {% endif %}
+                                {% include date-formatter.html date=course.startdate lang=lang style="MDY" %}
+                                {% if course.enddate %} &ndash; {% include date-formatter.html date=course.enddate lang=lang style="MDY" %} {% endif %}
+                            {%- endif -%}
+                        </h4>
+                    {%- endif -%}
+
+                    {% if site.enable_summary == true and course.summary and course.summary != "" %}
+                        <p class="resume-item-copy">{{ course.summary }}</p>
+                    {% endif %}
+
+                    {% if course.credential_id and course.credential_id != "" %}
+                        <p class="resume-item-copy">{{ locale.ui.credential_id }}
+                            {% if course.credential_url and course.credential_url != "" %}
+                                <a href="{{ course.credential_url }}" target="_blank" rel="noopener nofollow noreferrer"{% if rtl %} dir="ltr"{% endif %}>{{ course.credential_id }}</a>
+                                <span class="print-only-inline"{% if rtl %} dir="ltr"{% endif %}>&nbsp;({{ course.credential_url }})</span>
+                            {% else %}
+                                <span{% if rtl %} dir="ltr"{% endif %}>{{ course.credential_id }}</span>
+                            {% endif %}
+                        </p>
+                    {% endif %}
+                </div>
+            {% endif %}
+        {% endfor %}
+    </section>
+    <!-- end Courses -->
+
+{%- comment -%}
+  Section: Volunteering
+  - Data: `resume_data.volunteering` filtered by `active: true`.
+  - Grouping: Groups volunteer positions under the same organization via `group_by: "company"`.
+  - Sorting: Reverse chronological order by `startdate`.
+  - Microdata: Schema.org `Organization` with `worksFor` itemprop.
+{%- endcomment -%}
+{% elsif include.section_name == "volunteering" and site.resume_section.volunteering %}
+    <!-- begin Volunteering -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.volunteering }}</h2>
+        </header>
+
+        {% include grouped-item-list.html items=resume_data.volunteering lang=lang %}
+    </section>
+    <!-- end Volunteering -->
+
+{%- comment -%}
+  Section: Projects
+  - Data: `resume_data.projects` filtered by `active == true`.
+  - Microdata: Schema.org `CreativeWork` with author/creator person metadata.
+  - Links: External project URLs with `target="_blank" rel="noopener nofollow noreferrer"` and
+    inline print URL fallbacks, wrapped in dir="ltr" for RTL locales.
+{%- endcomment -%}
+{% elsif include.section_name == "projects" and site.resume_section.projects %}
+    <!-- begin Projects -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.projects }}</h2>
+        </header>
+
+        {% for project in resume_data.projects %}
+            {% if project.active == true %}
+                <div class="resume-item" itemscope itemtype="http://schema.org/CreativeWork">
+                    <meta itemprop="creator" content="{{ lang_cfg.name }}" itemtype="http://schema.org/Person" />
+                    <h3 class="resume-item-title" itemprop="name" style="display: inline-block;">
+                        {% if project.url and project.url != "" %}
+                            <a href="{{ project.url }}" target="_blank" rel="noopener nofollow noreferrer" itemprop="url">{{ project.project }}</a>
+                        {% else %}
+                            {{ project.project }}
+                        {% endif %}
+                    </h3>
+
+                    {% if project.url and project.url != "" %}
+                        <span class="print-only-inline"{% if rtl %} dir="ltr"{% endif %} style="display: inline;">&nbsp;{{ project.url }}</span>
+                    {% endif %}
+
+                    {%- if project.role.size > 0 or project.duration.size > 0 -%}
+                        <h4 class="resume-item-details" itemprop="description">
+                            {%- if project.role.size > 0 -%}
+                                {{ project.role }}
+                            {%- endif -%}
+                            {%- if project.duration.size > 0 -%}
+                                {% if project.role.size > 0 %} &bull; {% endif %}
+                                {{ project.duration }}
+                            {%- endif -%}
+                        </h4>
+                    {%- endif -%}
+                    <p class="resume-item-copy">{{ project.description }}</p>
+                </div>
+            {% endif %}
+        {% endfor %}
+    </section>
+    <!-- end Projects -->
+
+{%- comment -%}
+  Section: Skills
+  - Data: `resume_data.skills` filtered by `active == true`.
+  - Formatting: Displays categorized competencies and skill descriptions.
+{%- endcomment -%}
+{% elsif include.section_name == "skills" and site.resume_section.skills %}
+    <!-- begin Skills -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.skills }}</h2>
+        </header>
+
+        {% for skill in resume_data.skills %}
+            {% if skill.active == true %}
+                <div class="resume-item">
+                    <h4 class="resume-item-details">{{ skill.skill }}</h4>
+                    {% if skill.description %}
+                        <p class="resume-item-copy">{{ skill.description }}</p>
+                    {% endif %}
+                </div>
+            {% endif %}
+        {% endfor %}
+    </section>
+    <!-- end Skills -->
+
+{%- comment -%}
+  Section: Recognitions / Awards
+  - Data: `resume_data.recognitions` filtered by `active == true`.
+  - Content: Displays award name, issuing organization, year, and summary.
+  - Only the plural `site.resume_section.recognitions` flag is honored.
+{%- endcomment -%}
+{% elsif include.section_name == "recognitions" and site.resume_section.recognitions %}
+    <!-- begin Recognition -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.recognitions }}</h2>
+        </header>
+
+        {% for recognition in resume_data.recognitions %}
+            {% if recognition.active == true %}
+                <div class="resume-item">
+                    <h3 class="resume-item-title" itemprop="award">{{ recognition.award }}</h3>
+                    {%- if recognition.organization.size > 0 or recognition.year.size > 0 -%}
+                        <h4 class="resume-item-details">
+                            {%- if recognition.organization.size > 0 -%}
+                                {{ recognition.organization }}
+                            {%- endif -%}
+                            {%- if recognition.year.size > 0 -%}
+                                {% if recognition.organization.size > 0 %} &bull; {% endif %}
+                                {{ recognition.year }}
+                            {%- endif -%}
+                        </h4>
+                    {%- endif -%}
+                    {% if recognition.summary %}
+                        <p class="resume-item-copy">{{ recognition.summary }}</p>
+                    {% endif %}
+                </div>
+            {% endif %}
+        {% endfor %}
+    </section>
+    <!-- end Recognition -->
+
+{%- comment -%}
+  Section: Associations & Professional Memberships
+  - Data: `resume_data.associations` filtered by `active == true`.
+  - Microdata: Schema.org `Organization` with `memberOf` itemprop.
+  - Links: External organization URLs with print fallback, wrapped in dir="ltr" for RTL locales.
+{%- endcomment -%}
+{% elsif include.section_name == "associations" and site.resume_section.associations %}
+    <!-- begin Associations -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.associations }}</h2>
+        </header>
+
+        {% for association in resume_data.associations %}
+            {% if association.active == true %}
+                <div class="resume-item" itemscope itemprop="memberOf" itemtype="http://schema.org/Organization">
+                    <h3 class="resume-item-title" itemprop="name" style="display: inline-block;">
+                        {% if association.url and association.url != "" %}
+                            <a href="{{ association.url }}" target="_blank" rel="noopener nofollow noreferrer">{{ association.organization }}</a>
+                        {% else %}
+                            {{ association.organization }}
+                        {% endif %}
+                    </h3>
+
+                    {% if association.url and association.url != "" %}
+                        <span class="print-only-inline"{% if rtl %} dir="ltr"{% endif %} style="display: inline;">&nbsp;{{ association.url }}</span>
+                    {% endif %}
+
+                    {%- if association.role.size > 0 or association.year.size > 0 -%}
+                        <h4 class="resume-item-details" itemprop="description">
+                            {%- if association.role.size > 0 -%}
+                                {{ association.role }}
+                            {%- endif -%}
+                            {%- if association.year.size > 0 -%}
+                                {% if association.role.size > 0 %} &bull; {% endif %}
+                                {{ association.year }}
+                            {%- endif -%}
+                        </h4>
+                    {%- endif -%}
+                    {% if association.summary %}
+                        <p class="resume-item-copy">{{ association.summary }}</p>
+                    {% endif %}
+                </div>
+            {% endif %}
+        {% endfor %}
+    </section>
+    <!-- end Associations -->
+
+{%- comment -%}
+  Section: Outside Interests
+  - Data: `resume_data.interests`.
+  - Formatting: Unordered list highlighting personal hobbies and extracurricular activities.
+{%- endcomment -%}
+{% elsif include.section_name == "interests" and site.resume_section.interests %}
+    <!-- begin Interests -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.interests }}</h2>
+        </header>
+
+        <div class="resume-item">
+            <ul class="resume-item-list">
+                {% for interest in resume_data.interests %}
+                    <li>{{ interest.description }}</li>
+                {% endfor %}
+            </ul>
+        </div>
+    </section>
+    <!-- end Interests -->
+
+{%- comment -%}
+  Section: Languages
+  - Display Placement Check: Rendered as a distinct section only if `site.resume_section.lang_header != true`
+    (when lang_header is enabled, languages appear in the resume header instead).
+  - 2-Column Balanced Table: Uses Liquid `modulo: 2` arithmetic to balance entries into rows.
+    Injects an empty `<td class="lang-cell"></td>` on the final odd entry to maintain valid HTML table structure.
+{%- endcomment -%}
+{% elsif include.section_name == "languages" and site.resume_section.languages and site.resume_section.lang_header != true %}
+    <!-- begin Languages -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.languages }}</h2>
+        </header>
+
+        {%- assign active_languages = resume_data.languages | where: "active", true -%}
+        <table class="languages-table">
+            <tbody>
+                {%- for language in active_languages -%}
+                    {%- assign mod = forloop.index0 | modulo: 2 -%}
+                    {%- if mod == 0 -%}
+                        <tr>
+                    {%- endif -%}
+
+                    <td class="lang-cell">
+                        <p class="lang-entry">
+                            <span class="resume-item-details">{{ language.language }}</span>
+                            &ndash;
+                            <span class="resume-item-copy">{{ language.description }}</span>
+                        </p>
+                    </td>
+
+                    {%- if mod == 1 or forloop.last -%}
+                        {%- if forloop.last and mod == 0 -%}
+                            <td class="lang-cell"></td>
+                        {%- endif -%}
+                        </tr>
+                    {%- endif -%}
+                {%- endfor -%}
+            </tbody>
+        </table>
+    </section>
+    <!-- end Languages -->
+
+{%- comment -%}
+  Section: Additional Links
+  - Data: `resume_data.links` filtered by `active == true`.
+  - Print Media: Accompanied by inline plaintext URLs for print readability, wrapped in
+    dir="ltr" for RTL locales.
+{%- endcomment -%}
+{% elsif include.section_name == "links" and site.resume_section.links %}
+    <!-- begin Links -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.links }}</h2>
+        </header>
+
+        <div class="resume-item">
+            <ul class="resume-item-list">
+                {% for link in resume_data.links %}
+                    {% if link.active == true %}
+                        <li>
+                            <a href="{{ link.url }}" target="_blank" rel="noopener nofollow noreferrer" itemprop="url">{{ link.description }}</a>
+                            <span class="print-only-inline"{% if rtl %} dir="ltr"{% endif %}>&nbsp;{{ link.url }}</span>
+                        </li>
+                    {% endif %}
+                {% endfor %}
+            </ul>
+        </div>
+    </section>
+    <!-- end Links -->
+
+{%- comment -%}
+  Section: Publications
+  - Data: `resume_data.publications` filtered by `active == true`.
+  - Content: Name (linked to `url` when present, with a print-only URL fallback in dir="ltr" for
+    RTL locales), publisher and release date (style="MDY"), then the summary (always shown).
+{%- endcomment -%}
+{% elsif include.section_name == "publications" and site.resume_section.publications %}
+    <!-- begin Publications -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.publications }}</h2>
+        </header>
+
+        {% for publication in resume_data.publications %}
+            {% if publication.active == true %}
+                <div class="resume-item" itemscope itemtype="https://schema.org/CreativeWork">
+                    <h3 class="resume-item-title" itemprop="name">
+                        {%- if publication.url and publication.url != "" -%}
+                            <a href="{{ publication.url }}" target="_blank" rel="noopener nofollow noreferrer" itemprop="url">{{ publication.name }}</a>
+                            <span class="print-only-inline"{% if rtl %} dir="ltr"{% endif %}>&nbsp;{{ publication.url }}</span>
+                        {%- else -%}
+                            {{ publication.name }}
+                        {%- endif -%}
+                    </h3>
+                    {%- if publication.publisher.size > 0 or publication.release_date -%}
+                        <h4 class="resume-item-details">
+                            {%- if publication.publisher.size > 0 -%}
+                                <span itemprop="publisher">{{ publication.publisher }}</span>
+                            {%- endif -%}
+                            {%- if publication.release_date -%}
+                                {% if publication.publisher.size > 0 %} &bull; {% endif %}
+                                {% include date-formatter.html date=publication.release_date lang=lang style="MDY" %}
+                            {%- endif -%}
+                        </h4>
+                    {%- endif -%}
+                    {% if publication.summary %}
+                        <p class="resume-item-copy" itemprop="description">{{ publication.summary }}</p>
+                    {% endif %}
+                </div>
+            {% endif %}
+        {% endfor %}
+    </section>
+    <!-- end Publications -->
+
+{%- comment -%}
+  Section: References
+  - Data: `resume_data.references` filtered by `active == true`.
+  - Content: A `<blockquote>` with the reference text and a `<cite>` naming the referee.
+{%- endcomment -%}
+{% elsif include.section_name == "references" and site.resume_section.references %}
+    <!-- begin References -->
+    <section class="content-section">
+        <header class="section-header">
+            <h2>{{ locale.ui.section_titles.references }}</h2>
+        </header>
+
+        {% for reference in resume_data.references %}
+            {% if reference.active == true %}
+                <div class="resume-item">
+                    <blockquote>
+                        <p>{{ reference.reference }}</p>
+                        <cite>{{ reference.name }}</cite>
+                    </blockquote>
+                </div>
+            {% endif %}
+        {% endfor %}
+    </section>
+    <!-- end References -->
+
+{% endif %}

data/_includes/safe-url.html

@@ -0,0 +1,21 @@
+{%- comment -%}
+Include: URL scheme allowlist
+- Purpose: Stop `javascript:`, `data:` and similar schemes in config-supplied URLs reaching href/src.
+- Parameters:
+  - url: The value to check.
+  - schemes: Comma-separated allowed schemes, e.g. "http,https".
+- Output: sets `safe_url` to the trimmed value, or to nil when it is blank or its scheme is not allowed.
+- Rule: a value containing ":" must start with an allowed scheme (case-insensitive); a value without ":"
+  is a relative path and is allowed. Keep in sync with ResumeValidator.safe_url? (same rule, Ruby side).
+{%- endcomment -%}
+{%- assign safe_url = nil -%}
+{%- assign safe_url_raw = include.url | append: "" | strip -%}
+{%- if safe_url_raw contains ":" -%}
+  {%- assign safe_url_scheme = safe_url_raw | split: ":" | first | downcase -%}
+  {%- assign safe_url_allowed = include.schemes | split: "," -%}
+  {%- if safe_url_allowed contains safe_url_scheme -%}
+    {%- assign safe_url = safe_url_raw -%}
+  {%- endif -%}
+{%- elsif safe_url_raw != "" -%}
+  {%- assign safe_url = safe_url_raw -%}
+{%- endif -%}

data/_includes/shared-head.html

@@ -0,0 +1,51 @@
+{%- comment -%}
+  Shared Head Include
+  - Injected by all layouts (`resume.html`, `default.html`, `profile.html`, `error.html`).
+  - Responsiveness & Charset: Configures UTF-8, edge compatibility, and responsive viewport with viewport-fit=cover for mobile screens.
+  - Anti-FOUC Theme Initialization: Synchronously evaluates `localStorage` before page paint to set `data-color-scheme` and `data-theme` on the root <html> element, preventing light-mode flash for dark-mode users.
+  - Favicon Suite: Resolves multi-resolution favicons and web manifest with fallback to defaults and `relative_url` filtering.
+  - Robots Indexing: Conditionally emits noindex directives if `page.noindex == true` (e.g. for error pages).
+{%- endcomment -%}
+<meta charset="UTF-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
+<meta name="color-scheme" content="light dark">
+{% if page.layout == 'resume' %}
+  {% assign json_resume_lang = page.lang | default: site.default_lang | default: 'en' %}
+  {% assign json_resume_route = site.json_resume_routes[json_resume_lang] %}
+  {% if json_resume_route %}
+<link rel="alternate" type="application/json" href="{{ json_resume_route | relative_url | escape }}" hreflang="{{ json_resume_lang | escape }}">
+  {% endif %}
+{% endif %}
+<script>
+  (function() {
+    try {
+      var saved = localStorage.getItem('color-scheme');
+      if (saved === 'dark' || saved === 'light') {
+        document.documentElement.setAttribute('data-color-scheme', saved);
+        document.documentElement.setAttribute('data-theme', saved);
+        var meta = document.querySelector('meta[name="color-scheme"]');
+        if (meta) {
+          meta.setAttribute('content', saved);
+        }
+      }
+    } catch (e) {
+      // Graceful fallback if localStorage is restricted (private browsing / iframe sandboxing)
+    }
+  })();
+</script>
+
+<!-- Favicons -->
+{% assign favicon_path = site.favicon | default: 'assets/favicon/resume/favicon.ico' %}
+<link rel="shortcut icon" href="{{ favicon_path | relative_url }}" type="image/x-icon">
+<link rel="icon" href="{{ favicon_path | relative_url }}" type="image/x-icon">
+<link rel="apple-touch-icon" sizes="180x180" href="{{ site.apple_touch_icon | default: 'assets/favicon/resume/apple-touch-icon.png' | relative_url }}">
+<link rel="icon" type="image/png" sizes="32x32" href="{{ site.favicon_32 | default: 'assets/favicon/resume/favicon-32x32.png' | relative_url }}">
+<link rel="icon" type="image/png" sizes="16x16" href="{{ site.favicon_16 | default: 'assets/favicon/resume/favicon-16x16.png' | relative_url }}">
+<link rel="manifest" href="{{ 'assets/favicon/resume/site.webmanifest' | relative_url }}">
+
+{% if page.noindex == true -%}
+<meta name="robots" content="noindex noarchive nosnippet noimageindex">
+{%- else -%}
+<meta name="robots" content="all">
+{%- endif -%}