LaTeX-based handout for group study on a Bible passage. Meant to be printed on single 11x17 page, folded in half to make a 4-page booklet.
GPL-3.0 License
LaTeX-based handout for group study on a Bible passage. Handout style is based on Tufte-LaTeX. Output format is PDF, meant to be printed on single 11x17 page, folded in half to make a 4-page booklet.
See sample-handout.pdf for an example handout on Exodus 20. Keep in mind that pages 2 and 3 will be side-by-side in the middle of the 4-page booklet, as depicted in sample-handout-11x17.pdf.
This handout format is the product of many iterations. Here are some of the goals:
Optionally, you're free to include some sort of summary graphic at the beginning of your handout. I happen to like the posters available per book from The Bible Project.
Meant to run on Ubuntu
libxml-xpath-perl
package)jq
package)texlive-extra-utils
package)Start by downloading the submodule code:
git submodule update --init --recursive
Next, obtain the ESV Bible text for your chosen passage into esv.txt
using something like this:
curl -X GET --header 'Accept: application/json' --header 'Authorization: Token #{YOUR_ESV_ORG_API_KEY}' 'https://api.esv.org/v3/passage/html/?q=dan9&include-passage-references=false&include-chapter-numbers=false&include-first-verse-numbers=true&include-verse-numbers=true&include-footnotes=false&include-surrounding-chapters-below=false' | python -mjson.tool > esv.txt
Be sure to replace #{YOUR_ESV_ORG_API_KEY}
with your actual API Key. Also, replace dan9
with your chosen passage.
If you're pulling a non-ESV version from bibles.org, use following instead:
curl -Lg -u #{YOUR_BIBLES_ORG_API_KEY}:X "https://bibles.org/v2/passages.js?q[]=dan9&version=spa-RVR1960&include_marginalia=true" | python -mjson.tool > bible.txt
Next, obtain the ESV Study Bible notes for your chosen passage into study.html
using something like this:
PYTHONIOENCODING=UTF-8 ./curl-auth-csrf.py -i "https://my.crossway.org/cas/login/?service=https://www.esv.org/login/" -d email=#{YOUR_ACCOUNT_EMAIL} https://www.esv.org/partials/study-content/dan9/esv-study-bible/ > study.html
The tool used here is curl-auth-csrf, but you're welcome to download study.html
manually if you want. Be sure to replace #{YOUR_ACCOUNT_EMAIL}
with your actual registered email address. Also, replace dan9
with your chosen passage.
Next, invoke the following:
make clean sources
Next, paste in the entire contents of esv.out
(bible.out
) into handout.tex
.
Next, paste in the contents of study.out
into handout.tex
, line by line.
\begin{studycomment}
and \end{studycomment}
right before the corresponding verse numbers. This will place them in the margin, right next to the verses they apply to.\begin{studycomment*}
and \end{studycomment*}
right before the corresponding verse numbers. This will place them inline, right before the verses they apply to.
\noindent{}
if you're interrupting a paragraphTips:
studyblock*
instead of studycomment*
(as indentation isn't necessary)studycomment*
instances which overlap text from other studycomment
instances, simply convert the studycomment*
to studycommentinline
. This will pull the study comment to be inline with the Bible text.bookoutline
See the sample-handout.pdf for how these styles are used.
As mentioned above, this is meant to be printed on single 11x17 page, folded in half to make a 4-page booklet.
Any remaining space in the handout (through the end of page 4) can be filled with your own LaTeX content, such as your main points, additional graphics, etc.
Be sure to include all required copyright statements, to keep legal your usage of others' content.
Once you're ready to render, invoke the following:
make clean all
Optionally, to see the final product:
xdg-open handout.pdf
As mentioned above, this is meant to be printed on single 11x17 page, folded in half to make a 4-page booklet.
You can use your printer driver to make that conversion, or just use handout-11x17.pdf
, which has already been converted for you.