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

and then run toolbox :

toolbox enter --release f33

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

sudo dnf install ruby

• 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"

• 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

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

B. Create a new Jekyll site

jekyll new myblog

C. Change into your new directory

cd myblog

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

bundle exec jekyll serve --livereload

--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

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