Dave Potts - Software Blog

This is a Jekyll-based blog hosted on GitHub Pages. The site is automatically built and deployed using GitHub Pages' default Jekyll processing.

Automatic Deployment

This site uses GitHub Pages' built-in Jekyll support for automatic deployment:

• Main branch: Automatically deployed to the live site when changes are pushed
• Test branch: Automatically deployed to a test environment for preview

Simply push your changes to the appropriate branch and GitHub Pages will handle the Jekyll build and deployment automatically. No manual build steps or custom GitHub Actions are required.

Local Development (Optional)

If you want to preview changes locally before pushing to GitHub, you can set up a local Jekyll environment:

Prerequisites

• Ruby (version 2.7 or later)
• Jekyll

Quick Setup

1. Clone the repository:

   git clone https://github.com/davegoopot/davegoopot.github.io.git
   cd davegoopot.github.io

2. Install Jekyll (if not already installed):

   gem install jekyll

3. Serve the site locally:

   jekyll serve

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

Using GitHub Codespace

You can also use GitHub Codespace for development:

1. Open the repository in GitHub Codespace
2. Run the provided serve script:

   ./serve.sh

3. The site will be available at the provided Codespace URL

Site Structure

The site follows standard Jekyll conventions:

• _config.yml - Site configuration
• _layouts/ - Page templates
• _posts/ - Blog posts
• images/ - Image assets for blog posts
• docs/ - Documentation and guides
• index.md - Homepage
• Static HTML files for individual pages

Content Creation

Adding Images to Blog Posts

For a complete guide on including hand-drawn diagrams and other images in your blog posts, see the Image Inclusion Process Guide. This covers the complete workflow from paper sketch to published blog post, including:

• Photography best practices
• Image optimization techniques
• Jekyll-specific implementation details
• Troubleshooting common issues

📱 Mobile Workflow Guide - Complete setup for Android users who want to commit directly from their phone using Termux:

• Termux terminal setup for full git functionality
• Daily workflow examples
• Pro tips and troubleshooting

Important Notes

• The _config.yml file must remain in the root directory for GitHub Pages to build the site correctly
• GitHub Pages automatically processes Jekyll sites, so no manual build or deployment steps are needed
• Changes pushed to the main branch are automatically deployed to the live site