1 - Comece instalando o Jekyll no seu Sistema Operacional

gem install bundler jekyll

2 - Depois, crie um site novo com o Jekyll e entre no seu diretório

jekyll new brpl-blog

cd brpl-blog

• Nota: O nome brpl-blog pode ser substituído por qualquer nome a sua escolha.

3 - Teste

Após estar dentro do seu diretório, rode o comando bundle exec jekyll serve e digite no navegador de sua escolha http://localhost:4000/

Se tudo der certo, você já terá um blog básico rodando na sua máquina com o nome de Your awesome title e o post Welcome to Jekyll!.

4 - Configurando seu Blog

Abra o seu diretório do Jekyll em um bom editor de textos, como o Sublime Text, e comece a navegar pelos arquivos. Você encontrará um arquivo chamado _config.yml, e neste local poderá substituir as informações para ir personalizando seu blog. Por exemplo:

• title: Your awesome title x Bruno Pellizzetti Blog
• email: your-email@example.com x bruno@brunopellizzetti.com.br
• description: Um blog sobre direito, tecnologia, aprendizado e ensino.

Continue configurando seu blog até deixar tudo certinho. Não se esqueça de ir conferindo as alterações no seu navegador.

5 - Instalando um Tema

Para o meu blog, eu escolhi o tema persephone. Gostei do seu design simples e minimalista. No final deste artigo há um link com alguns locais de temas.

A dica principal é escolher um tema bem conhecido e que esteja sempre sendo atualizado. Assim, você evitará bugs e conflitos entre as versões dos aplicativos.

Para instalar, basta entrar no arquivo de gemas do Jekyll, que também está na pasta principal: Gemfile, e substituir o tema padrão que é gem "minima", removendo esta linha e substituindo pela nova linha do nosso novo tema: gem "jekyll-theme-persephone".

Também é necessário alterar o seu arquivo _config.yml, substituindo a linha theme: minima por theme: jekyll-theme-persephone.

Depois, rode no seu sistema o comando bundle, que irá instalar o tema.

Neste momento, não vou alterar mais nada; deixarei o tema como está. Em outros posts, trabalharemos um pouco a customização do tema.

6 - Como criar seu post

Primeiro, vamos fazer uma criação manual. Basta entrar na pasta _posts e gerar um novo arquivo com o formato ano-mês-dia-nome.md, assim: 2021-05-27-como-criar-seu-blog-jekyll.md.

Adicione o seguinte cabeçalho no seu arquivo:

---
layout: post
title:  "Welcome to Jekyll!"
date:   2021-05-27 08:52:05 -0300
categories: jekyll update
---

e editê-lo conforme a necessidade do seu post:

---
layout: post
title:  "Como criar, customizar e postar no seu blog Jekyll"
date:   2021-05-27 09:15:05 -0300
categories: jekyll
---

Links

• Jekyll