Samuel Log

Por que criei este blog

Publicado em Atualizado em

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

  1. Escrevo um arquivo Markdown em src/content/blog.
  2. Faço git push na main.
  3. 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

Ilustração genérica com um quadrado e linhas representando texto

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