unaltraweb 0.3.0

data/_layouts/post.liquid

@@ -0,0 +1,95 @@
+---
+layout: default
+---
+{% assign year = page.date | date: '%Y' %}
+{% assign tags = page.tags | join: '' %}
+{% assign categories = page.categories | join: '' %}
+
+{% capture created_on_text %}{% include t.liquid key='post.created_on' default='Created on' %}{% endcapture %}
+{% capture by_text %}{% include t.liquid key='post.by' default='by' %}{% endcapture %}
+{% capture updated_on_text %}{% include t.liquid key='post.last_updated_on' default='last updated on' %}{% endcapture %}
+{% capture references_text %}{% include t.liquid key='post.references' default='References' %}{% endcapture %}
+{% capture published_date %}{% include localized-date.liquid date=page.date format_key='date.formats.long' default_format='%B %-d, %Y' %}{% endcapture %}
+{% if page.last_updated %}
+  {% capture updated_date %}{% include localized-date.liquid date=page.last_updated format_key='date.formats.long' default_format='%B %-d, %Y' %}{% endcapture %}
+{% endif %}
+{% capture reading_time_html %}{% include post-reading-time.liquid item=page content=content %}{% endcapture %}
+{% assign reading_time_html = reading_time_html | strip %}
+
+{% if page._styles %}
+  <style type="text/css">
+    {{ page._styles }}
+  </style>
+{% endif %}
+
+<div class="post">
+  <header class="post-header">
+    <h1 class="post-title">{{ page.title }}</h1>
+    <p class="post-meta">
+      {{ created_on_text | strip }} {{ published_date | strip }}
+      {% if page.author %}{{ by_text | strip }} {{ page.author }}{% endif %}
+      {% if page.last_updated %}, {{ updated_on_text | strip }} {{ updated_date | strip }}{% endif %}
+      {% if reading_time_html != '' %} • {{ reading_time_html }}{% endif %}
+      {% if page.meta %}• {{ page.meta }}{% endif %}
+    </p>
+    <p class="post-tags">
+      <i class="fa-solid fa-calendar fa-sm"></i> {{ year }}
+
+      {% if tags != '' %}
+        &nbsp; &middot; &nbsp;
+        {% for tag in page.tags %}
+          <i class="fa-solid fa-hashtag fa-sm"></i> {{ tag }}
+          {% unless forloop.last %}
+            &nbsp;
+          {% endunless %}
+        {% endfor %}
+      {% endif %}
+
+      {% if categories != '' %}
+        &nbsp; &middot; &nbsp;
+        {% for category in page.categories %}
+          <i class="fa-solid fa-tag fa-sm"></i> {{ category }}
+          {% unless forloop.last %}
+            &nbsp;
+          {% endunless %}
+        {% endfor %}
+      {% endif %}
+    </p>
+  </header>
+
+  <article class="post-content">
+    {% if page.toc and page.toc.beginning %}
+      <div id="table-of-contents">
+        {% toc %}
+      </div>
+      <hr>
+    {% endif %}
+    <div id="markdown-content">
+      {{ content }}
+    </div>
+  </article>
+
+  {% if page.citation %}
+    {% include citation.liquid %}
+  {% endif %}
+
+  {% if page.related_publications %}
+    <h2>{{ references_text | strip }}</h2>
+    <div class="publications">
+      {% bibliography --group_by none --cited %}
+    </div>
+  {% endif %}
+
+  {% if site.related_blog_posts and site.related_blog_posts.enabled %}
+    {% if page.related_posts == null or page.related_posts %}
+      {% include related_posts.liquid %}
+    {% endif %}
+  {% endif %}
+
+  {% if site.disqus_shortname and page.disqus_comments %}
+    {% include disqus.liquid %}
+  {% endif %}
+  {% if site.giscus and page.giscus_comments %}
+    {% include giscus.liquid %}
+  {% endif %}
+</div>

data/_layouts/profile.liquid

