# Bíblia Conectada: dados abertos (versão 1.0.0)

Arquivos para quem quer criar a partir dos dados do site Bíblia Conectada: as ligações entre os versículos (referências cruzadas da OpenBible.info, com votos), o texto da Bíblia Livre (BLIVRE) e o grafo dos capítulos. Tudo sai de código, a partir de fontes livres, e é refeito a cada build do site.

Documentação completa, com cada campo, exemplos em Python e JavaScript e como gerar tudo de novo: https://github.com/alexpiraginet-bot/biblia-conectada/blob/main/DADOS.md

## Arquivos

| Arquivo | O que tem | Registros |
|---|---|---|
| `livros.json` | Os livros: nomes, abreviações e versículos por capítulo | 66 livros |
| `versiculos.csv` | Os versículos, com a contagem de ligações de cada um | 31.102 linhas |
| `ligacoes.csv` | Todas as ligações entre versículos, com votos e direção | 301.539 linhas |
| `capitulos.csv` | Os capítulos, com pares de ligações e posição no grafo | 1.189 linhas |
| `capitulos-arestas.csv` | As ligações entre capítulos (arestas do grafo) | 142.082 linhas |
| `estudos/natal.json` | Números do estudo “Antes do Natal, já estava escrito” | números do estudo |
| `texto/<livro>.json` | Texto da Bíblia Livre, um arquivo por livro (66 arquivos; o nome vem do campo slug de livros.json) | 31.102 versículos |
| `datapackage.json` | Esquema de cada tabela (campos, tipos, chaves), licenças e fontes, no padrão Frictionless Data Package v2 | |
| `LEIA-ME.md`, `LICENSE.txt` | Este texto e as licenças | |
| `SHA256SUMS` | SHA-256 de todos os arquivos | |
| `biblia-conectada-dados-v1.zip` | Só no site: todos os arquivos acima num zip | |
| `manifest.json` | Só no site: tamanho em bytes, SHA-256 e número de registros de cada arquivo (é o que a página /dados lê) | |

CSV: UTF-8 sem BOM, separado por vírgula, com cabeçalho, linhas terminadas em LF; campo com vírgula, aspas ou quebra de linha vai entre aspas, com as aspas internas dobradas (RFC 4180). Campo vazio = sem valor.

## Convenções que mudam os números

- **Grade de versículos:** a da KJV/OpenBible, com 66 livros, 1.189 capítulos e 31.102 versículos. O índice global vai de 0 (Gênesis 1:1) a 31.101 (Apocalipse 22:21) e liga os arquivos.
- **Trechos contam pelo primeiro versículo:** uma referência a Mateus 5:3–12 vira uma ligação com Mateus 5:3, como nos vídeos.
- **Auto-pares ficam de fora:** as 344.799 linhas da OpenBible.info formam 301.584 pares únicos; 45 deles ligam um versículo a um trecho que começa nele mesmo. Sobram 301.539 pares de versículos diferentes, as linhas de ligacoes.csv.
- **Votos:** soma das duas direções; podem ser zero ou negativos (de -86 a 1.477 em ligacoes.csv).
- **Ligações de um versículo:** os outros versículos ligados a ele, contados uma vez cada, com qualquer voto (coluna ligacoes de versiculos.csv). 30.303 versículos têm pelo menos uma.

## Licença e créditos

- `texto/`: texto da Bíblia Livre, sem alterações, sob a licença dela. Ao usar, copie este crédito:

  > Todas as Escrituras em português citadas são da Bíblia Livre (BLIVRE), Copyright © Diego Santos, Mario Sérgio, e Marco Teles, http://sites.google.com/site/biblialivre/ - fevereiro de 2018. Licença Creative Commons Atribuição 4.0 Brasil (http://creativecommons.org/licenses/by/4.0/br/). Reprodução permitida desde que devidamente mencionados fonte e autores.

- Todos os outros arquivos: dados derivados deste projeto, sob a licença Creative Commons Atribuição-CompartilhaIgual 4.0 (CC BY-SA 4.0). Quem reutilizar dá o crédito e compartilha o que derivar pela mesma licença.
- As ligações e os votos vêm da OpenBible.info (CC BY). Crédito: "Referências cruzadas: OpenBible.info", https://www.openbible.info/labs/cross-references/

Sugestão de crédito para este pacote:

> Dados: Bíblia Conectada (https://github.com/alexpiraginet-bot/biblia-conectada), CC BY-SA 4.0. Referências cruzadas: OpenBible.info (CC BY).

## Conferir os arquivos

```
sha256sum -c SHA256SUMS
```