jekyll-theme-zer0 0.8.1 → 0.10.3

data/_layouts/category.html

@@ -112,10 +112,15 @@ layout: default
             {% endif %}
             <a href="{{ fpost.url | relative_url }}" class="text-decoration-none">
               {% if fpost.preview %}
-                <img src="{{ site.baseurl }}/{{ site.public_folder }}/{{ fpost.preview }}" 
-                     class="card-img-top" alt="{{ fpost.title }}" loading="lazy">
+                {% if fpost.preview contains '/assets' %}
+                  <img src="{{ site.baseurl }}{{ fpost.preview }}" 
+                       class="card-img-top" alt="{{ fpost.title }}" loading="lazy">
+                {% else %}
+                  <img src="{{ site.baseurl }}/{{ site.public_folder }}/{{ fpost.preview }}" 
+                       class="card-img-top" alt="{{ fpost.title }}" loading="lazy">
+                {% endif %}
               {% else %}
-                <img src="{{ site.baseurl }}/{{ site.public_folder }}/{{ site.teaser }}" 
+                <img src="{{ site.baseurl }}/{{ site.public_folder }}{{ site.teaser }}" 
                      class="card-img-top" alt="Preview" loading="lazy">
               {% endif %}
             </a>
@@ -167,10 +172,15 @@ layout: default
               {% endif %}
               <a href="{{ cpost.url | relative_url }}" class="text-decoration-none">
                 {% if cpost.preview %}
-                  <img src="{{ site.baseurl }}/{{ site.public_folder }}/{{ cpost.preview }}" 
-                       class="card-img-top" alt="{{ cpost.title }}" loading="lazy">
+                  {% if cpost.preview contains '/assets' %}
+                    <img src="{{ site.baseurl }}{{ cpost.preview }}" 
+                         class="card-img-top" alt="{{ cpost.title }}" loading="lazy">
+                  {% else %}
+                    <img src="{{ site.baseurl }}/{{ site.public_folder }}/{{ cpost.preview }}" 
+                         class="card-img-top" alt="{{ cpost.title }}" loading="lazy">
+                  {% endif %}
                 {% else %}
-                  <img src="{{ site.baseurl }}/{{ site.public_folder }}/{{ site.teaser }}" 
+                  <img src="{{ site.baseurl }}/{{ site.public_folder }}{{ site.teaser }}" 
                        class="card-img-top" alt="Preview" loading="lazy">
                 {% endif %}
               </a>

data/_layouts/collection.html

@@ -84,10 +84,15 @@ layout: default
                 <!-- ====================== -->
                 <!-- Display preview image with fallback to site teaser -->
                 {% if post.preview %}
-                    <img src="{{site.baseurl}}/{{ site.public_folder }}/{{ post.preview}}" 
-                         class="card-img-top" alt="Preview image for {{ post.title }}">
+                    {% if post.preview contains '/assets' %}
+                        <img src="{{ site.baseurl }}{{ post.preview }}" 
+                             class="card-img-top" alt="Preview image for {{ post.title }}">
+                    {% else %}
+                        <img src="{{ site.baseurl }}/{{ site.public_folder }}/{{ post.preview }}" 
+                             class="card-img-top" alt="Preview image for {{ post.title }}">
+                    {% endif %}
                 {% else %}
-                    <img src="{{site.baseurl}}/{{ site.public_folder }}/{{ site.teaser }}" 
+                    <img src="{{ site.baseurl }}/{{ site.public_folder }}{{ site.teaser }}" 
                          class="card-img-top" alt="Default preview image">
                 {% endif %}
                 

data/_layouts/journals.html

@@ -189,10 +189,15 @@ layout: default
               <div class="card h-100 border-0 shadow-sm">
                 <a href="{{ rpost.url | relative_url }}" class="text-decoration-none">
                   {% if rpost.preview %}
