Este artigo tem o objectivo muito simples de desmistificar os elementos que queremos ter no site (imagem nos artigos, avatar, etc.). É ainda mais subtil porque o comportamento que se obtém com Hugo como servidor web, um site Hugo implantado em páginas de gitlab ou um cluster de nuvens não são os mesmos, dependendo do padrão que se opte por aplicar.
O objectivo deste posto é esclarecer como proceder para facilitar a criação do posto.
*Declaração de responsabilidade: o tutorial oficial é ** muito mau** no caso de um site que se queira colocar sob gitlab Pages!
Gestão de páginas
No contexto de um site em modo blogue, isto é relativamente simples.
O comando ``hugo new directory/postname.md``` permite adicionar mensagens em formato MD à pasta "directório". Normalmente, o "post" é utilizado para um blogue.
Propriedades da página
As propriedades de uma página são geridas no cabeçalho das páginas criadas. Podem ser encontradas na seguinte forma:
---
title: "mon artigo"
date: AAAA/MM/DD/THH:MM:SS
draft: true
Este é o padrão gerado por Hugo. Dois elementos devem ser assinalados:
- Numa implantação de gitlab, apenas páginas de "rascunho: falso" são exibidas. As páginas de "rascunho: verdadeiro" são ignoradas na construção do sítio. É então possível construir um sítio localmente (com a opção -D para draft) e testar algumas páginas enquanto se tira partido do alojamento do gitlab.
- A versão básica pode ser completada com outras informações sobre a página criada:
- subtítulo: para adicionar um subtítulo
- etiquetas: para adicionar etiquetas a um artigo
- categorias: para categorizar artigos
Em suma, nada de louco, mas é útil. Portanto, o cabeçalho do artigo que está a ler é :
---
title: "Gérer du contenu dans un site Hugo"
date: 2020-04-14T09:39:30Z
draft: false
subtitle: "Comment gérer du contenu dans un site statique généré par Hugo"
tags:
- français
- hugo-tips
categories:
- hugo
---
Gestão de imagens
Para gerir as imagens apresentadas num artigo, eis a solução que proponho, que tem a vantagem de trabalhar com hugo localmente, mas também com uma implantação de gitlab:
- Criar uma subpasta "imagens" no directório "conteúdo
- Coloque aí as imagens que pretende que apareçam no seu artigo
- acrescentar
no seu artigo, onde deseja que a imagem apareça.
Gerir conteúdos relacionados com temas (fotos de fundo, avatares, etc.)
Nestes casos, a gestão de imagens locais pode ser complicada de gerir se se quiser que a operação seja idêntica quer se utilize o motor hugo localmente ou na versão Gitlab Pages.
É por isso que proponho a sua gestão da seguinte forma:
Criar um directório chamado "estático" na raiz do seu site. Coloque as imagens que pretende utilizar directamente neste directório, sem as colocar num subdirectório. Elas serão então utilizáveis no seu ficheiro config.toml, bastando para tal dar o seu nome.