DEV Community

Nazanin Ashrafi
Nazanin Ashrafi

Posted on • Originally published at nazanin-ashrafi.hashnode.dev

How To Get Started With Jekyll On Endless OS

Some of you might wonder what the hell is endless OS?!

Short answer : it's is a Linux-based operating system but it works kinda different.
If you'd like to know more about it, you can check this out

And if you're an andless OS user , you already know what this is. so we're moving on.


But before getting started with jekyll, you need to install the requirements :

If you goolge "how to install ruby on linux" and go to the ruby's official page for installation
you'll see that none of the commands work.

I literally spent 2 days on how to install the requirements. So I'm just gonna save you from wasting your time and googling and all the headaches.

As I said none of the commands will work because endless OS is only compatible with Flatpak Applications and ruby doesn’t have a Flatpak version
BUT there is a way to install it .

  • Step One

For installing ruby, you need to install toolbox first :

toolbox create --release f33
Enter fullscreen mode Exit fullscreen mode

and then run toolbox :

toolbox enter --release f33
Enter fullscreen mode Exit fullscreen mode

After that you can easily install ruby (inside the toolbox) using this command :

sudo dnf install ruby
Enter fullscreen mode Exit fullscreen mode
  • Step Two

Now you need "Rubygem", "GCC" and "Make"

Run this command inside the toolbox and it will install the development tools

dnf -y groupinstall "Development Tools"
Enter fullscreen mode Exit fullscreen mode
  • Step Three

    You're almost done. All you need to do is to run this command in toolbox and install jekyll
sudo dnf install jekyll
Enter fullscreen mode Exit fullscreen mode

You're all set and done with the installation.


Now you can create your first Jekyll site

A. Install the bundler gems

gem install jekyll bundler
Enter fullscreen mode Exit fullscreen mode

B. Create a new Jekyll site

jekyll new myblog
Enter fullscreen mode Exit fullscreen mode

C. Change into your new directory

cd myblog
Enter fullscreen mode Exit fullscreen mode

D. Build the site and make it available on a local server

bundle exec jekyll serve --livereload
Enter fullscreen mode Exit fullscreen mode

--livereload flag will automatically refresh the page

E. Go to localhost:4000

For more information you can head over to Jekyll's site and read the documents .


PS. Remember, You have to run the commands in toolbox :

toolbox enter --release 33
Enter fullscreen mode Exit fullscreen mode

I'd like to thank endless forum for helping me to get started with Jekyll.

Here is the original topic that I have created on forum.


Here are a few cheatsheet that will be usefull:
markdown cheatsheet 1

markdown cheatsheet 2

liquid template cheat sheet

Top comments (0)