-                    <img src="{{ site.baseurl }}/{{ site.public_folder }}/{{ rpost.preview }}" 
-                         class="card-img-top" alt="{{ rpost.title }}" loading="lazy">
+                    {% if rpost.preview contains '/assets' %}
+                      <img src="{{ site.baseurl }}{{ rpost.preview }}" 
+                           class="card-img-top" alt="{{ rpost.title }}" loading="lazy">
+                    {% else %}
+                      <img src="{{ site.baseurl }}/{{ site.public_folder }}/{{ rpost.preview }}" 
+                           class="card-img-top" alt="{{ rpost.title }}" loading="lazy">
+                    {% endif %}
                   {% else %}
-                    <img src="{{ site.baseurl }}/{{ site.public_folder }}/{{ site.teaser }}" 
+                    <img src="{{ site.baseurl }}/{{ site.public_folder }}{{ site.teaser }}" 
                          class="card-img-top" alt="Preview" loading="lazy">
                   {% endif %}
                 </a>

data/_sass/core/_theme.scss

@@ -1,8 +1,11 @@
+// Import variables for standalone compilation
+@import "variables";
+
 // # Font Settings ---------------------------------------------------------------
 
 // # Color Settings --------------------------------------------------------------
 
-// ## Color Schema Override 
+// ## Color Schema Override
 //  https://meodai.github.io/poline/
 
 // Harbour Mirror

data/_sass/custom.scss

@@ -177,23 +177,31 @@ img {
     height: auto;
 }
 
+// ============================================
+// NAVBAR - Fixed positioning with auto-hide
+// ============================================
+// Uses Bootstrap's fixed-top class for positioning (z-index: 1030)
+// JavaScript adds/removes .navbar-hidden class on scroll
+
 #navbar {
-    // position: fixed;
-    top: 0;
-    width: 100%;
-    transition: transform 0.3s;
+    // Transition for smooth hide/show animation
+    transition: transform 0.3s ease-in-out !important;
+    
+    // Ensure navbar background is opaque
+    background-color: var(--bs-body-bg);
 }
 
-.fixed-navbar {
-    position: fixed;
-    top: 0;
-    width: 100%;
-    transition: transform 0.3s;
+// Hidden state - slides up out of view
+// Using higher specificity to override Bootstrap's fixed-top
+#navbar.navbar-hidden {
+    transform: translateY(-100%) !important;
 }
 
-.hide-navbar {
-    transform: translateY(-100%);
-    top: 0px;
+// Respect user's motion preferences
+@media (prefers-reduced-motion: reduce) {
+    #navbar {
+        transition: none !important;
+    }
 }
 
 $enable-cssgrid: true;

data/assets/js/auto-hide-nav.js

