Estudando a Bíblia — Contexto do Projeto

Stack

• Frontend: Astro (static site)
• CMS / fonte da verdade: Sanity (projectId dyg5qtf5, dataset production). WordPress APOSENTADO (2026-06-27): não há mais re-import. Estudos entram pelo Sanity Studio (v6) e, futuramente, pelo SharePoint via API (Projeto 10). Leitura no site via GROQ.
• Backend: Azure Functions (modelo Node v4) em api/ (chat do Escriba, verse, fale-com-o-pastor, newsletter).
• Hosting: Azure Static Web Apps (plano Standard, East US 2)
• Repo: github.com/frabello/estudando_a_biblia
• Domínio: estudandoabiblia.org (DNS via Hostinger, CNAME pendente)

Estrutura esperada

• Páginas estáticas geradas via Astro
• Estudos e conteúdo vindos do Sanity (GROQ); schemas: study, category, bibleBook, dailyVerse, faleComOPastor
• Futuro: /livro/[slug] agregando posts, episódios e vídeos por livro bíblico

Itens pendentes conhecidos

• Apontar domínio via CNAME na Hostinger
• Favicon
• Links do podcast na home
• Sistema de ativação booleana de livros na galeria da home
• Migrar nav do [slug].astro para o componente Nav compartilhado
• Grid de episódios RSS do Anchor
• Página /livro/[slug]
• Reescrever template [slug].astro fiel ao mockup editorial (PR #4)
• Criar Azure Function como proxy da API.Bible (ver docs/template-leitura-slug.md)
• Criar Reusable Blocks no Gutenberg para padrões opt-in do [slug]

Convenções

• Português brasileiro
• Componentes em src/components/
• Páginas em src/pages/

Convenções de conteúdo (Sanity Portable Text, render em [slug].astro)

A fonte do conteúdo é o body (Portable Text) do study no Sanity. O [slug].astro serializa esse Portable Text para HTML. Os recursos editoriais existem estruturados no schema (studio/schemaTypes/study.ts): estilos pullQuote e verseBlock; blocos hebrewBlock, callout e video; anotações refLink, inlineHebrew, footnote (popup) e internalRef (link para outro estudo). O HTML abaixo é o que o serializador EMITE para cada recurso (referência de saída); conteúdo sem marcação continua funcionando normalmente.

• Drop cap (letra capitular dourada) é automático no primeiro parágrafo do post — sem precisar marcar class="lead".
• <p class="pull-quote">…</p> — citação grande destacada, centralizada, em dourado.
• <blockquote>…<cite>Ref</cite></blockquote> ou <div class="verse-block">…<span class="ref">Ref</span></div> — versículo destacado com aspa decorativa e barra dourada à esquerda.
• <div class="hebrew-block"><div class="heb">שָׁלוֹם</div><div class="translit">Shalom</div><div class="meaning">Paz</div></div> — bloco hebraico centralizado.
• <a class="ref-link" data-ref="Sl 23:1" data-verse="O Senhor é o meu pastor…">Sl 23:1</a> ou <a data-ref="…" data-verse="…">…</a> — abre popup de referência bíblica. Se houver chave da API.Bible configurada e data-verse estiver vazio, o popup busca o texto online.
• <span class="hebrew" data-heb="שָׁלוֹם" data-translit="Shalom" data-meaning="Paz">שָׁלוֹם</span> — palavra hebraica inline clicável (translit/meaning opcionais).

Considerar criar Reusable Blocks no Gutenberg para cada padrão.

Variáveis de ambiente (popup de versículos)

O popup de referência bíblica busca o texto online via proxy /api/verse (Azure Function api/src/functions/verse.js), que aceita ?ref=Sl+23:1 e retorna { "text": "...", "version": "..." }. Ordem de fontes no servidor: YouVersion Platform NVI (app setting YVP_APP_KEY, id em YVP_BIBLE_ID, default 129) e, como fallback, API.Bible (BIBLE_API_KEY, BIBLE_API_VERSION_ID, BIBLE_API_VERSION_FALLBACK) e Almeida via bible-api.com. Plano e decisão em docs/plano-nvi-youversion.md.

• BIBLE_PROXY_URL (frontend, build) muda a URL do proxy; default /api/verse.
• Se o post tiver data-verse preenchido, o popup usa esse texto hardcoded e NÃO busca online; data-verse vazio busca ao vivo (NVI).