MdBible - Versões

Como instalar um zip no MdBible

No app, abra Ajustes → Tradução → Instalar de um arquivo zip e escolha o arquivo. O app confere o zip inteiro antes de gravar qualquer coisa: se ele estiver danificado ou não for uma versão, nada é escrito no seu cofre. Se o cofre já tiver uma pasta com a mesma sigla, a instalação é recusada — exclua a versão antiga antes, pelo mesmo menu. Suas anotações e destaques não ficam na pasta da versão, então excluir uma versão não apaga nenhum deles.

Como montar o zip de uma versão

Qualquer texto bíblico que você tenha em Markdown pode virar uma versão instalável. O zip só precisa ter a forma abaixo.

1. Uma pasta com a sigla da versão

O nome da pasta é a sigla — a identidade da versão no app e o nome da pasta que ela vai ocupar no seu cofre. Use só letras e números, sem barras nem dois-pontos, e não use footnotes, que é reservado.

NAA/
  version.md
  01. Gênesis/
    Gn 01.md
    Gn 02.md
    …
  19. Salmos/
    Sl 001.md
    …
  66. Apocalipse/
    Ap 22.md

2. O `version.md`

Na raiz da pasta, um arquivo version.md diz como a versão se chama:

---
name: Nova Almeida Atualizada
id: NAA
version: 1.0.0
language: pt-BR
copyright: Todos os direitos reservados.
---

name é o nome que aparece na lista de versões;
id é a sigla mostrada no cabeçalho do leitor (a mesma da pasta);
version é a sua numeração — mude-a quando corrigir o texto;
language e copyright são informativos.

3. Uma pasta por livro, um arquivo por capítulo

Pastas dos livros: NN. Nome, numeradas na ordem do cânon protestante, de 01. Gênesis a 66. Apocalipse. O que identifica o livro é o número no começo; os nomes vão em português, qualquer que seja o idioma do texto.
Arquivos dos capítulos: Sigla NN.md — Gn 01.md, Mt 05.md. O que identifica o capítulo são os dígitos no fim do nome. Salmos usa três dígitos (Sl 001.md a Sl 150.md).
Uma versão não precisa ter todos os livros: um Novo Testamento só com 40. Mateus a 66. Apocalipse funciona, e o app mostra só o que a versão tem. Capítulos além do cânon (como o Salmo 151) também são lidos.

As siglas dos livros são: Gn, Ex, Lv, Nm, Dt, Js, Jz, Rt, 1Sm, 2Sm, 1Rs, 2Rs, 1Cr, 2Cr, Ed, Ne, Et, Jó, Sl, Pv, Ec, Ct, Is, Jr, Lm, Ez, Dn, Os, Jl, Am, Ob, Jn, Mq, Na, Hc, Sf, Ag, Zc, Ml, Mt, Mc, Lc, Jo, At, Rm, 1Co, 2Co, Gl, Ef, Fp, Cl, 1Ts, 2Ts, 1Tm, 2Tm, Tt, Fm, Hb, Tg, 1Pe, 2Pe, 1Jo, 2Jo, 3Jo, Jd, Ap.

4. Dentro de cada capítulo

Cada versículo é um título de nível 6 com o número, seguido do texto:

###### 1
No princípio, Deus criou os céus e a terra.
###### 2
A terra, porém, estava sem forma e vazia…

Notas de rodapé do tradutor podem ficar no texto (…vazia[^1], com [^1]: a nota no fim do arquivo): o app as mostra como notas de margem do versículo. Um frontmatter no topo do arquivo é permitido e ignorado.

5. Compactar

Compacte a pasta (não o conteúdo dela), em zip comum:

Windows: clique com o botão direito na pasta NAA → Compactar para arquivo ZIP (ou Enviar para → Pasta compactada). No PowerShell: Compress-Archive -Path NAA -DestinationPath NAA.zip
macOS: clique com o botão direito na pasta → Comprimir “NAA”. (A pasta __MACOSX que o Finder acrescenta é ignorada.)
Linux: zip -r NAA.zip NAA

Se você compactar só o conteúdo da pasta, com o version.md na raiz do zip, também funciona: aí a sigla vem do id do version.md. Arquivos que não são .md e arquivos ocultos são ignorados. Um zip com mais de uma versão dentro é recusado — faça um zip por versão.

Dica: a versão já está no seu cofre?

Se você usa o MdBible com um cofre do Obsidian, não precisa de zip nenhum: basta copiar a pasta da versão, nesse mesmo formato, para dentro da pasta da Bíblia do cofre (bible/, ou a que você escolheu em Ajustes). Na próxima vez que o app ler o cofre, a versão aparece na lista.

Read it in English · Léelo en español