jekyll-theme-zer0 0.15.0 → 0.16.0

data/_data/ui-text.yml

@@ -0,0 +1,321 @@
+# User interface text and labels
+# Used by: Various includes and layouts throughout the theme
+# Purpose: Multilingual UI strings for internationalization (i18n)
+
+# English (default)
+# -----------------
+en: &DEFAULT_EN
+  skip_links                 : "Skip links"
+  skip_primary_nav           : "Skip to primary navigation"
+  skip_content               : "Skip to content"
+  skip_footer                : "Skip to footer"
+  page                       : "Page"
+  pagination_previous        : "Previous"
+  pagination_next            : "Next"
+  breadcrumb_home_label      : "Home"
+  breadcrumb_separator       : "/"
+  menu_label                 : "Toggle menu"
+  search_label               : "Toggle search"
+  toc_label                  : "On this page"
+  ext_link_label             : "Direct link"
+  less_than                  : "less than"
+  minute_read                : "minute read"
+  share_on_label             : "Share on"
+  meta_label                 :
+  tags_label                 : "Tags:"
+  categories_label           : "Categories:"
+  date_label                 : "Updated:"
+  author_label               : "Author:"
+  comments_label             : "Leave a comment"
+  comments_title             : "Comments"
+  more_label                 : "Learn more"
+  related_label              : "You may also enjoy"
+  follow_label               : "Follow:"
+  feed_label                 : "Feed"
+  powered_by                 : "Powered by"
+  website_label              : "Website"
+  email_label                : "Email"
+  recent_posts               : "Recent posts"
+  undefined_wpm              : "Undefined parameter words_per_minute at _config.yml"
+  comment_form_info          : "Your email address will not be published. Required fields are marked"
+  comment_form_comment_label : "Comment"
+  comment_form_md_info       : "Markdown is supported."
+  comment_form_name_label    : "Name"
+  comment_form_email_label   : "Email address"
+  comment_form_website_label : "Website (optional)"
+  comment_btn_submit         : "Submit comment"
+  comment_btn_submitted      : "Submitted"
+  comment_success_msg        : "Thanks for your comment! It will show on the site once it has been approved."
+  comment_error_msg          : "Sorry, there was an error with your submission. Please make sure all required fields have been completed and try again."
+  loading_label              : "Loading..."
+  search_label_text          : "Enter your search term..."
+  search_placeholder_text    : "Enter your search term..."
+  search_algolia_no_results  : "No results"
+  results_found              : "Result(s) found"
+  back_to_top                : "Back to top"
+  # Statistics labels
+  stats_total_posts          : "Total Posts"
+  stats_total_pages          : "Total Pages"
+  stats_categories           : "Categories"
+  stats_tags                 : "Tags"
+  stats_last_updated         : "Last Updated"
+  stats_overview             : "Overview"
+  stats_content_breakdown    : "Content Breakdown"
+  # Theme-specific labels
+  theme_toggle               : "Toggle theme"
+  dark_mode                  : "Dark mode"
+  light_mode                 : "Light mode"
+  view_source                : "View source"
+  edit_page                  : "Edit this page"
+  report_issue               : "Report an issue"
+  
+en-US:
+  <<: *DEFAULT_EN
+en-CA:
+  <<: *DEFAULT_EN
+en-GB:
+  <<: *DEFAULT_EN
+en-AU:
+  <<: *DEFAULT_EN
+
+# Spanish
+# -------
+es: &DEFAULT_ES
+  skip_links                 : "Saltar enlaces"
+  skip_primary_nav           : "Saltar a navegación principal"
+  skip_content               : "Saltar a contenido"
+  skip_footer                : "Saltar a pie"
+  page                       : "Página"
+  pagination_previous        : "Anterior"
+  pagination_next            : "Siguiente"
+  breadcrumb_home_label      : "Inicio"
+  breadcrumb_separator       : "/"
+  menu_label                 : "Alternar menú"
+  search_label               : "Alternar búsqueda"
+  toc_label                  : "En esta página"
+  ext_link_label             : "Enlace directo"
+  less_than                  : "menos de"
+  minute_read                : "minuto(s) de lectura"
+  share_on_label             : "Compartir en"
+  meta_label                 :
+  tags_label                 : "Etiquetas:"
+  categories_label           : "Categorías:"
+  date_label                 : "Actualizado:"
+  author_label               : "Autor:"
+  comments_label             : "Deja un comentario"
+  comments_title             : "Comentarios"
+  more_label                 : "Ver más"
+  related_label              : "Puede que también te interese"
+  follow_label               : "Seguir:"
+  feed_label                 : "Feed"
+  powered_by                 : "Funciona con"
+  website_label              : "Sitio web"
+  email_label                : "Correo electrónico"
+  recent_posts               : "Entradas recientes"
+  undefined_wpm              : "El parámetro words_per_minute (palabras por minuto) no está definido en _config.yml"
+  comment_form_info          : "Tu dirección de correo electrónico no se publicará. Los campos obligatorios están marcados"
+  comment_form_comment_label : "Comentario"
+  comment_form_md_info       : "Puedes utilizar Markdown"
+  comment_form_name_label    : "Nombre"
+  comment_form_email_label   : "Dirección de correo electrónico"
+  comment_form_website_label : "Sitio web (opcional)"
+  comment_btn_submit         : "Enviar comentario"
+  comment_btn_submitted      : "Enviado"
+  comment_success_msg        : "¡Gracias por tu comentario! Se mostrará en el sitio una vez que haya sido aprobado."
+  comment_error_msg          : "Lo sentimos, ha habido un error con tu envío. Por favor, asegúrate de que todos los campos obligatorios se han completado e inténtalo de nuevo."
+  loading_label              : "Cargando..."
+  search_label_text          : "Introduce tu término de búsqueda..."
+  search_placeholder_text    : "Introduce tu término de búsqueda..."
+  search_algolia_no_results  : "Sin resultados"
+  results_found              : "Resultado(s) encontrado(s)"
+  back_to_top                : "Volver arriba"
+  # Statistics labels
+  stats_total_posts          : "Total de Publicaciones"
+  stats_total_pages          : "Total de Páginas"
+  stats_categories           : "Categorías"
+  stats_tags                 : "Etiquetas"
+  stats_last_updated         : "Última Actualización"
+  stats_overview             : "Resumen"
+  stats_content_breakdown    : "Desglose de Contenido"
+  # Theme-specific labels
+  theme_toggle               : "Cambiar tema"
+  dark_mode                  : "Modo oscuro"
+  light_mode                 : "Modo claro"
+  view_source                : "Ver código fuente"
+  edit_page                  : "Editar esta página"
+  report_issue               : "Reportar un problema"
+
+es-ES:
+  <<: *DEFAULT_ES
+es-MX:
+  <<: *DEFAULT_ES
+
+# French
+# ------
+fr: &DEFAULT_FR
+  skip_links                 : "Liens de saut"
+  skip_primary_nav           : "Aller à la navigation principale"
+  skip_content               : "Aller au contenu"
+  skip_footer                : "Aller au pied de page"
+  page                       : "Page"
+  pagination_previous        : "Précédent"
+  pagination_next            : "Suivant"
+  breadcrumb_home_label      : "Accueil"
+  breadcrumb_separator       : "/"
+  menu_label                 : "Basculer le menu"
+  search_label               : "Basculer la recherche"
+  toc_label                  : "Sur cette page"
+  ext_link_label             : "Lien direct"
+  less_than                  : "moins de"
+  minute_read                : "minute(s) de lecture"
+  share_on_label             : "Partager sur"
+  meta_label                 :
+  tags_label                 : "Tags :"
+  categories_label           : "Catégories :"
+  date_label                 : "Mis à jour :"
+  author_label               : "Auteur :"
+  comments_label             : "Laisser un commentaire"
+  comments_title             : "Commentaires"
+  more_label                 : "En savoir plus"
+  related_label              : "Vous pourriez aussi aimer"
+  follow_label               : "Suivre :"
+  feed_label                 : "Flux"
+  powered_by                 : "Propulsé par"
+  website_label              : "Site web"
+  email_label                : "Email"
+  recent_posts               : "Articles récents"
+  back_to_top                : "Retour en haut"
+  # Statistics labels
+  stats_total_posts          : "Total des Publications"
+  stats_total_pages          : "Total des Pages"
+  stats_categories           : "Catégories"
+  stats_tags                 : "Tags"
+  stats_last_updated         : "Dernière Mise à Jour"
+  stats_overview             : "Aperçu"
+  stats_content_breakdown    : "Répartition du Contenu"
+  # Theme-specific labels
+  theme_toggle               : "Changer de thème"
+  dark_mode                  : "Mode sombre"
+  light_mode                 : "Mode clair"
+  view_source                : "Voir la source"
+  edit_page                  : "Modifier cette page"
+  report_issue               : "Signaler un problème"
+
+fr-FR:
+  <<: *DEFAULT_FR
+fr-CA:
+  <<: *DEFAULT_FR
+
+# German
+# ------
+de: &DEFAULT_DE
+  skip_links                 : "Links überspringen"
+  skip_primary_nav           : "Zur Hauptnavigation springen"
+  skip_content               : "Zum Inhalt springen"
+  skip_footer                : "Zur Fußzeile springen"
+  page                       : "Seite"
+  pagination_previous        : "Zurück"
+  pagination_next            : "Weiter"
+  breadcrumb_home_label      : "Startseite"
+  breadcrumb_separator       : "/"
+  menu_label                 : "Menü umschalten"
+  search_label               : "Suche umschalten"
+  toc_label                  : "Auf dieser Seite"
+  ext_link_label             : "Direktlink"
+  less_than                  : "weniger als"
+  minute_read                : "Minute(n) Lesezeit"
+  share_on_label             : "Teilen auf"
+  meta_label                 :
+  tags_label                 : "Tags:"
+  categories_label           : "Kategorien:"
+  date_label                 : "Aktualisiert:"
+  author_label               : "Autor:"
+  comments_label             : "Einen Kommentar hinterlassen"
+  comments_title             : "Kommentare"
+  more_label                 : "Mehr erfahren"
+  related_label              : "Das könnte Sie auch interessieren"
+  follow_label               : "Folgen:"
+  feed_label                 : "Feed"
+  powered_by                 : "Betrieben mit"
+  website_label              : "Webseite"
+  email_label                : "E-Mail"
+  recent_posts               : "Neueste Beiträge"
+  back_to_top                : "Nach oben"
+  # Statistics labels
+  stats_total_posts          : "Gesamte Beiträge"
+  stats_total_pages          : "Gesamte Seiten"
+  stats_categories           : "Kategorien"
+  stats_tags                 : "Tags"
+  stats_last_updated         : "Zuletzt Aktualisiert"
+  stats_overview             : "Übersicht"
+  stats_content_breakdown    : "Inhaltsaufschlüsselung"
+  # Theme-specific labels
+  theme_toggle               : "Thema wechseln"
+  dark_mode                  : "Dunkler Modus"
+  light_mode                 : "Heller Modus"
+  view_source                : "Quelle ansehen"
+  edit_page                  : "Diese Seite bearbeiten"
+  report_issue               : "Ein Problem melden"
+
+de-DE:
+  <<: *DEFAULT_DE
+de-AT:
+  <<: *DEFAULT_DE
+de-CH:
+  <<: *DEFAULT_DE
+
+# Arabic
+# ------
+ar: &DEFAULT_AR
+  skip_links                 : "تخطي الروابط"
+  skip_primary_nav           : "انتقل إلى التنقل الرئيسي"
+  skip_content               : "انتقل إلى المحتوى"
+  skip_footer                : "انتقل إلى التذييل"
+  page                       : "صفحة"
+  pagination_previous        : "السابق"
+  pagination_next            : "التالي"
+  breadcrumb_home_label      : "الرئيسية"
+  breadcrumb_separator       : "/"
+  menu_label                 : "تبديل القائمة"
+  search_label               : "تبديل البحث"
+  toc_label                  : "في هذه الصفحة"
+  ext_link_label             : "رابط مباشر"
+  less_than                  : "أقل من"
+  minute_read                : "دقيقة للقراءة"
+  share_on_label             : "مشاركة على"
+  meta_label                 :
+  tags_label                 : "الوسوم:"
+  categories_label           : "الأقسام:"
+  date_label                 : "تاريخ التحديث:"
+  author_label               : "الكاتب:"
+  comments_label             : "اترك تعليقاً"
+  comments_title             : "التعليقات"
+  more_label                 : "اقرأ المزيد"
+  related_label              : "قد يعجبك أيضاً"
+  follow_label               : "تابعنا:"
+  feed_label                 : "الخلاصة"
+  powered_by                 : "يعمل بواسطة"
+  website_label              : "الموقع"
+  email_label                : "البريد الإلكتروني"
+  recent_posts               : "المنشورات الأخيرة"
+  back_to_top                : "العودة للأعلى"
+  # Statistics labels
+  stats_total_posts          : "إجمالي المنشورات"
+  stats_total_pages          : "إجمالي الصفحات"
+  stats_categories           : "الأقسام"
+  stats_tags                 : "الوسوم"
+  stats_last_updated         : "آخر تحديث"
+  stats_overview             : "نظرة عامة"
+  stats_content_breakdown    : "تفصيل المحتوى"
+  # Theme-specific labels
+  theme_toggle               : "تبديل المظهر"
+  dark_mode                  : "الوضع الداكن"
+  light_mode                 : "الوضع الفاتح"
+  view_source                : "عرض المصدر"
+  edit_page                  : "تحرير هذه الصفحة"
+  report_issue               : "الإبلاغ عن مشكلة"
+
+ar-SA:
+  <<: *DEFAULT_AR
+ar-EG:
+  <<: *DEFAULT_AR

