Caixas e imagens

Notas e avisos

Usa uma caixa quando a informação precisa de se distinguir do texto. Um aviso não precisa de ser um parágrafo inteiro em negrito.

:::tip[Um atalho útil]
Texto com **negrito**, ligações e $fórmulas$.
:::

Uma ideia à margem

Um parêntese reto na margem destaca uma explicação curta sem a pôr dentro de uma caixa.

import Bracket from '../../../components/Bracket.astro';

<Bracket label="Ideia-chave">A explicação que queres destacar.</Bracket>

Soluções que podes abrir

:::details[Ver a resolução]
A solução fica aqui. Experimenta primeiro sem a abrir.
:::

Comparar exemplos

Os separadores deixam comparar duas versões sem repetir a explicação. Também funcionam com as teclas de seta.

n = 4
print(n * (n + 1) // 2)

int n = 4;
std::cout << n * (n + 1) / 2;

Imagens nos dois temas

As fotografias e os logótipos devem manter as cores. Para uma imagem muito clara, podes reduzir o brilho em modo escuro. Para um esquema com fundo branco, podes inverter as cores. Escolhe o filtro ao escrever a página e verifica o resultado nos dois temas.

Cores originais

Menos brilho em modo escuro

Esquemas em modo escuro

import Figure from '../../../components/Figure.astro';

<Figure
  src="/examples/pontos.svg"
  alt="Descrição do que a imagem mostra."
  caption="Legenda e crédito da imagem."
  dark="dim"
/>

Em Markdown simples, também podes escolher o filtro:

::image{src="/examples/pontos.svg" alt="Quatro filas de pontos." dark="dim"}

Preparar uma página

Cria um ficheiro na pasta da cadeira, escolhe a secção e indica a ordem. A navegação aparece automaticamente. O guia de contribuição mostra a estrutura e os campos.