Contexto
Entrei por acaso no vídeo abaixo e me interessei em retomar um site como este com domínio próprio
O vídeo está em inglês, então para facilitar, incluirei em português o que usei do vídeo complementando com ajustes que trouxe por conta própria.
Caso queira saber mais sobre as tecnologias envolvidas, procure por:
Primeiros passos
Segui a forma indicada no vídeo e fiz o acesso ao site do tema. Usei a opção 1 Using the Chirpy Starter.
Crie um novo repositório a partir do Chirpy Starter e nomeie-o <GH_USERNAME>.github.io, onde GH_USERNAME representa seu nome de usuário do GitHub. Lembre-se de tornar esse repositório público se quiser manter no GitHub Pages
Para hospedar no Cloudflare Pages não é necessário seguir uma nomenclatura padrão e o repositório pode ser privado. Saiba mais em Cloudflare Pages
Instalando dependências
Antes de executar pela primeira vez, acesse o diretório raiz do seu site e instale as dependências da seguinte forma:
1
$ bundle
Abra seu VSCode:
1
$ code .
Neste ponto você já está quase pronto para customizar o site.
Execução local
Diferente do indicado no vídeo e na documentação, opte por rodar seu site com o seguinte comando se estiver no Windows 10 com WSL:
1
$ bundle exec jekyll serve --force_polling
Deste modo, cada vez que um arquivo for alterado, Jekyill irá recarregar automaticamente suas alterações.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
$ bundle exec jekyll serve --force_polling
Configuration file: /mnt/c/Users/rrant/Documents/Projetos/ruby/xrs.com.br/_config.yml
Theme Config file: /var/lib/gems/2.7.0/gems/jekyll-theme-chirpy-5.2.1/_config.yml
Source: /mnt/c/Users/rrant/Documents/Projetos/ruby/xrs.com.br
Destination: /mnt/c/Users/rrant/Documents/Projetos/ruby/xrs.com.br/_site
Incremental build: disabled. Enable with --incremental
Generating...
done in 2.978 seconds.
Auto-regeneration may not work on some Windows versions.
Please see: https://github.com/Microsoft/BashOnWindows/issues/216
If it does not work, please upgrade Bash on Windows or run Jekyll with --no-watch.
Auto-regeneration: enabled for '/mnt/c/Users/rrant/Documents/Projetos/ruby/xrs.com.br'
Server address: http://127.0.0.1:4000/
Server running... press ctrl-c to stop.
Regenerating: 1 file(s) changed at 2022-06-20 00:44:19
_posts/2022-06-19-primeiro-site-parte-1.md
...done in 2.8957409 seconds.
Conclusão
Neste documento é possível encontrar o básico para criar um repositório novo com um gerador de site estático, pronto para personalizar, incluir conteúdo e fazer o deploy gratuitamente.