# Anúncios

> Crie anúncios ou banners para eventos especiais.

---

LLMS index: [llms.txt](/llms.txt)

---

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 {#creating-an-announcement}

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

```sh
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.

<div class="alert alert-primary" role="alert"><div class="h4 alert-heading" role="heading">Para localizações</div>



Caso esteja criando uma **versão localizada de um anúncio existente**,
certifique-se de usar o **mesmo nome de arquivo** do anúncio em inglês.

</div>


## Lista de anúncios {#announcement-list}

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](https://gohugo.io/methods/site/regularpages/) 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_][new-issue].

Caso descubra um problema de segurança, leia a
[Política de Segurança](https://github.com/open-telemetry/opentelemetry.io/security/policy)
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_](https://github.com/open-telemetry/opentelemetry.io/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc).

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.

[new-issue]:
  https://github.com/open-telemetry/opentelemetry.io/issues/new/choose