Local Development

# Install Ruby via Homebrew (recommended)
brew install ruby

# Add Homebrew Ruby to PATH
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Install Bundler
gem install bundler

# Verify installations
ruby --version
gem --version
bundle --version

# Update package list
sudo apt update

# Install Ruby and development tools
sudo apt install ruby-full build-essential zlib1g-dev

# Configure gem installation directory (avoid sudo)
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Install Bundler
gem install bundler

# Clone the repository
git clone https://github.com/jonbeckett/jonbeckett.github.io.git
cd jonbeckett.github.io

# Or if you have SSH configured
git clone git@github.com:jonbeckett/jonbeckett.github.io.git
cd jonbeckett.github.io

# Install all gem dependencies
bundle install

# Alternative: Install without production gems
bundle install --without production

# If bundle install fails, try:
bundle update
bundle install

# Clear bundle cache if needed
bundle clean --force

# Start Jekyll development server
bundle exec jekyll serve

# With live reload (if supported)
bundle exec jekyll serve --livereload

# On specific port
bundle exec jekyll serve --port 4001

# With drafts included
bundle exec jekyll serve --drafts

# With incremental builds (faster)
bundle exec jekyll serve --incremental

# Create new post file
touch _posts/$(date +%Y-%m-%d)-post-title.md

# Or use a script to generate with front matter
cat > _posts/$(date +%Y-%m-%d)-post-title.md << 'EOF'
---
title: "Post Title"
layout: single
date: $(date +%Y-%m-%d)
categories:
  - category
tags:
  - tag1
  - tag2
excerpt: "Post excerpt here"
---

Content here...
EOF

# SCSS files are processed automatically
# Edit assets/css/main.scss or create new SCSS files

# Images can be added to assets/images/
# Reference in posts: ![Alt text](/assets/images/filename.jpg)

# Build site in development mode
bundle exec jekyll build

# Build with drafts
bundle exec jekyll build --drafts

# Build with future posts
bundle exec jekyll build --future

# Build for production (matches GitHub Pages)
JEKYLL_ENV=production bundle exec jekyll build

# Build with specific destination
bundle exec jekyll build --destination /path/to/output

# Install html-proofer for link checking
gem install html-proofer

# Run after building the site
htmlproofer ./_site --check-html --check-links --assume-extension

# Verbose output for debugging
bundle exec jekyll build --verbose

# Check for configuration errors
bundle exec jekyll doctor

# Trace build process
bundle exec jekyll build --trace

# If port 4000 is in use
bundle exec jekyll serve --port 4001

# Find process using port 4000
lsof -i :4000

# Kill process if needed
kill -9 [PID]

# Update all gems
bundle update

# Check for outdated gems
bundle outdated

# Clean bundle cache
bundle clean
rm -rf vendor/bundle
bundle install

# Clear Jekyll cache
rm -rf _site
rm -rf .jekyll-cache
bundle exec jekyll build

# Development (default)
JEKYLL_ENV=development bundle exec jekyll serve

# Production (for testing production builds)
JEKYLL_ENV=production bundle exec jekyll build

# Set in .env file (if using dotenv gem)
GOOGLE_ANALYTICS_ID=G-0J6K0088RD
SITE_URL=http://127.0.0.1:4000

# Install fswatch for better file watching
brew install fswatch

# Or use polling method
bundle exec jekyll serve --force_polling

# Install wdm gem for Windows directory monitoring
gem install wdm
bundle exec jekyll serve