Jekyll is a static site generator that takes simple files and folders and converts them into a static website. It is developed in the Ruby Language. Jekyll is quite simple when compared to other static site generators.
Here at Ibmi Media, as part of our Server Management Services, we regularly help our Customers to perform related website development queries.
In this context, we shall look into how to install and launch your first static website.
Steps to Install Jekyll on Ubuntu
To install Jekyll, you need to follow the below outlined steps.
1. Setup Ruby development environment first
Run the below command to set up Ruby:
$ sudo apt install ruby-full build-essential zlib1g-dev
- build-essential: this will install required dependency needed to execute ruby environments.
- zlib1g-dev: this package includes development files. Mostly they are header files in C and C++ languages.
2. Configure Ruby gems path and install Jekyll.
Here, We will set up my directory to install Ruby gems in a specific folder. We will also add environment paths and then source the ~/.bashrc. This is how We populated environmental variables in Debian Linux.
3. Install Jekyll and Bundler
Now We will install Jekyll and its companion gem "bundler" which is very helpful to keep gems updated:
$ echo '# Install uby Gems to ~/.gems' >> ~/.bashrc
$ echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
# echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
$ source ~/.bashrc
$ gem install install jekyll bundler
4. Create a new folder for our static site
You will need the following commands to do so:
$ mkdir ./myWebsite
$ cd myWebsite
5. Create a new Jekyll website in the folder
Now, run the below command to create the site in our newly created folder "~/myWebsite":
$ jekyll new
6. Run the build and see your website live on http://localhost:4000/
The command is:
$ bundle exec jekyll serve
You will see that Jekyll is now running with its full power.
How to Uninstall Jekyll from Ubuntu Linux system ?
Why would you remove Jekyll? Maybe you don’t need it. Anyway, It is simple to remove Jekyll. You would need to run the following commands to remove it:
$ gem remove jekyll
[Need assistance in Setting up Jekyll on Debian Linux system ? We can help you. ]