How to install what you need to run the command bundle exec jekyll serve in Linux Mint

If you have to run the command “bundle exec jekyll serve” in Linux Mint

I’ve repeatedly had to run a series of installations in Linux Mint to make the bundle exec jekyll serve command working.

The possibility to test your Jekyll static sites locally before pushing them on GitHub is really useful.

But the basic Linux Mint installation lacks some important pieces of code.

So not only do you have to install the Ruby language but also some other piece of code needed for the system to work.

After browsing the web several times to collect the instructions I decided to consolidate them into a single post.

Now I am on Mint 19.3 Cinnamon edition.

Install Ruby

The first step is to install Ruby.

The easiest way is to use the Mint (and Debian or Ubuntu) apt package manager with the command:

$ sudo apt-get install ruby-full

But if you want the latest release of the language it’s a good choice to use the snap service.

If you have snap, already installed just write as follows:

$ sudo snap install ruby --classic

If you don’t have snap, you must previously install it writing as follows:

$ sudo apt update
$ sudo apt install snapd

Now you have Ruby installed and you can install also Jekyll and Bundler as gems with gem install jekyll bundler but it probably won’t be enough.

The next step could be to install the GNU Compiler Collection, GCC.

Install the GNU Compiler Collection

If the bundler compilation fails you may get the following error message:

file.c:1:18: fatal error: stdio.h: No such file or directory
compilation terminated.

In this case you need to install a compiler for the C language.

In Linux Mint this step is really easy and you only have to type the following command lines:

sudo apt update 
sudo apt install build-essential

Now you have Ruby and GCC installed but it still might not be enough because you may receive another error alert regarding the lack of zlib.

Nokogiri needs zlib

I have been warned a few times about the compilation block due to an error in the library zlib_while building _Nokogiri with a notification like the following one:

Building nokogiri using packaged libraries.
Using mini_portile version 2.1.0
checking for gzdopen() in -lz... no
zlib is missing; necessary for building libxml2

This means that zlib must be installed to continue the construction required by the system.

The solution found in the web and directly experienced is the following:

sudo apt-get install libpng-dev
sudo apt-get install --reinstall zlibc zlib1g zlib1g-dev

Now everything should be all right now and the command bundle exec jekyll serve should be successful and you can enjoy your local Jekyll site before pushing it on GitHub or other online platforms.

Summary table

Command Target
bundle exec jekyll serve What we need to reach
sudo apt-get install ruby-full Install Ruby from repository
sudo snap install ruby –classic Install Ruby from Snap
sudo apt install snapd Install Snap if not available in the system
sudo apt install build-essential Install GCC and other compilers
sudo apt-get install libpng-dev Install libpng-dev
sudo apt-get install –reinstall zlibc zlib1g zlib1g-dev Install zlibc zlib1g zlib1g-dev

That’s all, I hope

I hope that’s all, otherwise we’ll just have to go back and look for more information to integrate these notes.

Thank you for your attention.

Originally published at https://francopasut.github.io on January 5, 2020.

Comments

Post a Comment

Popular posts from this blog

Vim: searching for text containing a slash or a question mark

Vim: searching for text containing a slash or a question mark Vim: the search command To activate a text search in Vim, press one of the following trigger keys in your keyboard: the slash "/" key (do not confuse with the back-slash "\" key) the question mark key. By pressing the slash "/" key will activate a forward search. By pressing the question mark "/" key will activate a backward search. To move the cursor to the results in your document, press the "n" key (mnemonic for “ next ”). To invert the direction of the cursor, press the "N" key, (“upper n”) . What about if you need to search for a slash or a question mark , i.e. the same trigger characters , in your document? You can prepend the Escape character to the trigger key. The Escape character The Escape character is the back-slash key: "\" . Just an example: if you need to forward search (then with / trigger k...
Read more

Vim: Cut, Copy and Paste to and from the system clipboard

Image
Vim: Cut, Copy and Paste to and from the system clipboard Table of Contents 1. Cut, Copy and Paste using the computer keyboard 2. Vim and the clipboard 3. From Vim to the Clipboard 4. From the Clipboard to Vim 5. Some key shortcuts in gVim Figure 1: Vim 1 Cut, Copy and Paste using the computer keyboard Everybody knows how to use the keyboard combinations Ctrl-c , Ctrl-x , and Ctrl-v in Windows and Linux (or Cmd-c , Cmd-x and Cmd-v in macOS) to copy, cut and paste text across applications. Many think that those combinations are universal and work with any application. But Vim and gVim are different, they use another system to exchange information with the rest of the IT world. For example, in Vim under Linux, the key combination Ctrl-v corresponds to the visual block function and does not affect the pasting text. I wrote this article to remind me, as a non-programmer, the key combinations to be used in the Vim world to sha...
Read more