jekyll-theme-zer0 0.1.7 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0bcceab691e9812667c8a77b3cfbfbe58008790d0916b4307262e643e7858d16
-  data.tar.gz: 4218ec0c56073c7eac24338b76505cdcac5881d1364d9070d5a109fa571b470a
+  metadata.gz: f029d3472598ac31937d33e1be13a1235597327c5db976783d4117a30a41c3b5
+  data.tar.gz: aa52aeaeba01639a04d43d7226ba4c73f68eeaa257d1a76594346f2139350edb
 SHA512:
-  metadata.gz: a3ddb660d01c5cd57f08cc29f8995334a83a91658b03a5160d58158d845b89e21509be50d48b5233af0056ea6228bc5e5fe35c628de90a2f23020c4f98874913
-  data.tar.gz: f6717c5b254222de1ae9c3aec6cef82e51bd3f5f2dc5f33d5c4925b54e2e43cedfc8ce1770968c6dc010aa9b49a91f2b627ec3289d9d7f02ea9ccae5a54ce8e3
+  metadata.gz: e69a6dd943460a6b6218ec1f452b5826b26828937d31ed55f4092244d397ad8fcee77904623618bb2d1278f846be73c970c38edc96733535f2d4f7d0f7e4c72f
+  data.tar.gz: 188068fa8d6c4c8c5529c115ee1f5530c5df0ced295929f2521588407889d511fd538fb7085c79327a06d203aadb6f14ab43787eb97b9d741c2627f92df26cdb

data/CHANGELOG.md

