Using Jekyll on Microsoft via the bash shell.

As mentioned in my previous post, I am using Docker more frequently on Windows 10. If you need a Linux shell then the Ubuntu bash shell from the Windows Store is a really handy tool and often much faster than using Docker. In particular, this is a far more convenient way for me to install and run Jekyll on my Windows laptop without needing to install all the Windows components required by Jekyll (such as Ruby).

Jekyll is worth a closer look, especially if you use GitHub or just want an easy way to create consistent static webpages. Jekyll prepares static webpages from a markup language in the same manner that 1980s technology LaTeX is still used for preparing print documents, especially in the numerical sciences.

This post gives an excellent step by step guide. A slight change is required, probably because of the natural development of the Jekyll software. You also need g++ and the default install of Ruby is now already version 2 or above - in the "Install the Linux Subsystem" code block add the following extra dependencies.

$ sudo -s
$ apt update
$ apt upgrade
$ apt install make gcc g++ ruby ruby-dev

You no longer need the "Install Ruby" section in the original post, jump straight to the "Install Jekyll" section.

$ gem install jekyll

You are then good to go. See the Jekyll pages for more details on usage.

Markdown and Liquid (templates) are both used by Jekyll and are straight forward to learn by examples, see the following mobile friendly Jekyll template

This is a very convenient way to run Jekyll on a Windows laptop and is very fast. Once the Ubuntu shell is running and Jekyll is serving the pages you can open a browser in Windows and see the rendered pages on the default location localhost:4000.

I have also found the Ubuntu shell very convenient for using git without having to startup Visual Studio with Azure DevOps. It is a very handy tool for developers, it has the ssh client and python as standard.

<< Go back to the previous page