Reginaldo Demarque
Como criei este blog
Contents
Como Usar R blogdown e Github para criar um blog ou site
Este post é um resumo, para futuras referências de como criar um blog e hospedar no githug pages. Depois de muito “fuçar” na internet, eu encontrei este excelente tutorial:
https://womendotcode.be/blog/how-to-make-blog-with-r-blogdown-and-github-pages/
Neste tutorial, a autora ensina como usar o R Studio + Blogdown para construir o blog e depois como hospedar Github pages.
Muito tutoriais, muito bons aliás, ensinam basicamente a mesma coisa, mas todos usam o Netlify para hospedar o site no github, como este aqui:
O que me incomoda com o Netlify é que no final ele gera um domínio contendo no nome “netlify.app” e eu queria algo somente do github.
Então vou resumir o que está no primeiro tutorial. Lembrando que uso o Ubuntu como sistema operacional:
Criar o Blog
- Instalar o R e o RStudio
- No RStudio Instalar o Blogdown e Hugo. veja como fazer aqui
- Escolher um Hugo theme em: https://themes.gohugo.io/
- Criar um Novo Projeto no RStudio.
Para construir o blog bast usar o comando:
blogdown::build_site()
Para ver o blog basta usar o comando:
blogdown::serve_site()
Com esses comandos vc já consegue ver e manipular o site.
Preparar o site para colcoar no github pages
- Criar uma conta no github
- Criar um novo repositório
- Modificar o arquivo config.yaml
Neste passo, vou tentar esclarecer um ponto que ficou confuso para mim no tutorial.
- Modificar o baseurl: https://<user_name>.github.io/<repo_name>.
- Mudar a pasta /public para outra pasta.
A pasta /public é onde o blogdown constroi o site. Para colocar no github a gente vai mudar esta pasta de lugar. Para isso, primeiro criamos uma pasta nova fora da pasta onde o está o projeto do blog. A sugestão do tutorial é criar esta pasta um nível acima da pasta /public, ou seja, no mesmo nível da pasta do projeto. Por exemplo se pasta do projeto é rblog_example e está dentro do diretório /home. Cria-se uma nova pasta /myblog também dentro da pasta /home.
Daí, a gente vai no config.yaml e muda/acrescenta a seguinte linha:
publishdir: ../myblog
Atenção: Dependendo do tema, o nome deste item pode mudar.
Pronto, agora toda vez que rodar o comando blogdown::build_site() ele vai construir o site nessa pasta para ser hospedada no github.
Hospedar no github pela pimeira vez
No terminal, entrar na pasta /myblog e digitar na sequência:
git init
git add .
git commit -m “<algum comentário>”
git branch -M main
git remote add origin https://github.com/<nome do repositório>
git push -u origin main
Pronto, agora a pasta foi enviada para o github pages. Depois disso basta ir no repositório, em settings->pages e escolher main e directory /root e salvar. Com isso o site estará criado e já terá um link.
Publicar modificações
Todas as vezes que modificar o site e quiser publicar as modificações, basta:
- Construir o site novamente com blogdowm::build_site()
- No terminal entrar na pasta /myblog e executar:
git add .
git commit -m “Atualização XXX”
git push origin main