data/_data/update_statistics.sh

@@ -0,0 +1,126 @@
+#!/bin/bash
+
+# Automated Content Statistics Update Script
+# Used by: CI/CD pipelines for automatic statistics updates
+# Purpose: Update statistics and optionally commit changes
+
+set -euo pipefail
+
+# Configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+STATS_FILE="$SCRIPT_DIR/content_statistics.yml"
+
+# Colors for output (if terminal supports it)
+if [[ -t 1 ]]; then
+    RED='\033[0;31m'
+    GREEN='\033[0;32m'
+    YELLOW='\033[1;33m'
+    BLUE='\033[0;34m'
+    NC='\033[0m'
+else
+    RED=''
+    GREEN=''
+    YELLOW=''
+    BLUE=''
+    NC=''
+fi
+
+echo -e "${BLUE}🤖 Automated Content Statistics Update${NC}"
+echo "========================================"
+
+# Check if this is a CI environment
+if [[ "${CI:-false}" == "true" ]]; then
+    echo -e "${YELLOW}🔧 Running in CI environment${NC}"
+    # Set git user for automated commits
+    git config --global user.name "Content Statistics Bot"
+    git config --global user.email "bot@zer0-mistakes.dev"
+fi
+
+# Store current statistics hash if file exists
+CURRENT_HASH=""
+if [[ -f "$STATS_FILE" ]]; then
+    if command -v sha256sum &> /dev/null; then
+        CURRENT_HASH=$(sha256sum "$STATS_FILE" | cut -d' ' -f1)
+    elif command -v shasum &> /dev/null; then
+        CURRENT_HASH=$(shasum -a 256 "$STATS_FILE" | cut -d' ' -f1)
+    fi
+fi
+
+# Generate new statistics
+echo -e "${YELLOW}🔄 Generating updated statistics...${NC}"
+if bash "$SCRIPT_DIR/generate_statistics.sh"; then
+    echo -e "${GREEN}✅ Statistics generated successfully${NC}"
+else
+    echo -e "${RED}❌ Failed to generate statistics${NC}"
+    exit 1
+fi
+
+# Check if statistics have changed
+NEW_HASH=""
+if [[ -f "$STATS_FILE" ]]; then
+    if command -v sha256sum &> /dev/null; then
+        NEW_HASH=$(sha256sum "$STATS_FILE" | cut -d' ' -f1)
+    elif command -v shasum &> /dev/null; then
+        NEW_HASH=$(shasum -a 256 "$STATS_FILE" | cut -d' ' -f1)
+    fi
+fi
+
+if [[ "$CURRENT_HASH" == "$NEW_HASH" ]]; then
+    echo -e "${BLUE}ℹ️  No changes detected in content statistics${NC}"
+    echo "Statistics are up to date."
+    exit 0
+fi
+
+echo -e "${GREEN}📊 Content statistics have been updated${NC}"
+
+# If running in CI, commit the changes
+if [[ "${CI:-false}" == "true" ]]; then
+    echo -e "${YELLOW}📝 Committing updated statistics...${NC}"
+    
+    cd "$PROJECT_ROOT"
+    
+    # Add the updated statistics file
+    git add "$STATS_FILE"
+    
+    # Check if there are changes to commit
+    if git diff --staged --quiet; then
+        echo -e "${BLUE}ℹ️  No changes to commit${NC}"
+    else
+        # Create commit message with timestamp
+        TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
+        
+        # Try to get stats from yq, fallback to N/A
+        TOTAL_POSTS="N/A"
+        PUBLISHED="N/A"
+        CATEGORIES="N/A"
+        
+        if command -v yq &> /dev/null; then
+            TOTAL_POSTS=$(yq '.overview.total_posts' "$STATS_FILE" 2>/dev/null || echo "N/A")
+            PUBLISHED=$(yq '.overview.published' "$STATS_FILE" 2>/dev/null || echo "N/A")
+            CATEGORIES=$(yq '.overview.total_categories' "$STATS_FILE" 2>/dev/null || echo "N/A")
+        fi
+        
+        COMMIT_MSG="🤖 Auto-update content statistics - $TIMESTAMP
+
+- Total posts analyzed: $TOTAL_POSTS
+- Published posts: $PUBLISHED
+- Categories tracked: $CATEGORIES
+
+[skip ci]"
+        
+        git commit -m "$COMMIT_MSG"
+        echo -e "${GREEN}✅ Statistics committed successfully${NC}"
+        
+        # Push if configured
+        if [[ "${AUTO_PUSH:-false}" == "true" ]]; then
+            echo -e "${YELLOW}🚀 Pushing changes...${NC}"
+            git push origin HEAD
+            echo -e "${GREEN}✅ Changes pushed to repository${NC}"
+        fi
+    fi
+fi
+
+echo ""
+echo "=========================="
+echo -e "${GREEN}🎉 Statistics update complete!${NC}"

data/_includes/components/preview-image.html

@@ -9,8 +9,12 @@
        style="height: 180px; object-fit: cover;" 
     -%}
   
-  Convention: All preview paths should be absolute (e.g., /assets/images/preview.png)
-  External URLs (https://...) are also supported.
+  Convention: Preview paths can omit the /assets/ prefix.
+  The component will auto-prepend the assets_prefix from _config.yml.
+  Examples:
+    - /images/previews/my-image.png → /assets/images/previews/my-image.png
+    - /assets/images/previews/my-image.png → unchanged
+    - https://example.com/image.png → unchanged (external URL)
 {% endcomment %}
 {% assign img = include.src | default: site.teaser %}
 {% assign alt = include.alt | default: "Preview image" %}
@@ -18,9 +22,22 @@
 {% assign style = include.style %}
 {% assign loading = include.loading | default: "lazy" %}
 
-{% comment %} External URL or internal path {% endcomment %}
+{% comment %} Get assets prefix configuration {% endcomment %}
+{% assign assets_prefix = site.preview_images.assets_prefix | default: '/assets' %}
+{% assign auto_prefix = site.preview_images.auto_prefix | default: true %}
+
+{% comment %} Determine final image source {% endcomment %}
 {% if img contains '://' %}
+  {% comment %} External URL - use as-is {% endcomment %}
   {% assign final_src = img %}
+{% elsif auto_prefix and img != blank %}
+  {% comment %} Check if path already has the assets prefix {% endcomment %}
+  {% if img contains assets_prefix %}
+    {% assign final_src = img | relative_url %}
+  {% else %}
+    {% comment %} Prepend assets prefix to the path {% endcomment %}
+    {% assign final_src = assets_prefix | append: img | relative_url %}
+  {% endif %}
 {% else %}
   {% assign final_src = img | relative_url %}
 {% endif %}

data/_includes/content/intro.html

@@ -16,12 +16,21 @@
 <!-- Intro Section -->
 
 {% comment %}
-  Determine the preview image path. All preview paths should be absolute
-  starting with /assets/ or external URLs starting with ://
+  Determine the preview image path. Preview paths can omit the /assets/ prefix.
+  The component will auto-prepend the assets_prefix from _config.yml.
 {% endcomment %}
 {% assign preview_image = page.preview | default: site.info_banner %}
+{% assign assets_prefix = site.preview_images.assets_prefix | default: '/assets' %}
+{% assign auto_prefix = site.preview_images.auto_prefix | default: true %}
+
 {% if preview_image contains '://' %}
   {% assign preview_path = preview_image %}
+{% elsif auto_prefix and preview_image != blank %}
+  {% if preview_image contains assets_prefix %}
+    {% assign preview_path = preview_image | relative_url %}
+  {% else %}
+    {% assign preview_path = assets_prefix | append: preview_image | relative_url %}
+  {% endif %}
 {% else %}
   {% assign preview_path = preview_image | relative_url %}
 {% endif %}
@@ -45,23 +54,23 @@
       </button>
       <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="shareDropdownBottom">
         <li>
-          <a class="dropdown-item" href="https://reddit.com/submit?url={{ page.url | absolute_url | url_encode }}&amp;title={{ page.title | url_encode }}" target="_blank">
+          <a class="dropdown-item" href="https://reddit.com/submit?url={{ site.url | append: page.url | url_encode }}&amp;title={{ page.title | url_encode }}" target="_blank">
             <i class="bi bi-reddit me-2"></i>Share on Reddit
           </a>
         </li>
         <li>
-          <a class="dropdown-item" href="https://www.linkedin.com/sharing/share-offsite/?url={{ page.url | absolute_url | url_encode }}" target="_blank">
+          <a class="dropdown-item" href="https://www.linkedin.com/sharing/share-offsite/?url={{ site.url | append: page.url | url_encode }}" target="_blank">
             <i class="bi bi-linkedin me-2"></i>Share on LinkedIn
           </a>
         </li>
         <li>
-          <a class="dropdown-item" href="https://twitter.com/intent/tweet?url={{ page.url | absolute_url | url_encode }}&text={{ page.title | url_encode }}" target="_blank">
+          <a class="dropdown-item" href="https://twitter.com/intent/tweet?url={{ site.url | append: page.url | url_encode }}&text={{ page.title | url_encode }}" target="_blank">
             <i class="bi bi-twitter me-2"></i>Share on Twitter
           </a>
         </li>
         <li><hr class="dropdown-divider"></li>
         <li>
-          <button class="dropdown-item" onclick='navigator.clipboard.writeText("{{ page.url | absolute_url }}"); alert("Link copied to clipboard!");'>
+          <button class="dropdown-item" onclick='navigator.clipboard.writeText("{{ site.url | append: page.url }}"); alert("Link copied to clipboard!");'>
             <i class="bi bi-clipboard me-2"></i>Copy Link
           </button>
         </li>

data/_includes/content/seo.html

@@ -23,8 +23,19 @@
 {%- assign page_large_image = page.header.og_image | default: page.header.overlay_image | default: page.header.image | absolute_url -%}
 {%- assign page_large_image = page_large_image | escape -%}
 
+{%- comment -%} Handle preview image with configurable assets prefix {%- endcomment -%}
 {%- assign page_teaser_image = page.preview | default: site.og_image -%}
-{%- assign page_teaser_image = {{ site.public_folder }}/page_teaser_image | escape -%}
+{%- assign assets_prefix = site.preview_images.assets_prefix | default: '/assets' -%}
+{%- assign auto_prefix = site.preview_images.auto_prefix | default: true -%}
+
+{%- if page_teaser_image contains '://' -%}
+  {%- comment -%} External URL - use as-is {%- endcomment -%}
+{%- elsif auto_prefix and page_teaser_image != blank -%}
+  {%- unless page_teaser_image contains assets_prefix -%}
+    {%- assign page_teaser_image = assets_prefix | append: page_teaser_image -%}
+  {%- endunless -%}
+{%- endif -%}
+{%- assign page_teaser_image = page_teaser_image | absolute_url | escape -%}
 
 {%- assign site_og_image = site.og_image | absolute_url -%}
 {%- assign site_og_image = site_og_image | escape -%}

data/_layouts/notebook.html

@@ -140,15 +140,15 @@ layout: default
       <div class="share-buttons mb-4">
         <h5 class="mb-3">Share this notebook</h5>
         <div class="d-flex gap-2">
-          <a href="https://twitter.com/intent/tweet?text={{ page.title | uri_escape }}&url={{ page.url | absolute_url | uri_escape }}" 
+          <a href="https://twitter.com/intent/tweet?text={{ page.title | uri_escape }}&url={{ site.url | append: page.url | uri_escape }}" 
              class="btn btn-outline-primary btn-sm" target="_blank" rel="noopener noreferrer">
             <i class="bi bi-twitter"></i> Twitter
           </a>
-          <a href="https://www.linkedin.com/sharing/share-offsite/?url={{ page.url | absolute_url | uri_escape }}" 
+          <a href="https://www.linkedin.com/sharing/share-offsite/?url={{ site.url | append: page.url | uri_escape }}" 
              class="btn btn-outline-primary btn-sm" target="_blank" rel="noopener noreferrer">
             <i class="bi bi-linkedin"></i> LinkedIn
           </a>
-          <a href="mailto:?subject={{ page.title | uri_escape }}&body={{ page.url | absolute_url | uri_escape }}" 
+          <a href="mailto:?subject={{ page.title | uri_escape }}&body={{ site.url | append: page.url | uri_escape }}" 
              class="btn btn-outline-primary btn-sm">
             <i class="bi bi-envelope"></i> Email
           </a>

data/_plugins/preview_image_generator.rb

@@ -33,6 +33,8 @@ module Jekyll
       'style' => 'retro pixel art, 8-bit video game aesthetic, vibrant colors, nostalgic, clean pixel graphics',
       'style_modifiers' => 'pixelated, retro gaming style, CRT screen glow effect, limited color palette',
       'output_dir' => 'assets/images/previews',
+      'assets_prefix' => '/assets',
+      'auto_prefix' => true,
       'auto_generate' => false,
       'collections' => ['posts', 'docs', 'quickstart']
     }.freeze
