blog.hacking.net.br

se você caiu nesse repositório, 99% das vezes é porque quer publicar um artigo técnico ou mandar alguma correção no hacking.net.br. esse README é o guia prático e sem enrolação de como fazer isso.

o outro 1% é quem quer copiar a estrutura desse blog pra usar no seu próprio projeto. você pode clonar, modificar, redistribuir e fazer o que quiser. a gente não liga pra propriedade intelectual e todo o código aqui é dedicado ao domínio público (UNLICENSE). se quiser rodar pra você mesmo ou fazer self-hosting, faça como a gente fez: LEIA A PORRA DO CÓDIGO FONTE ou consulte o repo original haltman-io/blog.haltman.io. OBRIGADO!

---

como publicar um artigo no blog

o fluxo inteiro é via git e pull request no GitHub. você escreve o artigo em markdown/mdx, testa na sua máquina e manda o PR.

passo 1: fork e clone

1. dê um Fork desse repositório no seu GitHub: github.com/hackingnetbr/blog.hacking.net.br
2. clone o seu fork localmente:

git clone https://github.com/SEU_USUARIO/blog.hacking.net.br.git
cd blog.hacking.net.br

3. instale as dependências:

npm install

(requer Node.js >=20.9.0)

---

passo 2: criar o arquivo mdx

todos os artigos ficam dentro do diretório content/posts/.

crie um novo arquivo com a extensão .mdx. o nome do arquivo vai definir a url do post. por exemplo:

# cria o arquivo content/posts/analise-protocolo-custom.mdx
# url final: https://hacking.net.br/posts/analise-protocolo-custom

se quiser organizar por categorias ou pastas, também pode:

# cria content/posts/reversing/firmware-router.mdx
# url final: https://hacking.net.br/posts/reversing/firmware-router

---

passo 3: preencher o frontmatter

todo post obrigatoriamente começa com um bloco yaml no topo (frontmatter). aqui está o template que você deve usar:

---
title: "engenharia reversa do protocolo xpto"
description: "dissecando o binário e reconstruindo a comunicação via socket raw."
date: "2026-08-30"
updated: "2026-08-30"
author:
  - "seu-usuario-github"
tags:
  - "engenharia reversa"
  - "redes"
  - "c"
featured: false
published: true
image: "/pictures/posts/sua-imagem-de-capa.png"
seo:
  title: "engenharia reversa do protocolo xpto"
  description: "dissecando o binário e reconstruindo a comunicação via socket raw."
  keywords:
    - "engenharia reversa"
    - "socket"
    - "wireshark"
---

seu texto começa aqui em markdown puro ou mdx...

campos do frontmatter:

campo	obrigatório?	descrição
title	sim	título do post (em minúsculas, direto ao ponto).
description	sim	resumo curto de 1 ou 2 frases pro card e busca.
date	sim	data de publicação no formato AAAA-MM-DD.
author	sim	lista com seu username do GitHub (usado pro avatar e link).
tags	sim	lista de tags técnicas (ex: reversing, linux, web).
published	sim	coloque true pra publicar (se for false, vira rascunho e não compila).
featured	não	true se deve aparecer no carrossel de destaque na home.
image	não	caminho da imagem de capa (fica dentro de public/).
seo	não	overrides opcionais de título, descrição e keywords pra tags meta.

---

passo 4: escrever o conteúdo e adicionar imagens

você pode usar markdown padrão, tabelas, listas e blocos de código com destaque de sintaxe:

## dissecando o binário

pegamos o dump de tráfego e analisamos o handshake:

```c
#include <stdio.h>
#include <sys/socket.h>

int main() {
    // seu código aqui
    return 0;
}
```

se precisar colocar imagens:
1. jogue a imagem na pasta `public/pictures/`
2. referencie no mdx usando caminho raiz:

![diagrama do pacote](/pictures/diagrama-pacote.png)

---

passo 5: testar localmente antes de mandar

sempre teste o build local pra garantir que seu mdx não tem erro de sintaxe ou tag quebrada:

# roda o servidor de desenvolvimento
npm run dev

# roda a checagem de tipos e o build estático
npm run build

se o npm run build passar com código 0, seu post tá pronto.

---

passo 6: abrir o pull request

1. commite e suba as alterações pro seu fork:

git add content/posts/seu-artigo.mdx
git commit -m "post: engenharia reversa do protocolo xpto"
git push origin main

2. vá até o repositório oficial github.com/hackingnetbr/blog.hacking.net.br e clique em New Pull Request.
3. dê um título claro no PR e descreva brevemente sobre o que é o artigo.

---

critérios de review (o que passa e o que vai pro lixo)

a gente revisa todos os PRs abertos. os critérios são simples e diretos:

o que é aprovado:

• prova de conceito real: código reproduzível, traces de execução, dumps e passos claros.
• profundidade técnica: write-ups de exploit, engenharia reversa, análise de protocolo, kernel, redes, hardware hacking, dev de baixo nível ou internals.
• honestidade: explicar onde funciona, onde quebra e as limitações reais.

o que é rejeitado sumariamente (/dev/null):

• papo furado e marketing: post pra vender curso, promover ferramenta comercial ou vender consultoria.
• resumo genérico de ia: texto raso gerado em massa sem teste prático ou sem profundidade técnica real.
• autopromoção estilo linkedin: foco em métrica vazia, ego e buzzwords em vez de código e técnica.
• conteúdo copiado/plágio: se for citar trabalho de terceiros, coloque os créditos e referências claras.

---

quer rodar o blog pra você? (o outro 1%)

se você curtiu o layout e quer criar o seu próprio blog estático:

1. clone ou use este repositório como template.
2. configure o blog-settings.json com seus dados, links e redes.
3. altere os arquivos em content/pages/ e content/posts/.
4. rode npm run build:static pra gerar o diretório out/ com html/css/js 100% estático.
5. jogue a pasta out/ no Cloudflare Pages, Vercel, Netlify, GitHub Pages, bucket S3 ou qualquer servidor Nginx/Apache.

se precisar de detalhes avançados de arquitetura ou componentes, leia o código-fonte ou consulte o repo do projeto base em haltman-io/blog.haltman.io.

---

licença

este projeto está sob a licença UNLICENSE. tanto o código quanto os textos são dedicados ao domínio público. clone, quebre, altere e use como quiser.