Luke Shepard

lshepard.github.io

This repository contains a Jekyll-based website with a Python server for deployment.

Running Locally

There are three ways to run this site locally:

1. Jekyll Only (Simplest Method)

This method runs just the Jekyll site without the Python server. It’s the quickest way to get started for content development:

# Navigate to the Jekyll directory
cd jekyllsite

# Install dependencies (first time only)
bundle install
npm install

# Serve the site locally
bundle exec jekyll serve

The site will be available at http://localhost:4000

2. With Docker Compose (Python + Jekyll Integration)

This method runs both the Jekyll site and Python server together, simulating the full stack:

# Start the services defined in docker-compose.yml
docker-compose up

This will:

• Mount your local Jekyll source files into the container
• Run the Python server with hot reloading
• Make the site available at http://localhost:8080

3. Using Docker (Production-like Environment)

This method builds and runs the site as it would be in production:

# Build the Docker image
docker build -t site .

# Run the container
docker run -p 8080:8080 site

The site will be available at http://localhost:8080

Development Notes

• The Jekyll site is located in the jekyllsite directory
• The Python server is located in the pyserver directory
• Changes to Jekyll files require a rebuild unless using the Jekyll-only method