@@ -52,18 +54,37 @@ module Jekyll
       site = doc.site
       config = self.config(site)
       
+      # Normalize the preview path using assets_prefix
+      normalized_preview = normalize_preview_path(preview, config)
+      
       # Build the full path
-      preview_path = if preview.start_with?('/')
-                       File.join(site.source, preview)
-                     elsif preview.start_with?('http')
+      preview_path = if normalized_preview.start_with?('/')
+                       File.join(site.source, normalized_preview.sub(/^\//, ''))
+                     elsif normalized_preview.start_with?('http')
                        return true  # External URL, assume it exists
                      else
-                       File.join(site.source, config['output_dir'], preview)
+                       File.join(site.source, config['output_dir'], normalized_preview)
                      end
       
       File.exist?(preview_path)
     end
 
+    # Normalize a preview path by adding assets_prefix if needed
+    def self.normalize_preview_path(preview, config)
+      return preview if preview.nil? || preview.to_s.strip.empty?
+      return preview if preview.start_with?('http')
+      
+      assets_prefix = config['assets_prefix'] || '/assets'
+      auto_prefix = config['auto_prefix'] != false  # Default to true
+      
+      # If auto_prefix is enabled and path doesn't already contain assets_prefix
+      if auto_prefix && !preview.include?(assets_prefix)
+        "#{assets_prefix}#{preview}"
+      else
+        preview
+      end
+    end
+
     # Get the preview image path for a document
     def self.preview_path(doc)
       preview = doc.data['preview']
@@ -72,11 +93,11 @@ module Jekyll
       site = doc.site
       config = self.config(site)
       
-      # If it's already a full path or URL, return as-is
-      return preview if preview.start_with?('/') || preview.start_with?('http')
+      # If it's an external URL, return as-is
+      return preview if preview.start_with?('http')
       
-      # Build relative path from output_dir
-      "#{config['output_dir']}/#{preview}"
+      # Normalize path with assets_prefix
+      normalize_preview_path(preview, config)
     end
 
     # Get list of documents missing preview images