MdBible - Versiones

Cómo instalar un zip en MdBible

En la app, abre Ajustes → Traducción → Instalar desde un archivo zip y elige el archivo. La app revisa el zip entero antes de escribir nada: si está dañado o no es una versión, no se escribe nada en tu bóveda. Si tu bóveda ya tiene una carpeta con la misma sigla, la instalación se rechaza — elimina antes la versión anterior, desde el mismo menú. Tus notas y resaltados no se guardan en la carpeta de la versión, así que eliminar una versión no borra ninguno de ellos.

Cómo armar el zip de una versión

Cualquier texto bíblico que tengas en Markdown puede convertirse en una versión instalable. El zip solo necesita la forma de abajo.

1. Una carpeta con la sigla de la versión

El nombre de la carpeta es la sigla — la identidad de la versión en la app y el nombre de la carpeta que ocupará en tu bóveda. Usa solo letras y números, sin barras ni dos puntos, y no uses footnotes, que está reservado.

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

2. El version.md

En la raíz de la carpeta, un archivo version.md dice cómo se llama la versión:

---
name: Reina-Valera 1909
id: RV1909
version: 1.0.0
language: es
copyright: Dominio público.
---

• name es el nombre que aparece en la lista de versiones;
• id es la sigla que se muestra en la cabecera del lector (la misma de la carpeta);
• version es tu propia numeración — cámbiala cuando corrijas el texto;
• language y copyright son informativos.

3. Una carpeta por libro, un archivo por capítulo

• Carpetas de los libros: NN. Nombre, numeradas en el orden del canon protestante, de 01. Gênesis a 66. Apocalipse. Lo que identifica el libro es el número del comienzo. Los nombres van en portugués, sea cual sea el idioma del texto — es la forma que comparten todas las versiones de la app.
• Archivos de los capítulos: Sigla NN.md — Gn 01.md, Mt 05.md. Lo que identifica el capítulo son los dígitos del final del nombre. Salmos usa tres dígitos (Sl 001.md a Sl 150.md).
• Una versión no necesita todos los libros: un Nuevo Testamento solo con 40. Mateus a 66. Apocalipse funciona, y la app muestra solo lo que la versión tiene. Los capítulos más allá del canon (como el Salmo 151) también se leen.

Las carpetas de los libros y sus siglas, en orden:

4. Dentro de cada capítulo

Cada versículo es un título de nivel 6 con su número, seguido del texto:

###### 1
En el principio crió Dios los cielos y la tierra.
###### 2
Y la tierra estaba desordenada y vacía…

Las notas al pie del traductor pueden quedarse en el texto (…vacía[^1], con [^1]: la nota al final del archivo): la app las muestra como notas al margen del versículo. Un frontmatter al comienzo del archivo está permitido y se ignora.

5. Comprimir

Comprime la carpeta (no su contenido), en un zip común:

• Windows: clic derecho en la carpeta RV1909 → Comprimir en archivo ZIP (o Enviar a → Carpeta comprimida (en zip)). En PowerShell: Compress-Archive -Path RV1909 -DestinationPath RV1909.zip
• macOS: clic derecho en la carpeta → Comprimir “RV1909”. (La carpeta __MACOSX que añade el Finder se ignora.)
• Linux: zip -r RV1909.zip RV1909

Comprimir solo el contenido de la carpeta, con el version.md en la raíz del zip, también funciona: entonces la sigla sale del id del version.md. Los archivos que no son .md y los archivos ocultos se ignoran. Un zip con más de una versión dentro se rechaza — haz un zip por versión.

Consejo: ¿la versión ya está en tu bóveda?

Si usas MdBible con una bóveda de Obsidian, no necesitas ningún zip: basta con copiar la carpeta de la versión, con esta misma forma, dentro de la carpeta de la Biblia de la bóveda (bible/, o la que elegiste en Ajustes). La próxima vez que la app lea la bóveda, la versión aparece en la lista.

Leia em português · Read it in English