# Como publicar um artigo (Os Filhos da Luz) ## Publicar com um clique (recomendado) Requisitos (uma vez): o site está num repositório GitHub ligado à Netlify (Import from Git → deploy automático a cada commit). 1. GitHub → Settings → Developer settings → Personal access tokens → **Fine-grained** → Repository access: só o repo do site → Permissions: **Contents: Read and write** → Generate. 2. No Editor (topo): cola `utilizador/repo` e o token. Deve aparecer "ligado ✓". Ficam guardados só nesse browser. 3. Escreve/gera o artigo → **Publicar agora no site**. O Editor grava `posts/.md`, actualiza `posts.json`, `sitemap.xml` (e `silos.json` no modo pilar). A Netlify publica em ~1 min. 4. Para editar um artigo já online: "Editar artigo publicado" → escolhe → Carregar → alteras → **Actualizar artigo publicado** (mantém a data original, actualiza "Revisado em"). Sem GitHub ligado, segue o modo manual abaixo. ## 1. Escreva o artigo Crie `posts/.md` em Markdown. Suportado: `##` e `###` títulos, listas, `> citações`, tabelas, **negrito**, [links](url), `---`. Slug = título em minúsculas, sem acentos, com hifens (ex.: `evangelho-de-filipe-explicado`). ## Silos (estrutura do blog) Cada artigo pertence a um silo (campo `"silo"`): `gnosticismo`, `demiurgo-arcontes`, `nag-hammadi`, `sofia-pleroma`, `despertar`, `cristianismo`. Cada silo tem uma página-pilar (`Pilar.dc.html?silo=…`) definida em `silos.json` (título, keyword, intro, termos para links automáticos). Para criar um silo novo, acrescente um bloco a `silos.json`. ## Página-pilar de um silo No Editor, modo **Pilar do silo** → "Preencher brief com o silo" → Gerar. Sai um guia de 2.000+ palavras com um H2 por artigo do silo. O bloco JSON leva `"pilar": true` — a página Pilar.dc.html mostra-o em destaque no topo. Um pilar por silo; quando publicar artigos novos no silo, regenere ou edite o pilar para os ligar. ## Keyword finder No Editor (painel no topo, à direita): escreve um termo-semente (ex.: "demiurgo") → o finder puxa as sugestões reais do autocomplete do Google Brasil (o termo + a–z + "o que é / quem é / como / por que…"), remove duplicados e, com a chave Groq, estima procura (alta/média/baixa), dificuldade e intenção. Verde = lacuna (nenhum artigo cobre), amarelo = já coberto. Clicar preenche o brief e muda para o modo Artigo. Para volumes exatos: instala a extensão **Keywords Everywhere** (plano grátis mostra tendências e sugestões; créditos pagos mostram volume/CPC). Botão "Abrir no Google BR" mostra os dados da extensão nos resultados; "Copiar lista" cola no Bulk Upload da extensão para ver volumes de todos os termos de uma vez. Alternativa grátis: Planejador de palavras-chave do Google Ads. ## Corrigir SEO com IA Se o check SEO falhar, o botão verde "Corrigir SEO com IA" pede ao Groq apenas as correções em falta (keyword, meta description, tabela, citação, FAQ, palavras), sem reescrever o resto. Itens a amarelo (!) são manuais: [VERIFICAR] e ligações internas. ## Links internos automáticos O conversor liga automaticamente, no corpo do artigo, a primeira ocorrência dos `terms` do silo (→ pilar) e das `keywords` de outros artigos (→ esse artigo). Escolha keywords curtas e naturais — são elas que geram os links. Quando publica um artigo novo, os antigos passam a ligar para ele sem editar nada. ## E-E-A-T Cada artigo mostra autor (→ Equipa.dc.html), data de publicação e "Revisado em" (campo `"updated"`), caixa "Fontes e verificação" e schema Article + BreadcrumbList + FAQPage (as perguntas em `### ` dentro de `## Perguntas frequentes` viram FAQ schema automaticamente). Se o artigo acompanha um vídeo do canal, preencha `"video": "ID_DO_YOUTUBE"` — o vídeo aparece embutido no topo e entra no schema como VideoObject. ## 2. Registre no índice Acrescente um bloco ao INÍCIO de `posts.json` (o primeiro é o destaque do blog): ```json { "slug": "evangelho-de-filipe-explicado", "tag": "Textos de Nag Hammadi", "tema": "Textos", "silo": "nag-hammadi", "date": "2026-09-10", "dateLabel": "10 Set 2026", "updated": "2026-09-10", "title": "Evangelho de Filipe: o que ele ensina sobre o sacramento da câmara nupcial", "description": "Frase de 140–160 caracteres que aparece no Google e no cartão.", "keywords": ["evangelho de filipe", "câmara nupcial gnóstica"], "read": "7 min", "url": "Artigo.dc.html?slug=evangelho-de-filipe-explicado", "cover": "https://…", "video": "ID_DO_YOUTUBE" } ``` ## 3. Sitemap Acrescente a linha em `sitemap.xml`: `https://osfilhosdaluz.com/Artigo.dc.html?slug=evangelho-de-filipe-explicado2026-09-10` ## 4. Capa No Editor, gere a capa com Pollinations (grátis) — o link vai no campo `"cover"`. Para não depender do Pollinations, salve a imagem em `assets/covers/.jpg` e use esse caminho. --- ## Prompt para o Groq (PT-BR, SEO) > Escreva em **português do Brasil** (você, nunca "tu"; evite lusitanismos como "equipa", "telemóvel", "percebes"). > Tema: {TEMA}. Palavra-chave principal: "{KEYWORD}" — use no primeiro parágrafo, num H2 e na conclusão, sem forçar. > Formato Markdown: introdução de 2 parágrafos que responde de imediato à pergunta do leitor; 4–6 seções com `##`; uma tabela com dados concretos (textos, datas, nomes); uma citação `>` de um texto gnóstico com a fonte; seção "## Como aprofundar isso no livro"; seção final `## Perguntas frequentes` com 3 perguntas em `###`. > 900–1300 palavras. Tom direto, provocador e acolhedor, sem promessas de cura ou milagre. Onde não tiver a fonte exata, escreva [VERIFICAR]. Depois de gerar: confira as citações nos textos originais, substitua os [VERIFICAR] e acrescente a sua leitura. Publique 2–3 por semana — de preferência um artigo para cada vídeo novo do canal (modo "Artigo a partir de vídeo" no Editor). ## Ideias de artigos que rankeiam em PT-BR - "O que é gnosticismo" / "Quem foi Valentim" / "O que é Pleroma" - "Evangelho de {Tomé, Filipe, Maria Madalena, Judas} explicado" - "Demiurgo é o Deus da Bíblia?" / "Arcontes existem?" - "Sinais de que você é uma alma antiga / está despertando" - "Gnosticismo x Cristianismo: 7 diferenças" - "Livros gnósticos para iniciantes" --- ## Captura de e-mails (Netlify Forms) O formulário "Guia grátis" já está marcado com `data-netlify="true"` (nome: **guia-gratis**). Depois de publicar na Netlify: 1. Painel do site → **Forms** → vê as submissões (nome, e-mail, data). Grátis até 100/mês. 2. **Forms → Settings → Form notifications** → "Email notification" → recebes cada lead por e-mail. 3. O guia (`assets/guia-7-sinais.pdf`) é entregue na página de obrigado com botão de download imediato. 4. Para automação de e-mails (sequência a vender o livro): exporta CSV em Forms → importa no MailerLite/Brevo; ou liga a integração Zapier/Make "Netlify Forms → MailerLite". Nota: a Netlify só regista o formulário se ele existir no HTML no momento do deploy. Como a página é renderizada por JS, se o painel Forms não mostrar "guia-gratis", cria um ficheiro `forms.html` com o formulário estático (ver abaixo) e faz novo deploy: ```html ``` ## Barra de administração A barra "Páginas do funil" (abas Vendas/Captura/Obrigado, Blog, Editor, SEO) fica escondida para visitantes. Para a ver no site publicado, abre `https://osfilhosdaluz.com/?admin` — fica activa durante a sessão do browser. --- ## Google AdSense Liga/desliga num só lugar: **Editor → painel "Google AdSense"** → interruptor "Anúncios ligados" + ID de publisher → **Guardar no site** (grava `config.json` no GitHub; Netlify publica em ~1 min). Sem GitHub ligado: "Copiar config.json" e substituir o ficheiro manualmente. - Desligado (padrão): nenhum script do Google carrega, nem o aviso de cookies aparece. - Ligado: aviso de cookies → após "Aceitar", anúncios em artigos (topo, meio, fim), sidebar dos pilares, lista do blog. Nunca em vendas/captura/obrigado/Editor. - IDs dos blocos são opcionais; vazio = anúncios automáticos. Actualiza `ads.txt` com a linha que o AdSense fornece. - Candidatura: adsense.google.com com osfilhosdaluz.com — espera ter 15–20 artigos. Privacidade, Termos, contacto e consentimento já cumprem os requisitos.