This post is to start the new version of my blog. To do this, I move on from wordpress to git pages. So, my technical posts are going to be here. The other posts are going to continue on wordpress.

Then, to start this, I wached the overview in a Udemy here. It’s so simple but is great to have an ideia about GitHub Page.

Steps

The first step is to create an account on github, of course. After that, you have to create a repository with your username followed by ‘github.io’. The next step you need to have some tool to manage the repository. I downloaded the GitHub Desktop. To edit the files I am using the Atom.

To help you with your pages you can use Jekyll that is integrated with GitHub Pages. There is great tutorial that will help you to get an overview of the Jekyll. If you use MacOS, like me, you need be sure about the version of ruby. Jekyll need the version 2.4 installed. For more detail you can read that here.

Facilities

Using the jekylls you can do everything you can do using other tools. You can find themes and edit them. Maybe you can have a more work to do and to learn, but It makes you have more control of your pages using a free account and tools.

Main commands

The Jekyll has some basic commands to help you to manipulate your project. After you create your project it will be create a structure of the page and some configuration files where you will update themes, title, content, etc. The available themes to github you can find here.

#create new project. Can be the same that you cloned from git
gem new username.github.io

# To execute
bundle exec jekyll serve

Other commands

If your variables environment is not configured, maybe you need other commands to start your application;

export PATH=/usr/local/opt/ruby/bin:$PATH
export PATH=$HOME/.gem/ruby/2.6.0/bin:$PATH
bundle exec jekyll serve