<commit_before>---
title: Publishing your own website with Jekyll
layout: post
image: "/images/tutorial.png"
date: 2018-01-07T10:00:00.000+00:00
tags:
- english
- tutorial
- jekyll
- ruby
- terminal
- site
- github pages
- github
- github
comments: true
description: Learn to get your website up and running using the terminal, jekyll and
  other tools.

---
***

_Author note:_ [Siga esse tutorial em Português.](https://jtemporal.com/do-tema-ao-ar/)

***

In a [pro tip, I talked about how using Jekyll](https://jtemporal.com/choosing-a-jekyll-theme/) is an excellent idea to get your site online. In this tutorial, we will deploy a website using GitHub, Jekyll, and the terminal.

## Choosing a theme

The first step is to go to [Jekyll Themes](http://jekyllthemes.org/) and choose a theme you like. For this tutorial, I choose [Fresh](http://jekyllthemes.org/themes/fresh/), a blog theme, with not only the posts listing but also some extra pages like "About" and "Contact". It's responsive, which is a significant feature if you take into account that much content today is consumed via mobile devices. Take a look at Fresh's Demo:
![fresh demo](https://github.com/artemsheludko/fresh/blob/master/assets/img/fresh.gif?raw=true)

## Preparing the environment

You'll need to install (if you haven't already) the following list of requirements:

* Ruby
* Jekyll
* Git
* Gem

Keep in mind that the next steps are tailored for my operating system (Elementary OS), so you may need to adapt those steps for your OS.

_Edit:_ If you are following this tutorial on macOS Catalina, feel free to skip the installation steps below.

Installing our requirements:

``` console
$ sudo apt install git
$ sudo apt install ruby-full
$ sudo apt install rubygems       # ou rubygems-integration
$ gem install jekyll bundler
```

Why do we need all this?

1. **git**: We'll use [GitHub](http://github.com/) to host our site, and we need git to do that;
2. **ruby-full**: A more stable old version of Ruby. Since Jekyll is a Ruby-built tool, we need it installed on your computer for Jekyll to work;
3. **rubygems**: Just like Python's pip and Node's npm, there is gem for Ruby dependencies. It's a package manager, and a necessary requirement it to install Jekyll and the other packages for Fresh to run;
4. **jekyll**: The static site generator;
5. **bundler**: Is the "inception" of packages, it is a package that controls other packages, it controls versions of packages and their dependencies on projects.

## Downloading the theme

For those who are already used to Git, I think this part will be quite straightforward. The [link to the repository is this one](https://github.com/artemsheludko/fresh). For those who are not used the steps are these:

``` console
$ git clone https://github.com/artemsheludko/fresh.git
```

_Note_: Here, I prefer to clone on purpose, but for those who are more intimate with Git and its processes, you can go ahead and fork it. In this tutorial, I'm cloning it because sometimes, when opening a pull request, you might end up opening one to the original repository instead of your own copy. To avoid that, and make things easier for git beginners, let's go with cloning.

## Running the project

After cloning is time to run this, right?! The steps below will serve your site locally:

``` console
$ cd fresh
$ bundle install
$ bundle exec jekyll serve
```

![Foto do terminal servindo o fresh](https://i.imgur.com/Cxh1nNO.png)
<commit_msg>Update from Forestry.io Jessica Temporal updated _drafts/colocando-um-site-no-ar-com-jekyll-usando-o-terminal.md<commit_after>---
title: Publishing your own website with Jekyll
layout: post
image: "/images/tutorial.png"
date: 2018-01-07T10:00:00.000+00:00
tags:
- english
- tutorial
- jekyll
- ruby
- terminal
- site
- github pages
- github
- github
comments: true
description: Learn to get your website up and running using the terminal, jekyll and
  other tools.

---
***

_Author note:_ [Siga esse tutorial em Português.](https://jtemporal.com/do-tema-ao-ar/)

***

In a [pro tip, I talked about how using Jekyll](https://jtemporal.com/choosing-a-jekyll-theme/) is an excellent idea to get your site online. In this tutorial, we will deploy a website using GitHub, Jekyll, and the terminal.

## Choosing a theme

The first step is to go to [Jekyll Themes](http://jekyllthemes.org/) and choose a theme you like. For this tutorial, I choose [Fresh](http://jekyllthemes.org/themes/fresh/), a blog theme, with not only the posts listing but also some extra pages like "About" and "Contact". It's responsive, which is a significant feature if you take into account that much content today is consumed via mobile devices. Take a look at Fresh's Demo:
![fresh demo](https://github.com/artemsheludko/fresh/blob/master/assets/img/fresh.gif?raw=true)

## Preparing the environment

You'll need to install (if you haven't already) the following list of requirements:

* Ruby
* Jekyll
* Git
* Gem

Keep in mind that the next steps are tailored for my operating system (Elementary OS), so you may need to adapt those steps for your OS.

_Edit:_ If you are following this tutorial on macOS Catalina, feel free to skip the installation steps below.

Installing our requirements:

``` console
$ sudo apt install git
$ sudo apt install ruby-full
$ sudo apt install rubygems       # ou rubygems-integration
$ gem install jekyll bundler
```

Why do we need all this?

1. **git**: We'll use [GitHub](http://github.com/) to host our site, and we need git to do that;
2. **ruby-full**: A more stable old version of Ruby. Since Jekyll is a Ruby-built tool, we need it installed on your computer for Jekyll to work;
3. **rubygems**: Just like Python's pip and Node's npm, there is gem for Ruby dependencies. It's a package manager, and a necessary requirement it to install Jekyll and the other packages for Fresh to run;
4. **jekyll**: The static site generator;
5. **bundler**: Is the "inception" of packages, it is a package that controls other packages, it controls versions of packages and their dependencies on projects.

## Downloading the theme

For those who are already used to Git, I think this part will be quite straightforward. The [link to the repository is this one](https://github.com/artemsheludko/fresh). For those who are not used the steps are these:

``` console
$ git clone https://github.com/artemsheludko/fresh.git
```

_Note_: Here, I prefer to clone on purpose, but for those who are more intimate with Git and its processes, you can go ahead and fork it. In this tutorial, I'm cloning it because sometimes, when opening a pull request, you might end up opening one to the original repository instead of your own copy. To avoid that, and make things easier for git beginners, let's go with cloning.

## Running the project

After cloning is time to run this, right?! The steps below will serve your site locally:

``` console
$ cd fresh
$ bundle install
$ bundle exec jekyll serve
```

<center>
<img src="https://i.imgur.com/Cxh1nNO.png" alt="Terminal running fresh locally">
</center>

{'fraction_non_alphanumeric': 0.08731396172927001, 'fraction_numerical': 0.007654145995747696, 'mean_word_length': 4.188235294117647, 'pattern_counts': {'":': 0, '<': 6, '<?xml version=': 0, '>': 6, 'https://': 12, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3018930', 'n_tokens_mistral': 2099, 'n_tokens_neox': 1960, 'n_words': 1004}