@@ -0,0 +1,36 @@
+---
+layout: default
+---
+
+<div class="post profile-page">
+  {% assign profile_author = page.author | default: site.author %}
+  {% assign current_lang = page.lang | default: site.default_lang | default: site.lang %}
+  {% assign profile_author_name_key = 'name_' | append: current_lang %}
+  {% assign profile_author_name = profile_author[profile_author_name_key] | default: profile_author.name | default: '' %}
+  {% assign show_profile_title = true %}
+  {% if page.hide_title or page.title == profile_author_name %}
+    {% assign show_profile_title = false %}
+  {% endif %}
+
+  {% if show_profile_title or page.description %}
+    <header class="post-header">
+      {% if show_profile_title %}<h1 class="post-title">{{ page.title }}</h1>{% endif %}
+      {% if page.description %}<p class="post-description">{{ page.description }}</p>{% endif %}
+    </header>
+  {% endif %}
+
+  {% if profile_author %}
+    <div class="profile-page-grid">
+      <div class="profile-page-sidebar">
+        {% include profile-card.liquid author=profile_author %}
+      </div>
+      <article class="profile-page-content">
+        {{ content }}
+      </article>
+    </div>
+  {% else %}
+    <article class="profile-page-content">
+      {{ content }}
+    </article>
+  {% endif %}
+</div>

data/_layouts/profiles.liquid

@@ -0,0 +1,36 @@
+---
+layout: page
+---
+<div class="post">
+  <article>
+    {% if page.profiles %}
+      {% for profile in page.profiles %}
+        <hr>
+        <div class="profile float-{% if profile.align == 'left' %}left{% else %}right{% endif %}">
+          {% if profile.image %}
+            {% assign profile_image_path = profile.image | prepend: 'assets/img/' %}
+            {% if profile.image_circular %}
+              {% assign profile_image_class = 'img-fluid z-depth-1 rounded-circle' %}
+            {% else %}
+              {% assign profile_image_class = 'img-fluid z-depth-1 rounded' %}
+            {% endif %}
+            {% capture sizes %}(min-width: {{ site.max_width }}) {{ site.max_width | minus: 30 | times: 0.3}}px, (min-width: 576px) 30vw, 95vw"{% endcapture %}
+            {% include figure.liquid loading="eager" path=profile_image_path class=profile_image_class sizes=sizes alt=profile.image %}
+          {% endif %}
+          {% if profile.more_info %}
+            <div class="more-info">{{ profile.more_info }}</div>
+          {% endif %}
+        </div>
+
+        <div class="clearfix">
+          {% if profile.content %}
+            {% capture profile_content %}{% include_relative {{ profile.content }} %}{% endcapture %}
+            {{ profile_content | markdownify }}
+          {% else %}
+            {{ content }}
+          {% endif %}
+        </div>
+      {% endfor %}
+    {% endif %}
+  </article>
+</div>

data/_layouts/project.liquid

@@ -0,0 +1,7 @@
+---
+layout: page
+---
+
+{% include project-resources.liquid project=page variant='page' %}
+
+{{ content }}

data/_layouts/repositories.liquid

