Skip to content

Latest commit

 

History

History
38 lines (24 loc) · 2.84 KB

README.md

File metadata and controls

38 lines (24 loc) · 2.84 KB
Raw

License: GPL v3

Download and convert bible texts to ebooks

Introduction

The bible is the most read book on Earth. And while it is widely available, it is sometimes difficult to find a PDF format (or to tweak your own), or an epub for your e-reader. The code in this repository downloads bibles in order to convert them to latex/epub format.

It functions in the following steps:

  1. Go to bible.com and open your bible and translation of choice. Any passage will do. For example, in the American Standard Version, an example link is: https://www.bible.com/bible/12/DEU.34.ASV From this link, extract the number (here 12) and the version identifier (here ASV) and add them to the file 00_structures/languages_version.xml. Remove any unwanted versions, otherwise they will all be downloaded sequentially. For the language code lcode, preferably use the ISO 639-3 code for your language. These codes can easily be found on Wikipedia.
  2. Run 01_bible_download.ipynb to download the bible text. It will be saved it to 01_inputs in csv format
  3. Run 02_process.ipynb to have the files read from 01_inputs and saved as tex and html documents (output folder: 02_outputs)
    1. Customise your section titles in 00_structures/titles.xml
    2. Customise paragraph breaks in 00_structures/paragraphs.xml
    3. Customise book titles in 00_structures/book_titles.xml
  4. Insert the tex or html into your latex or epub template of choice. A basic latex template is provided in 03_templates. Note that the latex template may not support non-latin alphabets.

Disclaimer on copyright: Many bible texts are copyrighted, and laws differ in each country. The current repository makes it possible to create your own files for your own private use, but please ensure that copyright is respected. It is your responsibility what you do with your finished ebooks, and distributing them may not be legal. This repository is meant for private use.

Provided bible example: Only the American Standard Version (1901) is provided as an example as it is free of copyright and available in the public domain.

Dependencies

Python Jupyter Notebook Pandas

The following python packages are required, beyond the standard that is typically installed:

  • Pandas
  • BeautifulSoup4
  • requests

License

This software and templates are distributed under the GNU GPL version 3 (see license file).