Deployment Guide

Quick Start

  1. View the preview: Open preview.html in your browser to see what the site will look like
  2. Install Ruby: Download from rubyinstaller.org (Windows)
  3. Run setup: Execute setup.ps1 (Windows) or setup.sh (Mac/Linux)
  4. Test locally: Run bundle exec jekyll serve and visit http://localhost:4000

GitHub Pages Deployment

Step 1: Create GitHub Repository

  1. Go to GitHub and create a new repository
  2. Name it something like bigjungle-net or your-username.github.io
  3. Make it public (required for free GitHub Pages)

Step 2: Push Your Code

# Initialize git repository
git init

# Add all files
git add .

# Commit files
git commit -m "Initial Jekyll site from WordPress export"

# Add GitHub repository as origin
git remote add origin https://github.com/YOUR-USERNAME/YOUR-REPO-NAME.git

# Push to GitHub
git push -u origin main

Step 3: Enable GitHub Pages

  1. Go to your repository on GitHub
  2. Click Settings tab
  3. Scroll down to Pages section
  4. Under Source, select GitHub Actions
  5. The site will automatically build and deploy

Step 4: Access Your Site

Your site will be available at:

Custom Domain (Optional)

To use a custom domain like bigjungle.net:

  1. Add CNAME file to repository root:
    bigjungle.net
    
  2. Configure DNS with your domain provider:
    • Add CNAME record: wwwYOUR-USERNAME.github.io
    • Add A records for apex domain:
      185.199.108.153
      185.199.109.153
      185.199.110.153
      185.199.111.153
      
  3. Update GitHub Pages settings:
    • Go to repository Settings → Pages
    • Enter your custom domain
    • Enable “Enforce HTTPS”

Adding More Content

If you want to convert more posts from the WordPress XML:

  1. Install Python 3
  2. Install html2text: pip install html2text
  3. Run the conversion script: python convert_posts.py

Manual Post Creation

Create new posts in _posts/ with this format:

---
layout: post
title: "Your Post Title"
date: YYYY-MM-DD HH:MM:SS +0000
author: "Author Name"
categories: ["Category1", "Category2"]
tags: ["tag1", "tag2"]
---

Your content here in Markdown format.

Site Configuration

Edit _config.yml to customize:

Troubleshooting

Ruby Installation Issues

Jekyll Build Errors

GitHub Pages Build Failures

Performance Optimization

Maintenance

Support

For issues with: