Como criar customizar e postar no seu blog Jekyll

1 - Comece instalando o Jekyll no seu sitema Operacional

gem install bundler jekyll

2 - Depois crie um site novo com o Jekyll e entre no seue 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 pec 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 especialmente em um bom editor de textos, como o Sublime Text e comece a navegar pelos arquivos, você vai encontrar um arquivo chamado _config.yml e neste local você 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 redondinho, não 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 tem um link com alguns locais de temas.

A dica principal é escolher um tema bem conhecido e que esteja sempre sendo atualizado, assim você vai 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 no seu arquivo _config.yml, excluíndo a linha theme: minima para theme: jekyll-theme-persephone.

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

Neste momento não vou alterar mais nada, deixar o tema como está, em outros posts vamos trabalhar 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 ano-mes-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 o edite 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
---