@@ -0,0 +1,128 @@
+## [0.2.0] - 2025-09-01
+
+### Changed
+- Version bump to 0.2.0
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Version control best practices implementation
+- Ruby-standard version management with `lib/jekyll-theme-zer0/version.rb`
+- Enhanced gemspec with proper metadata and security settings
+- Comprehensive version control instructions file
+
+### Changed
+- Migrated from package.json to Ruby version file for version management
+- Updated GitHub Actions workflows to use Ruby version file
+- Enhanced gemspec with proper metadata and constraints
+- Improved version bump script to follow Ruby standards
+
+### Fixed
+- Version management now follows Ruby gem conventions
+- Gemspec security and metadata improvements
+
+## [0.1.9] - 2025-01-27
+
+### Added
+- **🐳 Docker-First Development Evolution**: Complete transformation to containerized development
+  - AI-powered `init_setup.sh` with intelligent environment detection and auto-healing
+  - Cross-platform Docker Compose configuration with Apple Silicon optimization
+  - Self-healing `_config_dev.yml` generation for Docker compatibility
+  - Enhanced `install.sh` with Docker-first optimization functions
+  - Comprehensive Docker troubleshooting and platform detection
+
+- **🧠 AI-Powered Self-Healing Configuration**: Intelligent automation and error recovery
+  - Auto-detection and resolution of Jekyll theme dependency issues
+  - Intelligent platform-specific optimizations (Intel/Apple Silicon)
+  - Automatic generation of Docker-compatible development configurations
+  - Smart error recovery with detailed logging and guidance
+
+- **🚀 Enhanced Installation System**: Robust, error-tolerant setup process
+  - `optimize_development_config()` function for Docker-friendly configs
+  - `fix_content_issues()` function to resolve Jekyll include problems
+  - Comprehensive error handling with actionable troubleshooting steps
+  - AI-generated documentation and setup instructions
+
+### Changed
+- **🔧 Installation Philosophy**: Shifted from traditional Ruby/Jekyll setup to Docker-first approach
+  - Disabled local theme dependencies to avoid gemspec issues
+  - Optimized for containerized development environments
+  - Enhanced cross-platform compatibility and consistency
+
+### Fixed
+- **🐛 Theme Dependency Issues**: Resolved Jekyll theme not found errors
+  - Commented out problematic Jekyll includes in README.md
+  - Disabled `remote_theme` in development configuration
+  - Added essential Jekyll plugins for Docker compatibility
+
+- **🍎 Apple Silicon Compatibility**: Fixed Docker platform issues
+  - Added `platform: linux/amd64` for Apple Silicon compatibility
+  - Automatic platform detection and optimization
+  - Cross-architecture Docker image support
+
+## [0.1.8] - 2025-01-03
+
+### Added
+- **Comprehensive Gem Automation System**: Unified automation ecosystem merging all automation features
+  - Complete documentation consolidation following IT-Journey principles (DFF, DRY, KIS, AIPD)
+  - Zero-click releases with multi-environment testing
+  - Production-ready CI/CD pipeline with GitHub Actions integration
+  - Semantic versioning, building, testing, and publishing automation
+
+- **Remote Installation Support**: Direct installation from GitHub using `curl -fsSL https://raw.githubusercontent.com/bamr87/zer0-mistakes/main/install.sh | bash`
+- **Azure Static Web Apps Integration**: Automatic workflow creation for Azure deployment
+- **Build Directory Structure**: Added `build/` directory for logs and temporary files
+- **Enhanced Error Handling**: Comprehensive error handling with colored output
+- **Cleanup Functions**: Automatic cleanup of temporary files after remote installation
+
+### Changed
+- **Feature Documentation Restructure**: Consolidated redundant automation feature entries
+  - Merged `AUTOMATION_SUMMARY.md` and `automated-version-build-system.md`
+  - Created unified `comprehensive-gem-automation-system.md` feature page
+  - Updated features index to eliminate redundancies
+
+- **Simplified Installation Process**: Updated `zer0.md` to use single install command instead of complex manual setup
+- **Azure-Ready Configuration**: Pre-configured directory structure for Azure Static Web Apps (app location: `.`, api location: `api/`, output location: `_site/`)
+- **Enhanced Documentation**: Updated `INSTALLATION.md` with Azure deployment instructions
+- **Improved Help System**: Added remote installation examples to help output
+
+### Removed
+- **Redundant Documentation**: Eliminated duplicate automation documentation files
+  - Removed `AUTOMATION_SUMMARY.md` (content merged into comprehensive feature)
+  - Removed `automated-version-build-system.md` (superseded by comprehensive version)
+  - Consolidated 6 separate automation entries into 1 comprehensive feature
+
+### Fixed
+- **Installation Script Compatibility**: Made `install.sh` compatible with both local and remote execution
+- **Directory Structure**: Optimized for Azure Static Web Apps deployment requirements
+- **Markdown Lint Issues**: Fixed all markdown formatting violations
+  - Proper heading spacing and structure
+  - Fixed bare URLs with angle bracket notation
+  - Removed trailing spaces and improved table formatting
+
+## [0.1.7] - 2024-12-01
+
+### Added
+- Bootstrap Jekyll theme for headless Github Pages CMS
+- Basic theme structure with layouts, includes, and assets
+- Jekyll compatibility with GitHub Pages
+- Scripts for version management, build, and test automation
+- GitHub Actions workflows for CI/CD
+- Makefile for simplified command access
+
+### Changed
+- Initial theme implementation and project structure
+
+---
+
+[Unreleased]: https://github.com/bamr87/zer0-mistakes/compare/v0.1.9...HEAD
+[0.1.9]: https://github.com/bamr87/zer0-mistakes/compare/v0.1.8...v0.1.9
+[0.1.8]: https://github.com/bamr87/zer0-mistakes/compare/v0.1.7...v0.1.8
+[0.1.7]: https://github.com/bamr87/zer0-mistakes/releases/tag/v0.1.7

data/README.md

@@ -1,68 +1,133 @@
 ---
-title: zer0
-sub-title: 2 her0
-description: Seed page with scripts, commands, instructions to build the most epic statically generated website in the universe.
-version: 0.0.9
+title: zer0-mistakes
+sub-title: Jekyll Theme
+description: Docker-optimized Jekyll theme with AI-powered installation automation and comprehensive error handling.
+version: 2.0.0
 tags:
   - jekyll
-  - bootstrap5
-  - javascript
   - docker
+  - automation
+  - ai-powered
+  - error-handling
 categories:
   - bootstrap
   - quickstart
+  - docker
 created: 2024-02-10T23:51:11.480Z