@@ -0,0 +1,58 @@
+---
+layout: page
+---
+{{ content }}
+
+{% capture github_users_text %}{% include t.liquid key='repositories.github_users' default='GitHub users' %}{% endcapture %}
+{% capture github_repositories_text %}{% include t.liquid key='repositories.github_repositories' default='GitHub repositories' %}{% endcapture %}
+{% capture empty_repositories_text %}{% include t.liquid key='repositories.empty' default='Add GitHub users or repositories in `_data/repositories.yml` to populate this section.' %}{% endcapture %}
+
+{% assign has_github_users = false %}
+{% if site.data.repositories.github_users and site.data.repositories.github_users.size > 0 %}
+  {% assign has_github_users = true %}
+{% endif %}
+
+{% assign has_github_repos = false %}
+{% if site.data.repositories.github_repos and site.data.repositories.github_repos.size > 0 %}
+  {% assign has_github_repos = true %}
+{% endif %}
+
+{% if has_github_users %}
+  <h2>{{ github_users_text | strip }}</h2>
+
+  <div class="repositories d-flex flex-wrap flex-md-row flex-column justify-content-between align-items-center">
+    {% for user in site.data.repositories.github_users %}
+      {% include repository/repo_user.liquid username=user %}
+    {% endfor %}
+  </div>
+
+  {% if site.repo_trophies.enabled %}
+    <hr>
+    {% for user in site.data.repositories.github_users %}
+      {% if site.data.repositories.github_users.size > 1 %}
+        <h3>{{ user }}</h3>
+      {% endif %}
+      <div class="repositories d-flex flex-wrap flex-md-row flex-column justify-content-between align-items-center">
+        {% include repository/repo_trophies.liquid username=user %}
+      </div>
+
+      {% unless forloop.last %}
+        <hr>
+      {% endunless %}
+    {% endfor %}
+  {% endif %}
+{% endif %}
+
+{% if has_github_repos %}
+  <h2>{{ github_repositories_text | strip }}</h2>
+
+  <div class="repositories d-flex flex-wrap flex-md-row flex-column justify-content-between align-items-center">
+    {% for repo in site.data.repositories.github_repos %}
+      {% include repository/repo.liquid repository=repo %}
+    {% endfor %}
+  </div>
+{% endif %}
+
+{% unless has_github_users or has_github_repos %}
+  <p>{{ empty_repositories_text | strip }}</p>
+{% endunless %}

data/_layouts/theses.liquid

