In this blog post, we will walk through the process of installing Jekyll on your desktop and publishing it on Github Pages. This is a great way to create and manage your own website or blog.

Install Jekyll on your desktop

Jekyll is a simple, blog-aware, static site generator that’s ideal for personal, project, or organization sites. To get started, you need to install Jekyll on your desktop. Follow the instructions provided on the official Jekyll installation guide.

On Mac

If you’re using a Mac, you’ll need to install Ruby first before you can install Jekyll.

Install Ruby

Ruby is a dynamic, open source programming language with a focus on simplicity and productivity. It has an elegant syntax that is natural to read and easy to write. Here’s how you can install Ruby on your Mac:

brew install chruby ruby-install xz
ruby-install ruby 3.1.3

echo "source $(brew --prefix)/opt/chruby/share/chruby/chruby.sh" >> ~/.zshrc echo "source $(brew --prefix)/opt/chruby/share/chruby/auto.sh" >> ~/.zshrc echo "chruby ruby-3.1.3" >> ~/.zshrc # run 'chruby' to see actual version

ruby -v

Install Jekyll

Once you have Ruby installed, you can proceed with installing Jekyll. Here’s how:

gem install bundler jekyll
jekyll new site
cd site

Deploy

Now that you have Jekyll installed and a new site created, it’s time to deploy your site on Github Pages.

Create repository named {user-name}.github.io

First, you need to create a new repository on Github. The repository name should be in the format {user-name}.github.io.

Commit and push Jekyll code

Next, commit your Jekyll site code to the repository and push the changes. Github Pages will automatically deploy your site upon each commit.

Configure deployment setting

It’s well described on Pages Quickstart

Check website

Finally, you can check your website by navigating to {user-name}.github.io in your web browser. Your Jekyll site should now be live!

Reference

For more information, you can refer to the official Github Pages documentation on creating a Github Pages site with Jekyll.