jekyll-theme-zer0 0.22.21 → 0.22.22

data/scripts/lib/install/fs.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+# =========================================================================
+# scripts/lib/install/fs.sh
+# =========================================================================
+# Filesystem helpers for install.sh: idempotent file/directory copy with
+# automatic timestamped backups when destination already exists.
+#
+# Required globals (set by install.sh before sourcing/use):
+#   $TARGET_DIR  — used to compute relative paths in log messages
+#
+# Functions exported:
+#   copy_file_with_backup       SRC DEST
+#   copy_directory_with_backup  SRC DEST
+# =========================================================================
+
+# Copy a file, backing up the destination if it already exists.
+copy_file_with_backup() {
+    local src="$1"
+    local dest="$2"
+    local relative_path="${dest#${TARGET_DIR:-}/}"
+
+    # Create destination directory if it doesn't exist
+    mkdir -p "$(dirname "$dest")"
+
+    # Backup existing file if it exists
+    if [[ -f "$dest" ]]; then
+        local backup_file="${dest}.backup.$(date +%Y%m%d_%H%M%S)"
+        log_warning "File exists, creating backup: $relative_path -> ${backup_file##*/}"
+        cp "$dest" "$backup_file"
+    fi
+
+    # Copy the file
+    cp "$src" "$dest"
+    log_info "Copied: $relative_path"
+}
+
+# Copy a directory, backing up the destination if it already exists.
+copy_directory_with_backup() {
+    local src="$1"
+    local dest="$2"
+    local relative_path="${dest#${TARGET_DIR:-}/}"
+
+    if [[ -d "$dest" ]]; then
+        local backup_dir="${dest}.backup.$(date +%Y%m%d_%H%M%S)"
+        log_warning "Directory exists, creating backup: $relative_path -> ${backup_dir##*/}"
+        cp -r "$dest" "$backup_dir"
+        rm -rf "$dest"
+    fi
+
+    cp -r "$src" "$dest"
+    log_info "Copied directory: $relative_path"
+}

data/scripts/lib/install/logging.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+# =========================================================================
+# scripts/lib/install/logging.sh
+# =========================================================================
+# Logging shim for install.sh. Provides log_info / log_success /
+# log_warning / log_error names used throughout install.sh while
+# delegating to scripts/lib/common.sh primitives where available.
+#
+# WHY a shim instead of a direct sed-rename?
+#   - install.sh has ~300+ call sites to log_info/log_success/log_warning/log_error
+#   - Common.sh uses different verbs (info/success/warn/error) and `error` exits
+#   - A thin shim preserves behavior exactly while letting future code use
+#     either vocabulary.
+#
+# Source order requirement:
+#   This file must be sourced AFTER scripts/lib/common.sh so the
+#   colour variables (RED/GREEN/YELLOW/BLUE/NC) are defined.
+#
+# Compatibility: bash 3.2+ (macOS default)
+# =========================================================================
+
+# Define colours if common.sh wasn't sourced (safe defaults).
+RED="${RED:-\033[0;31m}"
+GREEN="${GREEN:-\033[0;32m}"
+YELLOW="${YELLOW:-\033[1;33m}"
+BLUE="${BLUE:-\033[0;34m}"
+NC="${NC:-\033[0m}"
+
+# install.sh-style logging — identical output to the original block.
+log_info()    { echo -e "${BLUE}[INFO]${NC} $1"; }
+log_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
+log_warning() { echo -e "${YELLOW}[WARNING]${NC} $1"; }
+log_error()   { echo -e "${RED}[ERROR]${NC} $1"; }

data/scripts/lib/install/pages.sh

