jekyll-theme-zer0 0.10.6 → 0.15.2

data/_data/statistics_config.yml

@@ -0,0 +1,203 @@
+# Configuration for content statistics generation
+# This file defines the mappings and categories used to analyze posts
+# Used by: _data/generate_statistics.rb
+# Purpose: Configurable keyword mappings for content analysis
+
+# Focus area mappings - maps keywords to focus areas
+focus_areas:
+  "AI & Machine Learning":
+    - ai
+    - ml
+    - machine-learning
+    - artificial-intelligence
+    - ai-assisted
+    - gpt
+    - chatgpt
+    - neural
+    - automation
+    - aipd
+  
+  "Web Development":
+    - web
+    - javascript
+    - html
+    - css
+    - react
+    - angular
+    - django
+    - flask
+    - jekyll
+    - frontend
+    - backend
+    - fullstack
+    - api
+    - rest
+    - bootstrap
+  
+  "DevOps & Infrastructure":
+    - devops
+    - docker
+    - kubernetes
+    - ci/cd
+    - deployment
+    - infrastructure
+    - containers
+    - orchestration
+    - pipeline
+    - github-actions
+    - travis
+    - netlify
+  
+  "System Administration":
+    - linux
+    - windows
+    - macos
+    - server
+    - admin
+    - system
+    - dual-boot
+    - installation
+    - configuration
+  
+  "Programming & Scripting":
+    - programming
+    - scripting
+    - python
+    - bash
+    - shell
+    - coding
+    - development
+    - refactoring
+    - architecture
+    - ruby
+    - typescript
+  
+  "Data & Analytics":
+    - data
+    - database
+    - analytics
+    - scraping
+    - analysis
+    - processing
+    - statistics
+  
+  "Tools & Development Environment":
+    - tools
+    - vscode
+    - editor
+    - environment
+    - productivity
+    - extension
+    - workflow
+  
+  "Documentation & Content":
+    - documentation
+    - docs
+    - tutorial
+    - guide
+    - how-to
+    - mermaid
+    - diagram
+  
+  "Creative & Experimental":
+    - creative
+    - experimental
+    - art
+    - music
+    - fiction
+    - storytelling
+    - themes
+
+# Skill level mappings
+skill_levels:
+  beginner:
+    - beginner
+    - intro
+    - introduction
+    - getting-started
+    - basics
+    - fundamentals
+    - first
+    - setup
+    - quickstart
+  
+  intermediate:
+    - intermediate
+    - advanced-beginner
+    - practical
+    - hands-on
+    - implementation
+    - building
+  
+  advanced:
+    - advanced
+    - deep-dive
+    - optimization
+    - performance
+    - architecture
+    - complex
+    - sophisticated
+  
+  expert:
+    - expert
+    - research
+    - cutting-edge
+    - innovation
+    - meta
+    - engine
+    - evolution
+
+# Content type mappings
+content_types:
+  "Tutorial":
+    - tutorial
+    - guide
+    - how-to
+    - step-by-step
+    - walkthrough
+    - setup
+  
+  "Article":
+    - article
+    - analysis
+    - insights
+    - deep-dive
+    - discussion
+    - overview
+  
+  "Journal Entry":
+    - journal
+    - learning-journey
+    - diary
+    - chronicle
+    - post
+  
+  "Documentation":
+    - documentation
+    - reference
+    - api
+    - manual
+    - specification
+  
+  "News/Update":
+    - news
+    - update
+    - announcement
+    - release
+    - changelog
+
+# Display preferences for statistics
+display:
+  # Maximum items to show in top lists
+  max_categories: 10
+  max_tags: 15
+  max_authors: 5
+  
+  # Whether to show percentages
+  show_percentages: true
+  
+  # Minimum count to display an item
+  min_count_threshold: 1
+  
+  # Highlight threshold for "popular" items
+  popular_threshold: 5

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/README.md

@@ -46,6 +46,8 @@ Reusable UI components and widgets:
 - `zer0-env-var.html` - Environment variable configuration
 - `svg.html` - SVG icon definitions
 - `js-cdn.html` - CDN JavaScript libraries
+- `preview-image.html` - Consistent preview image rendering with lazy loading
+- `post-card.html` - Reusable post card component for listings
 
 ### `content/`
 

data/_includes/components/js-cdn.html

@@ -26,4 +26,7 @@
 <!-- Bootstrap 5.3.3 Bundle (includes Popper.js) -->
 <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js" 
         integrity="sha384-YvpcrYf0tY3lHB60NNkmXc5s9fDVZLESaAA55NDzOxhy9GkcIdslK1eN7N6jIeHz" 
-        crossorigin="anonymous"></script>
+        crossorigin="anonymous"></script>
+
+<!-- Sidebar Navigation Enhancements - Deferred for performance -->
+<script defer src="{{ '/assets/js/sidebar.js' | relative_url }}"></script>

data/_includes/components/post-card.html

@@ -78,17 +78,8 @@
       
       <!-- Preview Image -->
       <a href="{{ include.post.url | relative_url }}" class="text-decoration-none">
-        {% if include.post.preview %}
-          <img src="{{ site.baseurl }}/{{ site.public_folder }}/{{ include.post.preview }}" 
-               class="card-img-top" 
-               alt="Preview image for {{ include.post.title }}"
-               loading="lazy">
-        {% else %}
-          <img src="{{ site.baseurl }}/{{ site.public_folder }}/{{ site.teaser }}" 
-               class="card-img-top" 
-               alt="Default preview image"
-               loading="lazy">
-        {% endif %}
+        {% assign card_img = include.post.preview | default: site.teaser %}
+        {% include components/preview-image.html src=card_img alt=include.post.title class="card-img-top" %}
       </a>
     </div>