@@ -1,18 +1,81 @@
-// Hides the navbar when scrolling down half a page and shows it when scrolling up
-window.onload = function() {
-    let lastScrollTop = 0;
-    const navbar = document.getElementById('navbar');
-
-    window.addEventListener('scroll', function() {
-        let scrollTop = window.pageYOffset || document.documentElement.scrollTop;
-        let halfPageHeight = window.innerHeight / 2;
-
-        if (scrollTop > lastScrollTop && scrollTop > halfPageHeight) {
-            navbar.classList.add('hide-navbar');
-            navbar.classList.add('fixed-navbar');
-        } else {
-            navbar.classList.remove('hide-navbar');
+/**
+ * Auto-hide navbar on scroll
+ * 
+ * Behavior:
+ * - Navbar is fixed at top and visible by default
+ * - Hides when scrolling DOWN past a threshold (100px)
+ * - Reappears when scrolling UP
+ * - Respects prefers-reduced-motion accessibility setting
+ * - Adds body padding to prevent content jump
+ */
+(function() {
+    'use strict';
+
+    // Configuration
+    const SCROLL_THRESHOLD = 100; // Pixels before hide/show triggers
+    const SCROLL_DELTA = 5; // Minimum scroll distance to trigger change
+
+    document.addEventListener('DOMContentLoaded', function() {
+        const navbar = document.getElementById('navbar');
+        if (!navbar) return;
+
+        let lastScrollTop = 0;
+        let ticking = false;
+
+        // Check for reduced motion preference
+        const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+
+        // Calculate and set body padding to prevent content jump
+        function updateBodyPadding() {
+            const navbarHeight = navbar.offsetHeight;
+            document.body.style.paddingTop = navbarHeight + 'px';
+        }
+
+        // Initial padding setup
+        updateBodyPadding();
+
+        // Update padding on window resize
+        window.addEventListener('resize', updateBodyPadding, { passive: true });
+
+        // Scroll handler
+        function handleScroll() {
+            const scrollTop = window.pageYOffset || document.documentElement.scrollTop;
+            const scrollDelta = scrollTop - lastScrollTop;
+
+            // Only trigger if scroll delta exceeds minimum threshold
+            if (Math.abs(scrollDelta) < SCROLL_DELTA) {
+                ticking = false;
+                return;
+            }
+
+            if (scrollDelta > 0 && scrollTop > SCROLL_THRESHOLD) {
+                // Scrolling DOWN past threshold - hide navbar
+                navbar.classList.add('navbar-hidden');
+            } else if (scrollDelta < 0) {
+                // Scrolling UP - show navbar
+                navbar.classList.remove('navbar-hidden');
+            }
+
+            // Always show navbar when at top of page
+            if (scrollTop <= 0) {
+                navbar.classList.remove('navbar-hidden');
+            }
+
+            lastScrollTop = Math.max(0, scrollTop);
+            ticking = false;
+        }
+
+        // Optimized scroll listener using requestAnimationFrame
+        window.addEventListener('scroll', function() {
+            if (!ticking) {
+                window.requestAnimationFrame(handleScroll);
+                ticking = true;
+            }
+        }, { passive: true });
+
+        // Disable animations if user prefers reduced motion
+        if (prefersReducedMotion) {
+            navbar.style.transition = 'none';
         }
-        lastScrollTop = scrollTop;
     });
-}
+})();

data/scripts/bin/build

@@ -0,0 +1,115 @@
+#!/bin/bash
+
+# Simplified build command for zer0-mistakes Jekyll theme
+# Usage: ./scripts/build [options]
+#
+# Quick gem building without the full release workflow.
+
+set -euo pipefail
+
+# Get script and library directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/../lib"
+
+# Source required libraries
+source "$LIB_DIR/common.sh"
+source "$LIB_DIR/validation.sh"
+source "$LIB_DIR/version.sh"
+source "$LIB_DIR/gem.sh"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dry-run)
+            export DRY_RUN=true
+            shift
+            ;;
+        --verbose)
+            export VERBOSE=true
+            shift
+            ;;
+        --help|-h)
+            show_usage
+            exit 0
+            ;;
+        *)
+            error "Unknown option: $1 (use --help for usage)"
+            ;;
+    esac
+done
+
+# Show usage
+show_usage() {
+    cat << EOF
+🔨 Simplified Build Command for zer0-mistakes
+
+USAGE:
+    ./scripts/bin/build [OPTIONS]
+
+DESCRIPTION:
+    Builds the Jekyll theme gem without running the full release workflow.
+    Useful for testing gem packaging or preparing for manual publication.
+
+OPTIONS:
+    --dry-run     Preview build without creating files
+    --verbose     Show detailed debug output
+    --help, -h    Show this help message
+
+EXAMPLES:
+    ./scripts/bin/build                # Build gem with current version
+    ./scripts/bin/build --dry-run      # Preview what would be built
+    ./scripts/build --verbose      # Build with debug output
+
+ENVIRONMENT VARIABLES:
+    DRY_RUN=true     Enable dry run mode
+    VERBOSE=true     Enable debug output
+
+OUTPUT:
+    Creates: jekyll-theme-zer0-VERSION.gem in current directory
+
+For full release workflow, use: ./scripts/release
+EOF
+}
+
+# Main build workflow
+main() {
+    print_header "🔨 Gem Build"
+    
+    # Step 1: Basic validation (no RubyGems auth needed for build)
+    step "Validating environment..."
+    validate_git_repo
+    validate_required_files
+    validate_gemspec
+    success "Environment validated"
+    echo ""
+    
+    # Step 2: Get current version
+    step "Reading version..."
+    local version
+    version=$(get_current_version)
+    info "Current version: $version"
+    info "Gem file: jekyll-theme-zer0-${version}.gem"
+    echo ""
+    
+    # Step 3: Build gem
+    build_gem "$version"
+    echo ""
+    
+    # Success summary
+    if [[ "$DRY_RUN" != "true" ]]; then
+        print_summary "Build Complete" \
+            "✅ Built: jekyll-theme-zer0-${version}.gem" \
+            "" \
+            "Next steps:" \
+            "  • Test: gem install jekyll-theme-zer0-${version}.gem" \
+            "  • Publish: gem push jekyll-theme-zer0-${version}.gem" \
+            "  • Or use: ./scripts/release for full workflow"
+    else
+        info "Dry run complete - no files created"
+    fi
+    
+    success "Build completed successfully!"
+}
+
+# Run main function
+main "$@"