@@ -0,0 +1,255 @@
+#!/usr/bin/env bash
+# scripts/lib/install/pages.sh
+#
+# Starter-page generator for jekyll-theme-zer0 installations.
+# Replaces 8 near-identical create_*_page heredoc functions with a single
+# manifest-driven renderer.
+#
+# Required env (from install.conf via config.sh):
+#   TARGET_DIR, THEME_NAME, THEME_DISPLAY_NAME, DEFAULT_URL, GITHUB_URL
+#
+# Required functions (from template.sh):
+#   create_from_template <template_relpath> <dest_abspath> <fallback_content>
+#
+# Public API:
+#   render_starter_pages          - generate all default pages + admin
+#   render_admin_settings_pages   - generate just the _about/settings/* pages
+
+# ---------- Manifest --------------------------------------------------------
+# Format (pipe-separated, no spaces around |):
+#   <template_relpath>|<dest_relpath>|<mkdir_relpath>|<fallback_func>
+# Empty <mkdir_relpath> = no mkdir; empty <fallback_func> = no fallback.
+_starter_pages_manifest() {
+    cat <<'MANIFEST'
+pages/quickstart.md.template|pages/quickstart/index.md|pages/quickstart|_fallback_quickstart
+pages/docs-index.md.template|pages/_docs/index.md|pages/_docs|_fallback_docs_index
+pages/configuration.md.template|pages/_docs/configuration/index.md|pages/_docs/configuration|
+pages/troubleshooting.md.template|pages/_docs/troubleshooting.md|pages/_docs|
+pages/about.md.template|pages/_about/index.md|pages/_about|_fallback_about
+pages/blog.md.template|pages/blog.md||_fallback_blog
+MANIFEST
+}
+
+_admin_settings_pages() {
+    echo "theme config navigation collections analytics environment"
+}
+
+# ---------- Fallback content (only used when template missing) --------------
+_fallback_quickstart() {
+    cat <<EOF
+---
+layout: default
+title: Quick Start
+permalink: /quickstart/
+---
+
+# Quick Start Guide
+
+Get your site up and running in just a few minutes!
+
+## Prerequisites
+
+Before you begin, make sure you have:
+
+- **Docker Desktop** installed ([download](https://www.docker.com/products/docker-desktop))
+- **Git** installed ([download](https://git-scm.com/))
+
+## 1. Start Development Server
+
+### Using Docker (Recommended)
+
+\`\`\`bash
+docker-compose up
+\`\`\`
+
+Your site will be available at **${DEFAULT_URL}**
+
+### Using Local Ruby
+
+\`\`\`bash
+bundle install
+bundle exec jekyll serve
+\`\`\`
+
+## 2. Customize Your Site
+
+Edit \`_config.yml\` to personalize your site:
+
+\`\`\`yaml
+title: Your Site Title
+description: Your site description
+author: Your Name
+\`\`\`
+
+## 3. Add Content
+
+- Create posts in \`pages/_posts/\`
+- Create documentation in \`pages/_docs/\`
+- Add static pages in \`pages/\`
+
+## Next Steps
+
+- [Read the Documentation](/docs/) - Learn about all features
+- [Explore Configuration](/docs/configuration/) - Customize your site
+- [Learn about Layouts](/docs/layouts/) - Understand page layouts
+
+---
+
+Need help? Check the [troubleshooting guide](/docs/troubleshooting/) or [open an issue](${GITHUB_URL}/issues).
+EOF
+}
+
+_fallback_docs_index() {
+    cat <<EOF
+---
+layout: default
+title: Documentation
+permalink: /docs/
+---
+
+# Documentation
+
+Welcome to the ${THEME_NAME} theme documentation. Here you'll find everything you need to build and customize your Jekyll site.
+
+## Getting Started
+
+<div class="row">
+<div class="col-md-6 mb-3">
+
+### Installation
+
+The theme supports multiple installation methods:
+
+- **Docker** (Recommended) - Zero dependencies
+- **Remote Theme** - For GitHub Pages
+- **Gem** - Traditional Ruby installation
+
+[View Installation Guide →](/quickstart/)
+
+</div>
+<div class="col-md-6 mb-3">
+
+### Configuration
+
+Customize your site with \`_config.yml\`:
+
+- Site title and description
+- Navigation menus
+- Social links
+- Analytics integration
+
+[View Configuration Guide →](/docs/configuration/)
+
+</div>
+</div>
+
+## Need Help?
+
+- [Troubleshooting Guide](/docs/troubleshooting/)
+- [GitHub Issues](${GITHUB_URL}/issues)
+- [GitHub Discussions](${GITHUB_URL}/discussions)
+EOF
+}
+
+_fallback_about() {
+    cat <<EOF
+---
+layout: default
+title: About
+permalink: /about/
+---
+
+# About This Site
+
+This site is built with the **${THEME_DISPLAY_NAME}** - a professional Jekyll theme designed for GitHub Pages with Bootstrap 5.3.
+
+## Theme Features
+
+- ✅ Bootstrap 5.3 integration
+- ✅ Dark/Light mode toggle
+- ✅ Docker support
+- ✅ GitHub Pages compatible
+- ✅ SEO optimized
+
+## Learn More
+
+- [Theme Documentation](/docs/)
+- [GitHub Repository](${GITHUB_URL})
+- [Report an Issue](${GITHUB_URL}/issues)
+
+## Customizing This Page
+
+Edit \`pages/_about/index.md\` to customize this page with your own content.
+EOF
+}
+
+_fallback_blog() {
+    cat <<'EOF'
+---
+layout: default
+title: Blog
+permalink: /blog/
+---
+
+# Blog
+
+Welcome to the blog. Create your first post to get started!
+
+## Creating Posts
+
+Create markdown files in `pages/_posts/` with the format:
+
+```
+YYYY-MM-DD-your-post-title.md
+```
+
+## Recent Posts
+
+{% for post in site.posts limit:5 %}
+- [{{ post.title }}]({{ post.url }}) - {{ post.date | date: "%B %d, %Y" }}
+{% endfor %}
+
+{% if site.posts.size == 0 %}
+*No posts yet. Create your first post to see it here!*
+{% endif %}
+EOF
+}
+
+# ---------- Public renderers ------------------------------------------------
+render_admin_settings_pages() {
+    local admin_dir="$TARGET_DIR/pages/_about/settings"
+    mkdir -p "$admin_dir"
+
+    log_info "Creating admin settings pages..."
+    local page
+    for page in $(_admin_settings_pages); do
+        create_from_template "pages/admin/${page}.md.template" "$admin_dir/${page}.md" ""
+    done
+}
+
+render_starter_pages() {
+    log_info "Creating essential starter pages..."
+    mkdir -p "$TARGET_DIR/pages"
+
+    local tmpl dest mkdir_rel fb_func fallback
+    while IFS='|' read -r tmpl dest mkdir_rel fb_func; do
+        [ -z "$tmpl" ] && continue
+        [ -n "$mkdir_rel" ] && mkdir -p "$TARGET_DIR/$mkdir_rel"
+        if [ -n "$fb_func" ] && declare -f "$fb_func" >/dev/null 2>&1; then
+            fallback="$("$fb_func")"
+        else
+            fallback=""
+        fi
+        create_from_template "$tmpl" "$TARGET_DIR/$dest" "$fallback"
+    done <<MANIFEST_EOF
+$(_starter_pages_manifest)
+MANIFEST_EOF
+
+    render_admin_settings_pages
+
+    log_success "Starter pages created"
+}
+
+# Backward-compatible aliases (legacy install.sh call sites)
+create_starter_pages() { render_starter_pages "$@"; }
+create_admin_pages()   { render_admin_settings_pages "$@"; }

data/scripts/lib/install/platform.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+# =========================================================================
+# scripts/lib/install/platform.sh
+# =========================================================================
+# Platform / Ruby detection helpers used by install.sh.
+#
+# Bash 3.2-compatible — no `declare -A`, no `=~` capture groups.
+#
+# Functions exported:
+#   detect_os               -> Darwin | Linux | CYGWIN | MINGW | unknown
+#   detect_ruby_version     -> e.g. "2.6.8" or "none"
+#   ruby_version_lt_27      -> exit 0 when ruby < 2.7
+#   needs_macos_gemfile     -> exit 0 when macOS + ruby < 2.7
+#   detect_platform         -> auto | wsl | macos | linux | unknown
+# =========================================================================
+
+# Returns: Darwin | Linux | CYGWIN | MINGW | unknown
+detect_os() {
+    uname -s 2>/dev/null || echo "unknown"
+}
+
+# Returns the ruby version string (e.g. "2.6.8"), or "none" if ruby is absent.
+detect_ruby_version() {
+    if ! command -v ruby >/dev/null 2>&1; then
+        echo "none"
+        return
+    fi
+    # ruby --version prints: ruby 2.6.8p205 (2021-07-07 ...) [platform]
+    # We want "2.6.8" — strip the trailing pNNN patch indicator via sed.
+    ruby --version 2>/dev/null | awk '{print $2}' | sed 's/p[0-9]*//' | sed 's/-.*//' | tr -d '\r'
+}
+
+# Returns 0 (true) if the current Ruby version is < 2.7.0, 1 (false) otherwise.
+# Uses awk so arithmetic is safe even with partial version strings.
+ruby_version_lt_27() {
+    local ver
+    ver=$(detect_ruby_version)
+    [ "$ver" = "none" ] && return 1  # no ruby → don't apply macOS caps
+    awk -v ver="$ver" 'BEGIN {
+        n = split(ver, a, ".")
+        if (a[1]+0 == 2 && a[2]+0 < 7) exit 0
+        exit 1
+    }'
+}
+
+# Returns 0 (true) when running on macOS with system Ruby < 2.7.
+# This is the condition that triggers use of Gemfile.macos.template.
+needs_macos_gemfile() {
+    local os
+    os=$(detect_os)
+    [ "$os" = "Darwin" ] && ruby_version_lt_27
+}
+
+# Detect runtime platform. Honours $PLATFORM if explicitly set.
+# Returns: macos | linux | wsl | unknown
+detect_platform() {
+    if [[ "${PLATFORM:-auto}" != "auto" ]]; then
+        echo "$PLATFORM"
+        return
+    fi
+    # WSL detection (check before generic Linux)
+    if grep -qiE '(microsoft|wsl)' /proc/version 2>/dev/null; then
+        echo "wsl"
+    elif [[ "$(uname -s)" == "Darwin" ]]; then
+        echo "macos"
+    elif [[ "$(uname -s)" == "Linux" ]]; then
+        echo "linux"
+    else
+        echo "unknown"
+    fi
+}

data/scripts/lib/install/profile.sh

@@ -0,0 +1,113 @@
+#!/usr/bin/env bash
+# scripts/lib/install/profile.sh
+#
+# Minimal pure-bash YAML reader for templates/profiles/*.yml.
+# Bash 3.2 compatible. Schema is intentionally simple (scalar key/value
+# + flat string lists) so we don't need yq/python.
+#
+# Public API:
+#   profiles_dir <REPO_ROOT>             — absolute path to profiles dir
+#   list_profile_names <REPO_ROOT>       — newline-separated profile slugs
+#   profile_path <REPO_ROOT> <name>      — absolute path to a profile yml
+#   profile_get_scalar <file> <key>      — print a scalar value or empty
+#   profile_get_list <file> <key>        — print list items, one per line
+#   profile_print_summary <file>         — pretty-print full profile
+
+profiles_dir() {
+    local repo_root="$1"
+    echo "$repo_root/templates/profiles"
+}
+
+list_profile_names() {
+    local repo_root="$1"
+    local dir
+    dir="$(profiles_dir "$repo_root")"
+    [ -d "$dir" ] || return 1
+    # List *.yml stems, sorted, excluding any leading-dot files
+    ( cd "$dir" && for f in *.yml; do
+        [ -e "$f" ] || continue
+        echo "${f%.yml}"
+    done ) | sort
+}
+
+profile_path() {
+    local repo_root="$1" name="$2"
+    local p
+    p="$(profiles_dir "$repo_root")/${name}.yml"
+    [ -f "$p" ] || return 1
+    echo "$p"
+}
+
+# Extract a scalar value: lines like `key: value`. Strips surrounding
+# whitespace and quotes. Ignores list lines (starting with `-`).
+profile_get_scalar() {
+    local file="$1" key="$2"
+    [ -f "$file" ] || return 1
+    awk -v k="$key" '
+        # match "  key: value" or "key: value" at top level (no leading dash)
+        $0 ~ "^[[:space:]]*" k "[[:space:]]*:" {
+            sub("^[[:space:]]*" k "[[:space:]]*:[[:space:]]*", "")
+            # strip trailing comments
+            sub(/[[:space:]]+#.*$/, "")
+            # strip surrounding quotes
+            gsub(/^["'\'']|["'\'']$/, "")
+            print
+            exit
+        }
+    ' "$file"
+}
+
+# Extract a flat list under a key. Returns nothing for `key: []` or missing.
+profile_get_list() {
+    local file="$1" key="$2"
+    [ -f "$file" ] || return 1
+    awk -v k="$key" '
+        BEGIN { inblock = 0 }
+        # Start: "key:" line with nothing (or just a comment) after it
+        $0 ~ "^[[:space:]]*" k "[[:space:]]*:[[:space:]]*(#.*)?$" {
+            inblock = 1
+            next
+        }
+        inblock {
+            # End block on next non-list, non-blank, non-indented line
+            if ($0 ~ /^[[:space:]]*-[[:space:]]+/) {
+                line = $0
+                sub(/^[[:space:]]*-[[:space:]]+/, "", line)
+                sub(/[[:space:]]+#.*$/, "", line)
+                gsub(/^["'\'']|["'\'']$/, "", line)
+                print line
+                next
+            }
+            if ($0 ~ /^[[:space:]]*#/) next
+            if ($0 ~ /^[[:space:]]*$/) next
+            inblock = 0
+        }
+    ' "$file"
+}
+
+profile_print_summary() {
+    local file="$1"
+    [ -f "$file" ] || { echo "(profile file not found: $file)" >&2; return 1; }
+    local name display desc legacy rec
+    name="$(profile_get_scalar "$file" name)"
+    display="$(profile_get_scalar "$file" display_name)"
+    desc="$(profile_get_scalar "$file" description)"
+    legacy="$(profile_get_scalar "$file" legacy_flag)"
+    rec="$(profile_get_scalar "$file" recommended_for)"
+    printf '  %-9s %s\n' "$name" "$display"
+    [ -n "$desc" ]   && printf '            %s\n' "$desc"
+    [ -n "$legacy" ] && printf '            → install.sh %s\n' "$legacy"
+    [ -n "$rec" ]    && printf '            For: %s\n' "$rec"
+    local includes excludes
+    includes="$(profile_get_list "$file" includes)"
+    excludes="$(profile_get_list "$file" excludes)"
+    if [ -n "$includes" ]; then
+        printf '            Includes:\n'
+        echo "$includes" | sed 's/^/              - /'
+    fi
+    if [ -n "$excludes" ]; then
+        printf '            Excludes:\n'
+        echo "$excludes" | sed 's/^/              - /'
+    fi
+    echo
+}

data/scripts/lib/install/template.sh

@@ -0,0 +1,137 @@
+#!/bin/bash
+# =========================================================================
+# scripts/lib/install/template.sh
+# =========================================================================
+# Template rendering for install.sh.
+#
+# Functions exported:
+#   render_template TEMPLATE_FILE [OUTPUT_FILE]
+#       Replace {{VAR_NAME}} placeholders. If OUTPUT_FILE omitted, writes
+#       to stdout.
+#
+#   create_from_template TEMPLATE_REL OUTPUT_FILE [FALLBACK_CONTENT]
+#       Resolution order:
+#         1. Local templates ($TEMPLATES_DIR/$TEMPLATE_REL)
+#         2. Remote fetch from $GITHUB_RAW_URL/templates/$TEMPLATE_REL
+#            (only when REMOTE_INSTALL=true)
+#         3. FALLBACK_CONTENT (literal string)
+#       Existing OUTPUT_FILE is preserved (skipped with a warning).
+#
+#   templates_available
+#       Returns 0 when $TEMPLATES_DIR is set and points to an existing dir.
+#
+# Required globals (provided by install.sh / install.conf):
+#   THEME_NAME, THEME_GEM_NAME, THEME_DISPLAY_NAME,
+#   GITHUB_USER, GITHUB_REPO, GITHUB_URL, GITHUB_RAW_URL,
+#   DEFAULT_PORT, DEFAULT_URL,
+#   JEKYLL_VERSION, FFI_VERSION, WEBRICK_VERSION, COMMONMARKER_VERSION,
+#   GITHUB_PAGES_MAX_VERSION, COMMONMARKER_MACOS_VERSION,
+#   RUBY_MIN_VERSION_MACOS, INSTALL_MODE, REMOTE_INSTALL, TEMPLATES_DIR
+#
+# Optional globals (used when set):
+#   FORK_GITHUB_USER, FORK_SITE_NAME, FORK_AUTHOR, FORK_EMAIL,
+#   SITE_TITLE, SITE_DESCRIPTION, SITE_AUTHOR, SITE_EMAIL,
+#   REPOSITORY_NAME
+# =========================================================================
+
+# Render a template file, replacing {{VAR_NAME}} placeholders.
+render_template() {
+    local template_file="$1"
+    local output_file="${2:-}"
+
+    if [[ ! -f "$template_file" ]]; then
+        return 1
+    fi
+
+    local content
+    content=$(cat "$template_file")
+
+    # Replace all known placeholders. Order matches the original install.sh
+    # implementation to guarantee identical output.
+    content=$(echo "$content" | sed \
+        -e "s|{{THEME_NAME}}|${THEME_NAME}|g" \
+        -e "s|{{THEME_GEM_NAME}}|${THEME_GEM_NAME}|g" \
+        -e "s|{{THEME_DISPLAY_NAME}}|${THEME_DISPLAY_NAME}|g" \
+        -e "s|{{GITHUB_USER}}|${FORK_GITHUB_USER:-$GITHUB_USER}|g" \
+        -e "s|{{GITHUB_REPO}}|${GITHUB_REPO}|g" \
+        -e "s|{{GITHUB_URL}}|${GITHUB_URL}|g" \
+        -e "s|{{GITHUB_RAW_URL}}|${GITHUB_RAW_URL}|g" \
+        -e "s|{{DEFAULT_PORT}}|${DEFAULT_PORT}|g" \
+        -e "s|{{DEFAULT_URL}}|${DEFAULT_URL}|g" \
+        -e "s|{{JEKYLL_VERSION}}|${JEKYLL_VERSION}|g" \
+        -e "s|{{FFI_VERSION}}|${FFI_VERSION}|g" \
+        -e "s|{{WEBRICK_VERSION}}|${WEBRICK_VERSION}|g" \
+        -e "s|{{COMMONMARKER_VERSION}}|${COMMONMARKER_VERSION}|g" \
+        -e "s|{{GITHUB_PAGES_MAX_VERSION}}|${GITHUB_PAGES_MAX_VERSION:-232}|g" \
+        -e "s|{{COMMONMARKER_MACOS_VERSION}}|${COMMONMARKER_MACOS_VERSION:-~> 0.23}|g" \
+        -e "s|{{RUBY_MIN_VERSION_MACOS}}|${RUBY_MIN_VERSION_MACOS:-2.6.0}|g" \
+        -e "s|{{SITE_TITLE}}|${FORK_SITE_NAME:-${SITE_TITLE:-My Jekyll Site}}|g" \
+        -e "s|{{SITE_DESCRIPTION}}|${SITE_DESCRIPTION:-A Jekyll site built with ${THEME_NAME}}|g" \
+        -e "s|{{SITE_AUTHOR}}|${FORK_AUTHOR:-${SITE_AUTHOR:-Site Author}}|g" \
+        -e "s|{{SITE_EMAIL}}|${FORK_EMAIL:-${SITE_EMAIL:-your@email.com}}|g" \
+        -e "s|{{CURRENT_DATE}}|$(date +%Y-%m-%d)|g" \
+        -e "s|{{CURRENT_YEAR}}|$(date +%Y)|g" \
+        -e "s|{{REPOSITORY_NAME}}|${REPOSITORY_NAME:-$THEME_NAME}|g" \
+        -e "s|{{RAW_GITHUB_URL}}|${GITHUB_RAW_URL}|g" \
+        -e "s|{{FORK_GITHUB_USER}}|${FORK_GITHUB_USER:-${GITHUB_USER}}|g" \
+        -e "s|{{INSTALL_MODE}}|${INSTALL_MODE:-full}|g" \
+        -e "s|{{GITHUB_PAGES_URL}}|https://${FORK_GITHUB_USER:-${GITHUB_USER}}.github.io/${REPOSITORY_NAME:-$THEME_NAME}|g")
+
+    if [[ -n "$output_file" ]]; then
+        mkdir -p "$(dirname "$output_file")"
+        echo "$content" > "$output_file"
+    else
+        echo "$content"
+    fi
+}
+
+# Create a file from template with automatic fallback to embedded content.
+create_from_template() {
+    local template_path="$1"
+    local output_file="$2"
+    local fallback_content="${3:-}"
+
+    # Skip if output already exists
+    if [[ -f "$output_file" ]]; then
+        log_warning "$(basename "$output_file") already exists, skipping to preserve content"
+        return 0
+    fi
+
+    # Try local template first
+    if [[ -n "${TEMPLATES_DIR:-}" ]] && [[ -f "$TEMPLATES_DIR/$template_path" ]]; then
+        render_template "$TEMPLATES_DIR/$template_path" "$output_file"
+        log_info "Created $(basename "$output_file") from template"
+        return 0
+    fi
+
+    # Try to fetch from GitHub for remote installs
+    if [[ "${REMOTE_INSTALL:-false}" == "true" ]]; then
+        local remote_url="${GITHUB_RAW_URL}/templates/$template_path"
+        local remote_content
+        if remote_content=$(curl -fsSL "$remote_url" 2>/dev/null); then
+            local temp_file
+            temp_file=$(mktemp)
+            echo "$remote_content" > "$temp_file"
+            render_template "$temp_file" "$output_file"
+            rm -f "$temp_file"
+            log_info "Created $(basename "$output_file") from remote template"
+            return 0
+        fi
+    fi
+
+    # Use fallback content if provided
+    if [[ -n "$fallback_content" ]]; then
+        mkdir -p "$(dirname "$output_file")"
+        echo "$fallback_content" > "$output_file"
+        log_info "Created $(basename "$output_file") from fallback"
+        return 0
+    fi
+
+    log_warning "Could not create $(basename "$output_file") (no template or fallback)"
+    return 1
+}
+
+# Check if templates are available (TEMPLATES_DIR set + directory exists).
+templates_available() {
+    [[ -n "${TEMPLATES_DIR:-}" ]] && [[ -d "$TEMPLATES_DIR" ]]
+}