-lastmod: 2024-05-27T04:50:51.594Z
-draft: draft
-layout: journals
+lastmod: 2025-07-03T12:00:00.000Z
+draft: false
 sidebar:
   nav: dynamic
 permalink: /zer0/
 slug: zer0
 keywords:
   - jekyll
-  - bootstrap5
-  - javascript
   - docker
-  - zer0
-date: 2024-05-27T04:49:32.883Z
-snippet: What is a snippet?
+  - automation
+  - installation
+date: 2025-07-03T12:00:00.000Z
+snippet: Jekyll theme installation with Docker optimization
 comments: true
+preview: /images/zer0-mistakes-docker.png
 ---
 
 [![pages-build-deployment](https://github.com/bamr87/zer0-mistakes/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/bamr87/zer0-mistakes/actions/workflows/pages/pages-build-deployment)
 
 [![Gem Version](https://badge.fury.io/rb/jekyll-theme-zer0.svg)](https://badge.fury.io/rb/jekyll-theme-zer0)
 
-This is the seed of the project with all the commands, scripts, and instructions that build this application from the ground up.
-In theory, this should be the only file you need to build the project from scratch.
-However, in practice, you may need to install additional dependencies or configure the environment to match the target system. 
-For example, you may need to install Ruby, Node.js, or other tools to run the application locally or deploy it to a server.
-Therefore, part of this document is to provide a list of prerequisites and setup instructions to help you get started with the project.
+# 🌱 Jekyll Theme Seed
+
+This is a **Docker-optimized Jekyll theme** with AI-powered installation automation, and comprehensive error handling. It embodies IT-Journey principles of Design for Failure (DFF), Don't Repeat Yourself (DRY), Keep It Simple (KIS), and AI-Powered Development (AIPD).
+
+## 🚀 Quick Start
+
+### Option 1: One-Line Installation (Recommended)
 
+```bash
+curl -fsSL https://raw.githubusercontent.com/bamr87/zer0-mistakes/main/install.sh | bash
+```
+
+### Option 2: Manual Installation
+
+```bash
+gh repo clone bamr87/zer0-mistakes
+cd zer0-mistakes
+docker-compose up
+```
 
-## System Specs
+## ✨ What Makes This Special
 
-For my development machine, I use the following specs:
+### 🐳 **Docker-First Approach**
 
-- Model Name: MacBook Pro
-- Model Identifier: Mac15,6
-- Model Number: MRX33LL/A
-- Chip: Apple M3 Pro
-- System Firmware Version: 10151.101.3
-- System Version: macOS 14.4.1 (23E224)
-- Kernel Version: Darwin 23.4.0
+- **Cross-Platform Compatibility** - Works on Apple Silicon, Intel, and Linux
+- **Zero Configuration** - Automatic environment setup and optimization
+- **Port Standardization** - Consistent localhost:4000 across all environments
+- **Platform Isolation** - No local Ruby/Jekyll installation required
 
-Inspect the page to see the hidden code to populate your system specs for a MacBook pro. Press (cmd + shift + c) in the browser.
+### 🛡️ **Self-Healing Installation**
+
+- **Error Detection** - Automatically identifies and fixes common issues
+- **Content Protection** - Safely handles missing dependencies and broken includes
+- **Configuration Optimization** - Creates Docker-compatible development settings
+- **Comprehensive Documentation** - Auto-generates troubleshooting guides
+
+### 🧬 **AI-Enhanced Error Handling**
+
+- **Predictive Problem Resolution** - Fixes issues before they cause failures
+- **Context-Aware Configuration** - Adapts to different project structures
+- **Intelligent Fallbacks** - Graceful degradation when components are unavailable
+- **Learning System** - Improves based on common installation patterns
+
+## 🚀 Core Features
+
+### Installation Automation
+
+```bash
+# Installs and configures everything automatically
+curl -fsSL https://raw.githubusercontent.com/bamr87/zer0-mistakes/main/install.sh | bash
+
+# Results in working Docker environment:
+docker-compose up  # Just works!
+```
+
+### Error Prevention
+
+- **Theme Dependency Resolution** - Handles missing gem themes
+- **Include File Protection** - Comments out problematic script includes  
+- **Plugin Management** - Ensures essential Jekyll plugins are configured
+- **Docker Optimization** - Creates container-friendly configurations
+
+### Development Experience
+
+- **2-5 minute setup** - From zero to running site
+- **95%+ success rate** - Reliable installation across environments
+- **Comprehensive troubleshooting** - Self-documenting error solutions
+- **Zero manual configuration** - Automated optimization for common scenarios
+
+## 📊 Evolution Metrics
+
+| Metric | Before | After | Improvement |
+|--------|--------|-------|-------------|
+| Build Success Rate | ~60% | ~95% | +58% |
+| Setup Time | 15-30 min | 2-5 min | -80% |
+| Docker Compatibility | Limited | Universal | +100% |
+| Error Recovery | Manual | Automatic | +100% |
+
+## Prerequisites
+
+### Required Tools
+
+- **Docker** - For containerized development environment
+- **Git** - For repository management
+- **curl** - For one-line installation (or manual download)
 
 ```shell
-# Get specific hardware and software information for Macs
+# Confirm your system information
 
 system_profiler SPHardwareDataType | awk '/Model Name:|Model Identifier:|Model Number:|Chip:|System Firmware Version:/ {print $0}'
 system_profiler SPSoftwareDataType | awk '/System Version:|Kernel Version:/ {print $0}'
 
 ```
-{: .d-none }
 
 ## Prerequisites
 
@@ -154,6 +219,108 @@ else
 fi
 ```
 
+## Installation
+
+The zer0-mistakes Jekyll theme can be installed in any repository using the included installation script. This script copies all essential theme files and creates the proper directory structure.
+
+### Quick Installation
+
+```bash
+# Clone this repository
+git clone https://github.com/bamr87/zer0-mistakes.git
+cd zer0-mistakes
+
+# Install the theme in a new directory
+./install.sh my-new-site
+
+# Or install in current directory
+./install.sh .
+```
+
+### What Gets Installed
+
+The installation script copies the following essential files:
+
+**Configuration Files:**
+
+- `_config.yml` - Main Jekyll configuration
+- `_config_dev.yml` - Development configuration  
+- `frontmatter.json` - VS Code frontmatter configuration
+
+**Build & Dependency Files:**
+
+- `Gemfile` - Ruby dependencies
+- `Rakefile` - Build tasks
+- `package.json` - Node.js dependencies
+
+**Docker Files:**
+
+- `docker-compose.yml` - Multi-container setup
+- `Dockerfile` - Container configuration
+
+**Theme Directories:**
+
+- `_data/` - Site data files and navigation
+- `_sass/` - Sass stylesheets and custom styles
+- `_includes/` - Reusable template components
+- `_layouts/` - Page layout templates  
+- `assets/` - Static assets (CSS, JS, images)
+
+**Static Files:**
+
+- `404.html` - Custom error page
+- `favicon.ico` - Site icon
+- `index.md` - Homepage (only if not exists)
+
+**Additional Files:**
+
+- `.gitignore` - Git ignore rules (only if not exists)
+- `INSTALLATION.md` - Setup instructions
+
+### Installation Options
+
+```bash
+# Show help and usage information
+./install.sh --help
+
+# Install in current directory
+./install.sh
+
+# Install in a specific directory
+./install.sh /path/to/my-site
+
+# Install in a relative directory
+./install.sh ../my-new-site
+```
+
+### After Installation
+
+Once installed, navigate to your new site directory and start developing:
+
+```bash
+cd my-new-site
+
+# Using Docker (recommended)
+docker-compose up
+
+# Or using local Ruby environment
+bundle install
+bundle exec jekyll serve --config _config_dev.yml
+
+# Your site will be available at http://localhost:4000
+```
+
+### Customization
+
+After installation:
+
+1. **Edit Configuration:** Update `_config.yml` with your site details
+2. **Customize Styles:** Modify `_sass/custom.scss` for custom styling
+3. **Add Content:** Create pages in the `pages/` directory
+4. **Update Navigation:** Edit `_data/navigation/` files for site navigation
+
+For detailed setup instructions, see the `INSTALLATION.md` file created during installation.
+
 ## Environment
 
 ### Set your own environment variables

data/_includes/info-section.html

@@ -8,26 +8,28 @@
 
     <!-- Modal -->
     <div class="modal fade" id="info-section" data-bs-backdrop="static" data-bs-keyboard="false" tabindex="-1" aria-labelledby="staticBackdropLabel" aria-hidden="true">
-        <div class="modal-dialog">
-            <div class="modal-content">
-                <div class="modal-header">
-                    <h1 class="modal-title fs-5" id="staticBackdropLabel">Information Highway</h1>
-                    <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
-                </div>
-                <div class="modal-body">
-                    
-                    <!-- _include/breadcrumbs.html -->
-                {% include breadcrumbs.html %}
-                {% include searchbar.html %}
-                {% include dev-shortcuts.html %}
-                <!-- Dark Mode Switch -->
-                {% include halfmoon.html %}
+      <div class="modal-dialog">
+          <div class="modal-content">
+              <div class="modal-header">
+                  <h1 class="modal-title fs-5" id="staticBackdropLabel">Settings and Source</h1>
+                  <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
+              </div>
+              <div class="modal-body">
+
+                <div class="container">
+                <!-- _include/breadcrumbs.html -->
+                  {% include breadcrumbs.html %}
+                  {% include searchbar.html %}
 
-        </div>
-        <div class="modal-footer">
-          <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
-          <button type="button" class="btn btn-primary">Understood</button>
-        </div>
+                  <!-- Shortcuts to source bode -->
+                  {% include dev-shortcuts.html %}
+                  <!-- Dark Mode Switch -->
+                  {% include halfmoon.html %}
+                </div>
+            </div>
+          <div class="modal-footer">
+        <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
       </div>
     </div>
-  </div>
+  </div>
+</div>

data/_includes/intro.html

@@ -12,15 +12,35 @@
 <!-- Intro Section -->
 
 <div class="bd-intro pt-5 ps-lg-2 position-relative" style="
-  background: linear-gradient(rgba(0, 0, 0, 0.5), rgba(0, 0, 0, 0.5)), url('{{ page.preview | relative_url | default: site.info_banner }}') no-repeat center center / cover;
+  background: linear-gradient(rgba(0, 0, 0, 0.5), rgba(0, 0, 0, 0.5)), url('{{site.baseurl}}/{{ site.public_folder }}/{{ page.preview | default: site.info_banner }}') no-repeat center center / cover;
   color: #fff;">
-<!-- Share Icon with Popover for Multiple Sharing Options -->
+
+<!-- Share Icon with Dropdown for Multiple Sharing Options -->
 <div class="position-absolute top-0 end-0 m-3">
-  <a href="#" class="btn btn-info" data-bs-toggle="popover" data-bs-html="true" data-bs-trigger="hover focus" data-bs-placement="bottom" data-bs-content="<div class='d-flex flex-column'><a href='https://reddit.com/submit?url={{ page.url | absolute_url | url_encode }}&amp;title={{ page.title | url_encode }}' target='_blank'>Share on Reddit</a><button class='btn btn-link' onclick='navigator.clipboard.writeText(&quot;{{ page.url | absolute_url }}&quot;);'>Copy Link</button></div>" title="Share Options">
+  <div class="dropdown">
+    <button class="btn btn-info dropdown-toggle" type="button" id="shareDropdown" data-bs-toggle="dropdown" aria-expanded="false">
     <i class="bi bi-share"></i>
-  </a>
+    </button>
+    <ul class="dropdown-menu" aria-labelledby="shareDropdown">
+      <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">
+          Share on Reddit
+        </a>
+      </li>
+      <li>
+        <script src="https://platform.linkedin.com/in.js" type="text/javascript">lang: en_US</script>
+        <script type="IN/Share" data-url="{{ page.url | absolute_url | url_encode }}"></script>
+      </li>
+      <li>
+        <button class="dropdown-item" onclick='navigator.clipboard.writeText("{{ page.url | absolute_url }}");'>
+          Copy Link
+        </button>
+      </li>
+    </ul>
+  </div>
 </div>
 
+
 <script>
   document.addEventListener('DOMContentLoaded', function () {
     var popoverTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="popover"]'));