Website IC/UFRJ

Este é um experimento para trocar o website atual wordpress por um puramente estático. Neste primeiro momento, o tema e a aparência não estão finalizados. O objetivo é focar inicialmente na organização geral e no conteúdo.

Instalação

O primeiro passo é clonar este repositório.

git clone https://github.com/ic-ufrj/website-estatico

O segundo passo é instalar o Hugo. Eu acho que uma das forma mais fáceis é baixar o "prebuilt-binary" encontrado em https://gohugo.io/installation/ Você pode instalar no PATH ou deixar na raiz do repositório mesmo.

Não sei qual é a versão que nós precisamos, mas no outro website eu reparei que a versão do Hugo que tinha no Fedora era antiga demais.

Rodando o site

Hoje o website não está no github pages! Para ver tem que testar localmente.

Para testar o site localmente, rode hugo serve e abra o seu web-browser em https://localhost:1313/. Ele monitora a pasta com os arquivos markdown e atualiza o browser automáticamente quando você modificar um deles.

Você também pode rodar só hugo para gerar arquivos HTML na pasta public, porém não dá pra abrir esses htmls direto no browser (a página fica quebrada, sem os menus e sem o CSS adequado)

Editando

As duas pastas que você precisa mexer são a pasta content e a static. A content contém o texto do site em markdown e a static contém imagens, etc.

Para criar uma nova postagem, use use "./hugo new content/aulas/aula-NN.md" ou copie uma postagem existente. É importante que o arquivo tenha um cabeçalho com "title:" e que você preencha este title.

Publicando

Para publicar uma postagem, faça o commit e dê push no repositório. Em primeiro lugar, solicite ao administrador do repositório para adicionar você como contribuinte. Em sequida, faça os passos de sempre:

git status
git add arquivos-editados
git commit
git push

Não use URLs absolutos

Hugo (o software) não lida bem com URLs absolutos caso a raiz to website seja um subdiretório, que é o caso do Github Pages caso você ainda não tenha DNS de domínio próprio. Por exemplo, ele põe "/images" em "github.io/images" em vez de "github.io/seurepositorio/images", como gostaríamos.

1. Dentro de postagens markdown, sempre use URLs relativos. Salve as imagens na mesma pasta
2. Em templates HTML, pode ser que você realmente precise de URLs absolutos. Use a função absURL do Hugo. Não coloque "/" no começo! (é um bug do Hugo). Descrição do pepino: gohugoio/hugo#10606