4 publicações com a etiqueta "docusaurus"

📌 Resumo dos Pontos Principais (TL;DR)

• O Problema: Diferente de CMS dinâmicos como WordPress, sites estáticos (Docusaurus, Hugo) no GitHub Pages frequentemente disparam o alerta "Ganhos em risco: arquivo ads.txt ausente", porque crawlers encontram erros 404 causados por hidratação tardia ou regras de firewall (WAF).
• A Solução: Inserir o script oficial via headTags no docusaurus.config.ts, disponibilizar o arquivo static/ads.txt na raiz da compilação e criar regras de bypass no Cloudflare WAF para o user-agent Googlebot-AdsTxt.
• O Resultado: Rastreabilidade 100% automatizada por crawlers, zero erros 404 e aprovação rápida no AdSense mantendo pontuação de performance no Lighthouse acima de 95.

Manter um blog no GitHub Pages sob usuario.github.io/projeto é econômico e rápido: basta commitar markdown, dar git push e a página é entregue globalmente.

Porém, ao buscar uma presença profissional e monetização com anúncios, você encontra uma barreira intransponível: o Google AdSense veta totalmente subdomínios gratuitos como *.github.io. Além disso, toda autoridade de domínio construída fica atrelada ao GitHub em vez da sua marca pessoal.

Neste primeiro episódio da nossa série de infraestrutura, demonstramos a migração exata de jbjihwan.github.io/global_blog para https://globaldevlog.com através de uma arquitetura resiliente combinando Porkbun + Cloudflare + GitHub Pages.

Hospedar um blog de engenharia no GitHub Pages sob o endereço usuario.github.io/projeto é uma das formas mais práticas de começar. Contudo, quando a sua audiência cresce e você busca monetização profissional, depara-se com um bloqueio rígido: o Google AdSense proíbe expressamente subdomínios gratuitos como *.github.io. Para obter aprovação e construir autoridade duradoura de marca, um domínio próprio apex é obrigatório.

Migrar um site estático para um domínio customizado envolve muito mais do que cadastrar um registro de DNS: requer delegação de nameservers, terminação de certificados SSL na edge, redirecionamentos canônicos, entrega automática de ads.txt e indexação simultânea no Google, Bing e Naver.

Neste guia, documentamos a migração com zero downtime de jbjihwan.github.io/global_blog para https://globaldevlog.com.

Todo desenvolvedor frontend moderno conhece aquela súbita onda de adrenalina: você roda npm audit no repositório do seu blog ou documentação técnica, e o terminal alerta em vermelho brilhante:

45 vulnerabilities (15 moderate, 15 high, 15 critical)
To address all issues (including breaking changes), run:
  npm audit fix --force

Termos como Critical, Remote Code Execution (RCE) e Prototype Pollution ativam imediatamente o reflexo de digitar npm audit fix --force para eliminar os avisos vermelhos o mais rápido possível.

No entanto, no universo dos Geradores de Sites Estáticos (Static Site Generators - SSG) como Docusaurus, Next.js (SSG) ou Hugo hospedados em GitHub Pages ou AWS S3, esse comando costuma ser um erro fatal: ele quebra compilações de produção ao forçar atualizações com breaking changes, sem aumentar a segurança real do seu site em um único porcento.