data/scripts/bin/release

@@ -0,0 +1,240 @@
+#!/bin/bash
+
+# Simplified release command for zer0-mistakes Jekyll theme
+# Usage: ./scripts/release [patch|minor|major] [options]
+#
+# This replaces the complex gem-publish.sh with a clean, library-based approach.
+
+set -euo pipefail
+
+# Get script and library directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/../lib"
+
+# Source all required libraries
+source "$LIB_DIR/common.sh"
+source "$LIB_DIR/validation.sh"
+source "$LIB_DIR/version.sh"
+source "$LIB_DIR/git.sh"
+source "$LIB_DIR/changelog.sh"
+source "$LIB_DIR/gem.sh"
+
+# Show usage function
+show_usage() {
+    cat << EOF
+🚀 Simplified Release Command for zer0-mistakes
+
+USAGE:
+    ./scripts/bin/release [VERSION_TYPE] [OPTIONS]
+
+VERSION TYPES:
+    patch       Bump patch version (0.0.X) - Bug fixes (default)
+    minor       Bump minor version (0.X.0) - New features
+    major       Bump major version (X.0.0) - Breaking changes
+
+OPTIONS:
+    --dry-run              Preview changes without executing
+    --skip-tests           Skip running test suite
+    --skip-publish         Build but don't publish to RubyGems
+    --no-github-release    Skip creating GitHub release
+    --non-interactive      Run without confirmation prompts
+    --verbose              Show detailed debug output
+    --help, -h             Show this help message
+
+EXAMPLES:
+    ./scripts/bin/release                    # Patch release (0.6.0 → 0.6.1)
+    ./scripts/bin/release minor              # Minor release (0.6.0 → 0.7.0)
+    ./scripts/bin/release major --dry-run    # Preview major release
+    ./scripts/bin/release patch --skip-tests # Quick release without tests
+
+ENVIRONMENT VARIABLES:
+    DRY_RUN=true           Enable dry run mode
+    INTERACTIVE=false      Disable confirmation prompts
+    VERBOSE=true           Enable debug output
+
+WORKFLOW:
+    1. Validate environment
+    2. Calculate new version
+    3. Generate changelog from commits
+    4. Update version files
+    5. Run tests (unless --skip-tests)
+    6. Build gem
+    7. Commit and tag
+    8. Publish to RubyGems (unless --skip-publish)
+    9. Create GitHub release (unless --no-github-release)
+    10. Push changes to repository
+
+For more information, see: scripts/lib/README.md
+EOF
+}
+
+# Default configuration
+VERSION_TYPE="patch"
+SKIP_TESTS=false
+SKIP_PUBLISH=false
+SKIP_GITHUB_RELEASE=false
+SHOW_HELP=false
+
+# Parse arguments
+for arg in "$@"; do
+    case $arg in
+        --help|-h)
+            SHOW_HELP=true
+            ;;
+        patch|minor|major)
+            VERSION_TYPE="$arg"
+            ;;
+    esac
+done
+
+# Show help if requested
+if [[ "$SHOW_HELP" == "true" ]]; then
+    show_usage
+    exit 0
+fi
+
+# Parse remaining arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        patch|minor|major)
+            # Already handled above
+            shift
+            ;;
+        --help|-h)
+            # Already handled above
+            shift
+            ;;
+        --dry-run)
+            export DRY_RUN=true
+            shift
+            ;;
+        --skip-tests)
+            SKIP_TESTS=true
+            shift
+            ;;
+        --skip-publish)
+            SKIP_PUBLISH=true
+            shift
+            ;;
+        --no-github-release)
+            SKIP_GITHUB_RELEASE=true
+            shift
+            ;;
+        --non-interactive)
+            export INTERACTIVE=false
+            shift
+            ;;
+        --verbose)
+            export VERBOSE=true
+            shift
+            ;;
+        *)
+            error "Unknown option: $1 (use --help for usage)"
+            ;;
+    esac
+done
+
+# Main release workflow
+main() {
+    print_header "🚀 Release Automation"
+    
+    # Show configuration
+    info "Version type: $VERSION_TYPE"
+    info "Dry run: ${DRY_RUN:-false}"
+    info "Interactive: ${INTERACTIVE:-true}"
+    echo ""
+    
+    # Step 1: Validate environment
+    validate_environment "$SKIP_PUBLISH" "$SKIP_GITHUB_RELEASE"
+    
+    # Step 2: Version calculation
+    step "Calculating new version..."
+    local current_version
+    current_version=$(get_current_version)
+    info "Current version: $current_version"
+    
+    local new_version
+    new_version=$(calculate_new_version "$current_version" "$VERSION_TYPE")
+    info "New version: $new_version"
+    
+    # Confirm before proceeding
+    if [[ "$INTERACTIVE" == "true" ]] && [[ "$DRY_RUN" != "true" ]]; then
+        echo ""
+        if ! confirm "Proceed with release $current_version → $new_version?"; then
+            warn "Release cancelled by user"
+            exit 0
+        fi
+    fi
+    echo ""
+    
+    # Step 3: Generate changelog
+    step "Generating changelog..."
+    local last_tag
+    last_tag=$(get_last_version_tag)
+    generate_changelog "$new_version" "$last_tag" "HEAD"
+    echo ""
+    
+    # Step 4: Update version files
+    update_version_files "$new_version"
+    echo ""
+    
+    # Step 5: Run tests
+    if [[ "$SKIP_TESTS" != "true" ]]; then
+        run_tests
+        echo ""
+    else
+        warn "Skipping tests (--skip-tests specified)"
+        echo ""
+    fi
+    
+    # Step 6: Build gem
+    build_gem "$new_version"
+    echo ""
+    
+    # Step 7: Commit and tag
+    commit_and_tag "$new_version"
+    echo ""
+    
+    # Step 8: Publish gem
+    if [[ "$SKIP_PUBLISH" != "true" ]]; then
+        publish_gem "$new_version"
+        echo ""
+    else
+        warn "Skipping RubyGems publication (--skip-publish specified)"
+        echo ""
+    fi
+    
+    # Step 9: Create GitHub release
+    if [[ "$SKIP_GITHUB_RELEASE" != "true" ]]; then
+        create_github_release "$new_version"
+        echo ""
+    else
+        warn "Skipping GitHub release (--no-github-release specified)"
+        echo ""
+    fi
+    
+    # Step 10: Push changes
+    push_changes
+    echo ""
+    
+    # Step 11: Cleanup
+    cleanup_gem_files "$new_version"
+    echo ""
+    
+    # Success summary
+    print_header "✅ Release Complete!"
+    
+    print_summary "Release $new_version" \
+        "Version: $current_version → $new_version" \
+        "Type: $VERSION_TYPE bump" \
+        "Tag: v$new_version" \
+        "" \
+        "📦 RubyGems: https://rubygems.org/gems/jekyll-theme-zer0/versions/$new_version" \
+        "🏷️  GitHub: https://github.com/bamr87/zer0-mistakes/releases/tag/v$new_version" \
+        "📂 Repository: https://github.com/bamr87/zer0-mistakes"
+    
+    success "Release workflow completed successfully!"
+}
+
+# Run main function
+main "$@"