Run Jekyll project on local machine

less than 1 minute read

Step 1: Install Ruby

  • Download and install ruby from here: https://rubyinstaller.org/downloads/

Step 2: Install bundle

  • Go to the root directory of the project. Ex. My-blog
  • Run the following command in the terminal
bundle install

Step 3: Run the application

  • Go to the root directory of the project. Ex. My-blog
  • Run the following command in the terminal
bundle exec jekyll serve

Step 4: Output

  • Browse application using: http://127.0.0.1:4000/ to see the output
  • For my blog you will see _site is created or updated.
  • Copy the content of the _site
  • Pest the content to mahedee.github.io
  • Commit and push both repo - my-blog and mahedee.github.io
  • Now browse the blog site

Archive

Run Jekyll project locally

Here is the list of tools or plugins I needed to install to run the blog locally.

Windows

  1. Install jekyll on windows

VSCode extensions

  1. Markdown All in One
  2. Code Spell Checker

Steps

  1. run bundle install (first time only)
  2. bundle exec jekyll serve to serve the application

Tools that didn’t work

For some unknown reason, installing via choco didn’t didn’t work.

  1. Chocolatey (Kept)
  2. Jekyll (Removed)