Development Setup

Prerequisites

Install Ruby and development tools:

sudo apt update
sudo apt install ruby-full build-essential zlib1g-dev

Configure gem installation directory (to avoid using sudo):

echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Install Jekyll and Bundler:

gem install jekyll bundler

Initial Setup

Install project dependencies:

bundle install

Run the site

Using Make (recommended):

make run

Or directly with bundle:

bundle exec jekyll serve --livereload --incremental --watch

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

Other Make Commands

• make build - Build the site
• make clean - Remove generated files
• make install - Install dependencies

Installing Jekyll Plugins

1. Add the plugin to your Gemfile:

   group :jekyll_plugins do
     gem "plugin-name", "~> version"
   end

2. Add the plugin to _config.yml:

   plugins:
     - plugin-name

3. Install the new gem:

   bundle install

4. Restart the Jekyll server (Ctrl+C and run the serve command again)