How To Get Started With Jekyll On Endless OS

Tags: codenewbie, webdev, beginners
Published: 2021-03-21 15:50:42

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](https://en.wikipedia.org/wiki/Endless_Computers)  out


And if you're an andless OS user , you already know what this is. so we're moving on.
<br>
But before getting started with jekyll, you need to install the  [requirements](https://jekyllrb.com/docs/installation/#requirements) :

 
<img src="https://cdn.hashnode.com/res/hashnode/image/upload/v1616329151881/wAtsCPGfN.png">

If you goolge "how to install ruby on linux" and go to the  [ruby's official page for installation](https://www.ruby-lang.org/en/documentation/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 <i>because endless OS is only compatible with Flatpak Applications and ruby doesn’t have a Flatpak version</i>
BUT there is a way to install it .
<br>

- <h3> Step One </h3>

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


- <h3> Step Two </h3>

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

- <h3> Step Three </h3>
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<br>
```
gem install jekyll bundler
```

B. Create a new Jekyll site<br>
```
jekyll new myblog
```

C. Change into your new directory<br>
```
cd myblog
```

D. Build the site and make it available on a local server<br>
```
bundle exec jekyll serve --livereload
```

--livereload flag will automatically refresh the page


E. Go to  [localhost:4000](http://localhost:4000
) 


For more information you can head over to [Jekyll's site](https://jekyllrb.com) and read the documents .
 

______________________________
<b>PS. Remember, You have to run the commands in toolbox : </b><br>
```
toolbox enter --release 33
```

I'd like to thank endless forum for helping me to get started with Jekyll.<br>
[Here](https://community.endlessos.com/t/how-to-install-ruby/16428) is the original topic that I have created on forum.

_____________________
Here are a few  cheatsheet that will be usefull: 
<a src="https://guides.github.com/pdfs/markdown-cheatsheet-online.pdf"> markdown cheatsheet 1 </a> <br>

<a src="https://www.markdownguide.org/assets/markdown-cheat-sheet.md"> markdown cheatsheet 2 </a>

<a src="https://www.shopify.com/partners/shopify-cheat-sheet"> liquid template cheat sheet </a>