Fruch's Blog

A personal blog powered by Jekyll and hosted on GitHub Pages.

Quickstart

Prerequisites

You need Ruby (>= 2.7) and Bundler installed.

Linux (Ubuntu/Debian)

sudo apt-get update
sudo apt-get install ruby-full build-essential zlib1g-dev
gem install bundler

macOS

Ruby is pre-installed on macOS. If you need a newer version, use Homebrew:

brew install ruby
gem install bundler

Make sure the Homebrew Ruby is on your PATH. Add this to your ~/.zshrc or ~/.bash_profile:

export PATH="/opt/homebrew/opt/ruby/bin:$PATH"

Windows

Install Ruby using RubyInstaller (choose the version with DevKit). After installation, run:

gem install bundler

Install Dependencies

Clone the repository and install the required gems:

git clone https://github.com/fruch/fruch.github.com.git
cd fruch.github.com
bundle install

Preview the Blog Locally

bundle exec jekyll serve --livereload

Or use the Rake task:

rake preview

The site will be available at http://localhost:4000. Changes to files are automatically detected and the browser will refresh.

Build the Site

To generate the static site without starting a server:

bundle exec jekyll build

The output is written to the _site/ directory.

Creating a New Post

rake post title="My New Post"

This creates a new Markdown file in _posts/ with the correct front matter.

Deployment

The site is automatically built and deployed to GitHub Pages via a GitHub Actions workflow on every push to master.

License

Creative Commons