Anúncios

Um anúncio é uma regular page do Hugo, contida no diretório announcements de um idioma. Isso significa que aproveitamos o tratamento nativo do Hugo para páginas com datas (futuras ou expiradas), internacionalização e outros, mostrando ou ocultando banners automaticamente dependendo da data de compilação, determinando a ordem dos banners, lidando com fallback para banners em inglês, etc.

Atualmente, os anúncios são usados apenas como banners. Eventualmente, também poderemos oferecer suporte a anúncios um pouco mais gerais.

Criando um anúncio

Para adicionar um novo anúncio, crie um arquivo Markdown no diretório announcements da sua localização utilizando o seguinte comando:

hugo new --kind announcement content/SUA-LOCALIZACAO/announcements/nome-do-arquivo-de-anuncio.md

Ajuste o comando de acordo com o idioma e nome de arquivo desejado. Adicione o texto do anúncio como o conteúdo da página.

Para banners, o conteúdo da página deve ser uma frase curta.

Lista de anúncios

Qualquer anúncio aparecerá no site quando sua data de compilação estiver entre os campos date e expiryDate do anúncio. Quando esses campos estiverem ausentes, os valores padrão serão considerados como “agora” e “para sempre”, respectivamente.

Os anúncios aparecerão na ordem padrão das páginas, determinada através da função Regular pages do Hugo. Ou seja, os anúncios mais “leves” (por peso: weight) aparecerão primeiro; quando os pesos forem iguais ou não especificados, os anúncios mais recentes (por data: date) aparecerão primeiro, etc.

Portanto, se você quiser forçar um anúncio ao topo, utilize um valor negativo para o campo weight.

Caso encontre um erro ou problema com o conteúdo deste repositório, ou queira sugerir uma melhoria, crie uma issue.

Caso descubra um problema de segurança, leia a Política de Segurança antes de abrir uma issue.

Antes de relatar uma nova issue, certifique-se de que já não foi relatada ou corrigida anteriormente, pesquisando através da lista de issues.

Ao criar uma nova issue, inclua um título curto e significativo e uma descrição clara. Adicione o máximo de informações relevantes possível e, se possível, um caso de teste.