@@ -0,0 +1,126 @@
+---
+layout: page
+---
+
+{%- assign current_lang = page.lang | default: site.default_lang | default: site.lang -%}
+{%- assign theses_for_lang = site.theses | where: "lang", current_lang -%}
+{%- assign theses_without_lang = site.theses | where_exp: "thesis", "thesis.lang == nil" -%}
+{%- if theses_for_lang and theses_for_lang.size > 0 -%}
+  {%- assign theses_to_show = theses_for_lang | concat: theses_without_lang -%}
+{%- else -%}
+  {%- assign theses_to_show = theses_without_lang -%}
+{%- endif -%}
+{%- assign theses_sorted = theses_to_show | sort: "order" -%}
+
+{% capture empty_text %}{% include t.liquid key='theses.empty' default='No theses found yet.' %}{% endcapture %}
+{% capture student_text %}{% include t.liquid key='theses.student' default='Student' %}{% endcapture %}
+{% capture status_text %}{% include t.liquid key='theses.status' default='Status' %}{% endcapture %}
+{% capture institution_text %}{% include t.liquid key='theses.institution' default='Institution' %}{% endcapture %}
+{% capture year_text %}{% include t.liquid key='theses.year' default='Year' %}{% endcapture %}
+{% capture supervisors_text %}{% include t.liquid key='theses.supervisors' default='Supervisors' %}{% endcapture %}
+{% capture image_source_text %}{% include t.liquid key='theses.image_source' default='Source' %}{% endcapture %}
+
+{{ content }}
+
+{%- if theses_sorted == nil or theses_sorted.size == 0 -%}
+  <p>{{ empty_text | strip }}</p>
+{%- endif -%}
+
+{%- for t in theses_sorted -%}
+  <hr>
+
+  {%- assign title_key = "title_" | append: current_lang -%}
+  {%- assign summary_key = "summary_" | append: current_lang -%}
+  {%- assign institution_key = "institution_" | append: current_lang -%}
+  {%- assign more_info_key = "more_info_" | append: current_lang -%}
+  {%- assign status_key = "status_" | append: current_lang -%}
+  {%- assign image_alt_key = "image_alt_" | append: current_lang -%}
+  {%- assign image_caption_key = "image_caption_" | append: current_lang -%}
+  {%- assign image_source_key = "image_source_" | append: current_lang -%}
+
+  {%- assign localized_title = t[title_key] | default: t.title -%}
+  {%- assign localized_institution = t[institution_key] | default: t.institution -%}
+  {%- assign localized_more_info = t[more_info_key] | default: t.more_info -%}
+  {%- assign localized_status_raw = t[status_key] | default: t.status -%}
+  {%- assign localized_image_alt = t[image_alt_key] | default: t.image_alt | default: t.student -%}
+  {%- assign localized_image_caption = t[image_caption_key] | default: t.image_caption -%}
+  {%- assign localized_image_source = t[image_source_key] | default: t.image_source -%}
+  {%- assign image_source_url = t.image_source_url -%}
+  {%- assign image_source_domain = nil -%}
+  {%- if image_source_url -%}
+    {%- assign image_source_domain = image_source_url | replace: 'https://', '' | replace: 'http://', '' | split: '/' | first -%}
+  {%- endif -%}
+
+  {%- assign status_i18n_key = "theses.status_values." | append: localized_status_raw -%}
+  {% capture localized_status %}{% include t.liquid key=status_i18n_key default=localized_status_raw %}{% endcapture %}
+
+  {%- assign align = t.align | default: "right" -%}
+  <div class="profile float-{% if align == 'left' %}left{% else %}right{% endif %}">
+
+    {%- if t.image -%}
+      {%- if t.image contains '://' -%}
+        {%- assign profile_image_path = t.image -%}
+      {%- else -%}
+        {%- assign profile_image_path = t.image | prepend: 'assets/img/' -%}
+      {%- endif -%}
+
+      {%- if t.image_circular -%}
+        {%- assign profile_image_class = 'img-fluid z-depth-1 rounded-circle' -%}
+      {%- else -%}
+        {%- assign profile_image_class = 'img-fluid z-depth-1 rounded' -%}
+      {%- endif -%}
+
+      {%- capture sizes -%}
+        (min-width: {{ site.max_width }}) {{ site.max_width | minus: 30 | times: 0.3 }}px,
+        (min-width: 576px) 30vw,
+        95vw
+      {%- endcapture -%}
+
+      {%- capture thesis_image_caption -%}
+        {%- if localized_image_caption -%}
+          {{ localized_image_caption }}
+        {%- endif -%}
+        {%- if localized_image_source or image_source_url -%}
+          {%- if localized_image_caption -%} {% endif -%}
+          <span class="thesis-image-source">
+            {{ image_source_text | strip }}:
+            {%- if image_source_url -%}
+              <a href="{{ image_source_url }}" target="_blank" rel="noopener noreferrer">
+                {{ localized_image_source | default: image_source_domain }}
+              </a>
+            {%- else -%}
+              {{ localized_image_source }}
+            {%- endif -%}
+          </span>
+        {%- endif -%}
+      {%- endcapture -%}
+
+      {%- if t.image contains '://' -%}
+        {% include figure.liquid url=profile_image_path class=profile_image_class sizes=sizes alt=localized_image_alt caption=thesis_image_caption loading="lazy" avoid_scaling=true %}
+      {%- else -%}
+        {% include figure.liquid path=profile_image_path class=profile_image_class sizes=sizes alt=localized_image_alt caption=thesis_image_caption loading="lazy" %}
+      {%- endif -%}
+    {%- endif -%}
+
+    {%- if localized_more_info -%}
+      <div class="more-info">{{ localized_more_info }}</div>
+    {%- endif -%}
+  </div>
+
+  <div class="clearfix">
+    {%- if localized_title -%}<h2>{{ localized_title }}</h2>{%- endif -%}
+    {%- if t.student -%}<p><strong>{{ student_text | strip }}:</strong> {{ t.student }}</p>{%- endif -%}
+    {%- if localized_status_raw -%}<p><strong>{{ status_text | strip }}:</strong> {{ localized_status | strip }}</p>{%- endif -%}
+    {%- if localized_institution -%}<p><strong>{{ institution_text | strip }}:</strong> {{ localized_institution }}</p>{%- endif -%}
+    {%- if t.year -%}<p><strong>{{ year_text | strip }}:</strong> {{ t.year }}</p>{%- endif -%}
+    {%- if t.supervisors -%}<p><strong>{{ supervisors_text | strip }}:</strong> {{ t.supervisors }}</p>{%- endif -%}
+
+    {%- if t[summary_key] -%}
+      {{ t[summary_key] | markdownify }}
+    {%- elsif t.summary -%}
+      {{ t.summary | markdownify }}
+    {%- else -%}
+      {{ t.content }}
+    {%- endif -%}
+  </div>
+{%- endfor -%}

