Justificativa

• Página pessoal na forma de site.
  • Portfólio de projetos.
  • Currículum.
  • Matérias de blog.
  • Meios para contato.
• Página de empresa ou projeto.
  • Contato com os clientes.
  • Divulgação da empresa/projeto.
  • Visibilidade.

Objetivos

• Desenvolvimento de sites com Hugo.
• Desenvolvimento com o pacote blogdown.

Sobre

• Hugo: uma estrutura para construção ágil de sites.
• Hugo é baseado na linguagem Go: https://gohugo.io/templates/introduction/.

• Requer instalação do Hugo no SO.

    sudo apt-get install hugo

• Confira a lista de temas: https://themes.gohugo.io/.

Criando o primeiro site em Hugo

1. Visite o tema Academic: https://github.com/gcushen/hugo-academic.
2. Faça uma cópia do repositório: https://themes.gohugo.io/theme/academic/.
3. Copie o diretório exampleSite em outro local.
4. Crie o diretório exampleSite/themes.
5. Cole todo o diretório do hugo em exampleSite/themes renomeando para academic.
6. Abra o terminal em exampleSite e execute no terminal hugo server para levantar uma instância viva do site.
7. Modifique os arquivos gradativamente prestando atenção nos resultados no site.
8. Edite o arquivo config.toml e arquivos em content/.
9. Quando o site estiver pronto, interrompa hugo server e execute hugo para contruir o diretório do site estático.
10. Mova o conteúdo para o seu servidor de páginas.

Exemplos de sites em Hugo

• http://leg.ufpr.br/~fernandomayer/.
• http://www.leg.ufpr.br/~eduardojr/.
• http://semanest.leg.ufpr.br.
• http://dsbd.leg.ufpr.br/.
• http://leg.ufpr.br/~walmes/ensino/web-scraping/.
• http://curso-r.com/.
• http://material.curso-r.com/.

Visão geral

• Hugo possui tudo necessário para:
  • Ter uma página pessoal, de projeto ou de empresa.
  • Manter um blog, portfólio ou diário.
  • Tem vários templates disponíveis.
  • Tem suporte matemático com MathJax.
  • Tem destaque de código (hihlight).
• MAS O HUGO NÃO SOZINHO NÃO SUPORTA DOCUMENTOS DINÂMICOS.
• SOLUÇÃO: usar Rmarkdown!
• blogdown \(\approx\) Hugo \(+\) R Markdown.
• Veja os materiais originais:
  • https://slides.yihui.name/2017-rstudio-conf-blogdown-Yihui-Xie.html;
  • <https://slides.yihui.name/2017-rstudio-webinar-blogdown-Yihui-Xie.html
• Documentação do blogdown:
  • https://bookdown.org/yihui/blogdown/;
  • https://github.com/rstudio/blogdown;
  • https://github.com/yihui/blogdown-yihui-template;

O blogdown

Funcionamento

# Instalar o pacote.
devtools::install_github("rstudio/blogdown")

# Instala o Hugo, cria o site, baixa o tema, etc.
blogdown::new_site()

Estrutura de diretório

• content/ : conteúdo das páginas do site.
• about.md : descrição do site.
• post/ : onde ficam as matérias do blog.
• themes/: onde ficam os temas.
• static/: conteúdo que é copiado para a public/.
• public/: diretório com o site que pode ser publicado em diversos lugares: Netlify, Github, Amazon S3, etc.

Funções úteis

• new_site(): para criar um novo site.
• install_hugo() e install_theme(): para instalar o Hugo ou um novo tema.
• serve_site(): reconstroi e carrega o site conforme são feitas modificações.
• new_post(): cria uma nova matéria para o site.

Exemplo

1. Abrir uma sessão R.
2. Executar blogdown::new_site(dir = <caminho_pro_site>).
3. Modificar arquivos.
4. Executar blogdown::render_site() para ver as modificações em tempo real.
5. Exectuar blogdown::build_site() para gerar o diretório public/.
6. Mover o conteúdo de public/ para local público.

• Parte 2 do Curso: visualização e aplicações.