Por que criei este blog
Este é o primeiro artigo do blog. Ele existe para registrar a motivação e, de quebra, mostrar como cada elemento de formatação aparece na página.
Por que escrever
Escrever obriga a organizar o raciocínio. Alguns motivos:
- documentar o que aprendo para consultar depois;
- compartilhar soluções que me custaram tempo;
- praticar a escrita técnica.
Como vou publicar
- Escrevo um arquivo Markdown em
src/content/blog. - Faço
git pushnamain. - O GitHub Actions valida, gera o site e publica.
Mais detalhes na documentação do Astro.
Escrever é pensar duas vezes: uma ao entender, outra ao explicar.
Uma tabela
| Ferramenta | Função | Linguagem | Licença | Roda no build | Envia JS ao cliente |
|---|---|---|---|---|---|
| Astro | Framework do site | TypeScript | MIT | Sim | Não |
| Shiki | Destaque de sintaxe | TypeScript | MIT | Sim | Não |
| Wrangler | Deploy no Cloudflare | TypeScript | MIT | Não | Não |
Uma imagem
Código
Um trecho em TypeScript:
export function saudacao(nome: string): string {
return `Olá, ${nome}!`;
}
E um comando com uma linha bem longa, que deve rolar dentro do bloco sem quebrar o layout:
npm create astro@latest meu-blog -- --template minimal --typescript strict --no-git --no-install --skip-houston --yes