data/_plugins/bibliography_profiles.rb

@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+require "cgi"
+require "jekyll/scholar"
+
+module Unaltraweb
+  module BibliographyProfiles
+    PROFILE_SORTS = {
+      "unaltreselfie" => {
+        "sort_by" => %w[year month name title],
+        "order" => %w[descending descending ascending ascending],
+        "group_by" => "year",
+        "group_order" => "descending"
+      },
+      "unaltreprojecte" => {
+        "sort_by" => %w[year month name title],
+        "order" => %w[descending descending ascending ascending],
+        "group_by" => "year",
+        "group_order" => "descending"
+      },
+      "unaltremanual" => {
+        "sort_by" => %w[name year title],
+        "order" => %w[ascending ascending ascending],
+        "group_by" => "none",
+        "group_order" => "ascending",
+        "query" => "@*",
+        "source" => "_bibliography"
+      }
+    }.freeze
+
+    module_function
+
+    def configure(site)
+      profile = site.config.dig("unaltraweb", "site_profile").to_s
+      settings = PROFILE_SORTS[profile]
+      return unless settings
+
+      site.config["scholar"] ||= {}
+      site.config["scholar"].merge!(settings)
+      if profile == "unaltremanual"
+        manual = site.config.dig("unaltraweb", "manual") || {}
+        manual = {} unless manual.is_a?(Hash)
+        bibliography = (manual["bibliography_file"] || "manual.bib").to_s.strip
+        unless bibliography.match?(/\A[A-Za-z0-9][A-Za-z0-9_.-]*\.bib\z/) && File.basename(bibliography) == bibliography
+          raise Jekyll::Errors::FatalException, "unaltraweb.manual.bibliography_file must be a .bib filename under _bibliography/"
+        end
+        validate_bibliography_location(site, bibliography)
+        site.config["scholar"]["bibliography"] = bibliography
+      end
+    end
+
+    def validate_bibliography_location(site, bibliography)
+      return unless site.respond_to?(:source) && site.source
+
+      source = File.realpath(site.source)
+      root = File.join(source, "_bibliography")
+      return unless File.exist?(root) || File.symlink?(root)
+
+      resolved_root = File.realpath(root)
+      target = File.join(root, bibliography)
+      resolved_target = if File.exist?(target) || File.symlink?(target)
+                          File.realpath(target)
+                        else
+                          target
+                        end
+      root_prefix = resolved_root.end_with?(File::SEPARATOR) ? resolved_root : "#{resolved_root}#{File::SEPARATOR}"
+      source_prefix = source.end_with?(File::SEPARATOR) ? source : "#{source}#{File::SEPARATOR}"
+      confined = (resolved_root == source || resolved_root.start_with?(source_prefix)) && resolved_target.start_with?(root_prefix)
+      return if confined
+
+      raise Jekyll::Errors::FatalException, "unaltraweb.manual.bibliography_file must remain under the site's _bibliography/ directory"
+    rescue Errno::ENOENT, Errno::ELOOP
+      raise Jekyll::Errors::FatalException, "unaltraweb.manual.bibliography_file must resolve safely under _bibliography/"
+    end
+
+    def strip_web_access(reference, doi = nil, *urls)
+      rendered = reference.to_s.dup
+      variants = access_variants(doi, *urls).sort_by { |value| -value.length }
+      loop do
+        previous = rendered.dup
+        variants.each do |value|
+          escaped = Regexp.escape(value)
+          rendered.sub!(%r{\s*(?:doi:\s*)?(?:<a\b[^>]*>\s*)?#{escaped}(?:\s*</a>)?\s*\.?(?=(?:\s*</[a-z][^>]*>)*\s*\z)}i, "")
+        end
+        break if rendered == previous
+      end
+      rendered.rstrip
+    end
+
+    def access_variants(doi, *urls)
+      values = []
+      normalized_doi = doi.to_s.strip.sub(%r{\Ahttps?://(?:dx\.)?doi\.org/}i, "").sub(/\Adoi:\s*/i, "")
+      unless normalized_doi.empty?
+        values.concat([
+          "https://doi.org/#{normalized_doi}",
+          "http://doi.org/#{normalized_doi}",
+          "http://dx.doi.org/#{normalized_doi}",
+          "doi:#{normalized_doi}",
+          normalized_doi
+        ])
+      end
+      urls.each { |url| values << url.to_s.strip unless url.to_s.strip.empty? }
+      values.flat_map { |value| [value, CGI.escapeHTML(value)] }.uniq
+    end
+
+    def strip_reference_ids(reference)
+      reference.to_s.gsub(/\s+id=(['"])[^'"]*\1/i, "")
+    end
+
+    def escape_liquid_markers(value)
+      value.to_s.gsub("{{", "<span>{</span>{").gsub("{%", "<span>{</span>%")
+    end
+
+    def fold_sort_value(value)
+      BibTeX::Value.new(value.to_s).convert(:latex).to_s.unicode_normalize(:nfkd).gsub(/\p{Mn}/, "")
+    end
+  end
+
+  module ScholarProfileRendering
+    def resolve_sort_value(entry, key)
+      value = super
+      return value unless key == "name" && unaltraweb_profile_sorting?
+
+      BibTeX::Value.new(BibliographyProfiles.fold_sort_value(value))
+    end
+
+    def render_bibliography(entry, index = nil)
+      citation_numbers = context && context["citation_numbers"]
+      if index && unaltraweb_profile_sorting? && citation_numbers&.key?(entry.key) && unaltraweb_numeric_bibliography_style?
+        index = citation_numbers[entry.key]
+      end
+      super(entry, index)
+    end
+
+    private
+
+    def unaltraweb_profile_sorting?
+      BibliographyProfiles::PROFILE_SORTS.key?(site&.config&.dig("unaltraweb", "site_profile").to_s)
+    end
+
+    def unaltraweb_numeric_bibliography_style?
+      @unaltraweb_numeric_bibliography_styles ||= {}
+      @unaltraweb_numeric_bibliography_styles[style] ||= styles(style).to_xml.include?('variable="citation-number"')
+    end
+  end
+
+  module BibliographyProfileFilters
+    def stripBibliographyAccess(input, doi = nil, *urls)
+      BibliographyProfiles.strip_web_access(input, doi, *urls)
+    end
+
+    def stripBibliographyIds(input)
+      BibliographyProfiles.strip_reference_ids(input)
+    end
+
+    def escapeLiquidMarkers(input)
+      BibliographyProfiles.escape_liquid_markers(input)
+    end
+  end
+end
+
+Jekyll::Scholar::Utilities.prepend(Unaltraweb::ScholarProfileRendering) unless Jekyll::Scholar::Utilities.ancestors.include?(Unaltraweb::ScholarProfileRendering)
+Liquid::Template.register_filter(Unaltraweb::BibliographyProfileFilters)
+Jekyll::Hooks.register(:site, :post_read) { |site| Unaltraweb::BibliographyProfiles.configure(site) }

data/_plugins/callouts.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require "nokogiri"
+
+module Unaltraweb
+  module Callouts
+    module_function
+
+    TYPES = %w[info example warning objectives danger].freeze
+    DEFAULT_LABELS = {
+      "ca" => {
+        "info" => "NOTA",
+        "example" => "EXEMPLE",
+        "warning" => "ADVERTÈNCIA",
+        "objectives" => "OBJECTIUS D'APRENENTATGE",
+        "danger" => "ATENCIÓ"
+      },
+      "es" => {
+        "info" => "NOTA",
+        "example" => "EJEMPLO",
+        "warning" => "ADVERTENCIA",
+        "objectives" => "OBJETIVOS DE APRENDIZAJE",
+        "danger" => "ATENCIÓN"
+      },
+      "en" => {
+        "info" => "NOTE",
+        "example" => "EXAMPLE",
+        "warning" => "WARNING",
+        "objectives" => "LEARNING OBJECTIVES",
+        "danger" => "CAUTION"
+      }
+    }.freeze
+
+    def transform_html(html, site:, lang:)
+      source = html.to_s
+      return source unless source.match?(/<blockquote(?:\s|>)/i)
+
+      fragment = Nokogiri::HTML::DocumentFragment.parse(source)
+      labels = labels_for(site, lang)
+
+      fragment.css("blockquote").each do |blockquote|
+        if blockquote.element_children.any? { |child| child.name == "blockquote" }
+          add_classes(blockquote, "uw-callout-wrapper")
+          next
+        end
+
+        depth = blockquote.ancestors("blockquote").length
+        next if depth.zero?
+
+        type = TYPES[[depth, TYPES.length].min - 1]
+        add_classes(blockquote, "uw-callout", "uw-callout-#{type}")
+        blockquote["data-callout"] = type
+        add_title(blockquote, labels.fetch(type))
+      end
+
+      fragment.to_html
+    end
+
+    def detect_lang(doc)
+      configured = doc.data["lang"].to_s
+      return normalize_lang(configured) unless configured.empty?
+
+      relative_path = doc.respond_to?(:relative_path) ? doc.relative_path.to_s : ""
+      path_lang = relative_path.tr("\\", "/").split("/")[1].to_s
+      fallback = doc.site.config["default_lang"] || doc.site.config["lang"] || "en"
+      normalize_lang(path_lang.empty? ? fallback : path_lang)
+    end
+
+    def labels_for(site, lang)
+      normalized_lang = normalize_lang(lang)
+      default_lang = normalize_lang(site.config["default_lang"] || site.config["lang"] || "en")
+      i18n = site.data["i18n"] || {}
+      configured = i18n.dig(normalized_lang, "callouts") || i18n.dig(default_lang, "callouts") || {}
+      defaults = DEFAULT_LABELS[normalized_lang] || DEFAULT_LABELS[default_lang] || DEFAULT_LABELS.fetch("en")
+
+      defaults.merge(configured.transform_keys(&:to_s).transform_values(&:to_s))
+    end
+
+    def normalize_lang(lang)
+      lang.to_s.downcase.split("-").first.to_s.then { |value| value.empty? ? "en" : value }
+    end
+
+    def add_classes(node, *classes)
+      current = node["class"].to_s.split
+      node["class"] = (current + classes).uniq.join(" ")
+    end
+
+    def add_title(blockquote, label)
+      existing = blockquote.element_children.first
+      return if existing && existing["class"].to_s.split.include?("uw-callout-title")
+
+      title = Nokogiri::XML::Node.new("p", blockquote.document)
+      title["class"] = "uw-callout-title"
+      title["data-unaltraweb-callout-title"] = "true"
+      title.content = label
+      blockquote.prepend_child(title)
+    end
+  end
+end
+
+Jekyll::Hooks.register %i[documents pages], :post_convert do |doc|
+  lang = Unaltraweb::Callouts.detect_lang(doc)
+  doc.content = Unaltraweb::Callouts.transform_html(doc.content, site: doc.site, lang: lang)
+end