cantareira.github.io

Arquivos-fonte do site cantareira.github.io.

Os dados se encontram na pasta data e os programas que compilam esses dados, parametrizam e calibram os modelos, e geram as projeções estão nos arquivos .R na pasta _src. Todos os demais arquivos são necessários apenas para a geração do site em si.

Instruções de instalação e configuração.

R

Pacotes do R - CRAN

• earlywarnings
• rmarkdown
• zoo
• dplyr
• dygraphs
• xtable
• Hmisc
• devtools
• pomp versão de desenvolvimento, via:

devtools::install_github('rforge/pomp', subdir='pkg/pomp')

Jekyll

• ruby
• gem (geralmente é instalado junto com ruby)
• nodejs (ou outro interpretador JS)
• Jekyll, via gem:

gem install 'github-pages'

Isso deve criar uma instalação local (na pasta do usuário), tipicamente em $USER/.gem/ruby/. Por praticidade, criamos um alias:

alias jekyll='~/.gem/ruby/2.2.0/bin/jekyll'

Esta forma de instalar Jekyll não é a mais recomendada porque não garante que a versão de Jekyll local é à mesma usada pelo github, mas deve ser suficiente para nossos requisitos, que nsão mínimos.

Fontes do site

• clone do repositório com as fontes:

git clone [email protected]:cantareira/cantareira.github.io.git

As fontes contêm os htmls já processados pelo rmarkdown, mas não a saída do Jekyll, que é realizada pelo próprio github.

• atualizações periódicas são feitas rodando o script update.R, que atualiza o histórico, os arquivos de dados para upload (seção recursos), cria uma nova página de projeções e atualiza o index.html e o sitemap.

• novas páginas são feitas adicionando os arquivos Rmd à pasta _src e gerando os htmls com o comando generate.page('arquivo.Rmd') no shell do R. Esta é uma função criada com no script update.R, que entre outras coisas adiciona um cabeçalho YAML:

sed -i '1i---\n---' arquivo.html

• o conteúdo adicionado pode ser visualizado localmente rodando

jekyll build

jekyll serve

O default é o site ser servido em http://localhost:4000.

• Finalmente, o conteúdo novo é publicado quando fazemos o commit e enviamos pro repositório cantareira no github.