/blog

Blog em Jekyll para o MaratonUSP

Primary LanguageHTMLMIT LicenseMIT

Build Status

MaratonUSP

Esse é o blog do maratonUSP feito na plataforma Jekyll baseado no tema neo-hpstr. Para o apoio às maratonas de programação na USP.

Instalação

Docker

A forma mais fácil (e segura) de compilar o site manualmente é usando Docker.

  1. Instale o Docker (na própria loja do linux)
  2. $ make site
  3. Substitua os arquivos da paste _site na pasta www do servidor remoto

Note que o Docker vai gerar os arquivos com o path do servidor remoto.

Sem docker

  1. Instale o ruby e o rubygems (eu prefiro fazer isso pelo rvm, é o jeito mais fácil)
  2. Instale o bundler gem install bundle
  3. Clone o projeto
  4. Entre na pasta do projeto
  5. Instale as dependências bundle install

Rodando

Com o jekyll instalado, rode bundle exec jekyll serve e visite http://localhost:4000. Voilá.

Criando um post

Todos os posts estão em _posts. Basta copiar um dos posts já existentes e adaptá-lo.

Editando as páginas de história

As páginas de história ficam dentro da pasta pages. Para adicionar novos itens à listagem, é necessário apenas alterar o YAML do cabeçalho copiando os modelos dos anos anteriores.

Editando os cartões no começo da página

Olhe no começo do arquivo index.html, na parte <section id="events"> e adicione uma figure seguindo o modelo das outras existentes. Os ícones ficam em https://fontawesome.com/v4.7.0/icons/.

Editando o template

O site usa o template neo-hpstr que tem um tutorial mais completo. Uma cópia dele está neste repositório em theme-setup/index.md. Para entender como alterar o template e tudo o mais, é interessante ler aquilo.

Atualizando o servidor

Dê push na branch master que github actions vai cuidar de tudo. Ele é dividido em estagios: Build e Deploy. Se o Build falhar você fez algo errado. Se o Deploy falhar é porque o server do ime saiu do ar ou a chave de SSH quebrou por algum motivo.