Depois de muitas tentativas e enrolações, finalmente aqui está esse tal de blog.

Essa é a minha primeira experiência em criar blog, e esse é o meu primeiro post. Sou estrangeiro, escrevo mal, então pode acontecer de eu escrever errado (e podem rir, hehehe), mas quero escrever algo para registar os meus estudos, problemas e também compartilhar para todos das coisas que eu gosto.

Então vamos ao que interessa! Como este blog foi feito em Jekyll, então vou falar sobre como criar o blog em Jekyll e hospedar no GitHub, usando template que o Willian Justin criou, que também foi quem me ajudou a subir este blog.

O processo é bem simples, apesar de ter tido algumas dificuldades, acredito que demoraria muito mais se não tivesse ajuda do Willian.

O que é Jekyll?

Resumidamente, o Jekyll é um gerador, no qual é possivel criar template de site e posts separadamente, deixando que o Jekyll faça combinação do template e posts automaticamente e gerando páginas em HTML puro, sem precisar de banco de dados, Java, PHP, C# ou qualquer outra coisa!

E com o nosso grande GitHub, é possivel até de ficar sem gasto nem com hospedagem e nem com domínio (ganhei $2.00 por falar isso hein, mentira).

Passo 1 - Conta GitHub

Como o blog será hospedado em GitHub, então primeiro de tudo é ter uma conta no GitHub, eu acredito que a maioria dos desenvolvedores já devem ter a sua conta, e se não tiver, não tem muito segredo, é só entrar no site e cadastrar.

Passo 2 - Fork

Depois que estar com a conta do GitHub logado, só precisa fazer um fork do repositório do template no qual vamos usar.

Fork

Passo 3 - Renomear Repositório

Para que o GitHub crie o domínio e hospeda o seu site, o nome do repositório precisa seguir a regra definida, que é o seuUserName.github.io.

Supondo que o meu username do GitHub é lai32290, o nome do repositório terá que ser chamado de lai32290.github.io.

Existe alguma outra forma para que funcione mesmo deixando algum outro nome qualquer, porém como não é o caso.

Após renomear o repositório corretamente, precisa esperar um tempinho para que o GitHub crie o domínio, e já pode começar tentar acessar a URL com o nome do repositório, no meu caso: lai32290.github.io, caso aparecer o blog, mesmo com layout quebrado, significa que está funcionando.

Passo 4 - Clone

Agora que tem o template no seu repositório, é necessário baixar o projeto no computador para facilitar para configuração.

git clone <seu repositorio do template>

Passo 5 - Configurando blog

Como a intenção é hospedar no GitHub e usar o domínio do GitHub também, é preciso fazer algumas configurações no arquivo _config.yml, retirando valor das seguintes propriedades:

baseurl: "" # the subpath of your site, e.g. /blog
url: "" # the base hostname & protocol for your site e.g. http://willianjusten.com.br

E foi aqui mesmo que eu errei, na verdade não lembro exatamente qual configuração eu testei, mas saí atirando para todas as possibilidades, e no fim de tudo, descobri que nada funcionava, simplesmente por causa do cache do navegador!! (Oh god why!?), então caso for testar configuração, garanta que o resultado NÃO SEJA do cache.

Além de alterar essas duas propriedades, também pode preencher as outras da sua maneira.

Passo 6 - Commitando configuração

Depois que ter o arquivo _config.yml configurado, salve e mande de volta para o GitHub:

git add .
git commit -m 'ajustando config'
git push -u origin master

Passo 7 - Pronto!

Após realizar o commit e push das configurações para o GitHub, tente novamente entrar na URL, e terá o layout arrumado e bonitinho, agora é só criar posts e atualizar o seu blog.

Curso

Como neste post estou abordando sobre Jekyll e do template criado pelo Willian, não tem porque eu não falar do curso gratuito que o Willian fez, ensinando Jekyll desde o que é Jekyll, até mesmo hospedar no GitHub e muitas outras dicas e conceitos.

E também foi neste curso que eu aprendi a usar um pouco de Jekyll (afinal, só usando mesmo para saber se realmente aprendeu né), e retomando coragem para me aventurar novamente em Jekyll.

Recomendo que os iniciante e interessados façam o curso, que não é um curso longo nem cansativo.

Curso Jekyll do Willian Justen (It’s free!!)

Conclusão

E essa é a conclusão do meu primeiro post, do meu primeiro blog! Espero que eu consiga caminhar bastante com esse blog!