What is Jekyll

Jekyll is a static site generator that allows you to have eligent, easy to maintain, and modern websites without the headaches of supporting and maintaining a Wordepress server

Why do I care?

This site actually started out as a Static Site generated via Hugo on Netify then Digital Oceans App platform before I migrated to Wordpress. During my time on wordpress I missed a few key advantages of a static site. Bellow are the big ones:

• The Simplicity of writing posts in a Markdown File
• The lack of security maintance
• The ability to easily write posts on my IPad (Which I am currently)

So why Jekyll?

The reason I choose Jekyll over going back to Hugo is simply do to falling in love with the theme that is now present on the website it gives my website the modern facelift it needed and gave me features I had been wanting for quite awhilte such as a table of content for each post and a site wide search functionality

Setting up Jekyll

Note: These Steps will be specific to setting up the theme and deployment method I use

Guide

Steps

Linux

Install Ruby

sudo apt install ruby

Install Jekyll

gem install bundler jekyll

Setup Github repo

Create a new repository from the Chirpy Starter and name it <GH_USERNAME>.github.io, where GH_USERNAME represents your GitHub username.

Pull down your new Repo and install dependancies

git clone github.com/GH_USERNAME/GH_USERNAME.github.io
cd GH_USERNAME.github.io
bundle install

Follow The bellow guide for setting up Github Actions

Windows

1. Download and install a Ruby+Devkit version from RubyInstaller Downloads. Use default options for installation.
2. Run the ridk install step on the last stage of the installation wizard. This is needed for installing gems with native extensions. You can find additional information regarding this in the RubyInstaller Documentation. From the options choose MSYS2 and MINGW development tool chain.
3. Open a new command prompt window from the start menu, so that changes to the PATH environment variable becomes effective. Install Jekyll and Bundler using gem install jekyll bundler
4. Check if Jekyll has been installed properly: jekyll -v
5. Follow the bellow guide for setting up Github Actions