From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Mon, 2 Sep 2019 13:46:59 +0900
Subject: Initial commit

---
 macros/latex/contrib/bibletext/bibletext.tex | 76 ++++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 macros/latex/contrib/bibletext/bibletext.tex

(limited to 'macros/latex/contrib/bibletext/bibletext.tex')

diff --git a/macros/latex/contrib/bibletext/bibletext.tex b/macros/latex/contrib/bibletext/bibletext.tex
new file mode 100644
index 0000000000..d51f86acd8
--- /dev/null
+++ b/macros/latex/contrib/bibletext/bibletext.tex
@@ -0,0 +1,76 @@
+\documentclass[a4paper]{ltxguide}
+
+\usepackage[hidelinks]{hyperref}
+
+\title{Typesetting Bible texts with the \textsf{bible} package}
+\author{Camil Staps\footnote{info@camilstaps.nl}}
+\date{Version 0.1.2\\2017-09-01}
+
+\usepackage{bibletext}
+
+\usepackage{framed}
+\usepackage{minted}
+\newenvironment{example}
+	{\VerbatimOut{\jobname.tmp}}
+	{\endVerbatimOut%
+		\begin{framed}
+			\setlength{\parskip}{-10pt}
+			\inputminted[gobble=8]{latex}{\jobname.tmp}
+			\medskip
+			\input{\jobname.tmp}
+		\end{framed}}
+
+\begin{document}
+
+\maketitle
+
+\section{Introduction}
+This package allows you to add Bible texts by specifying references,
+	rather than copying the text into the document.
+
+Under the hood, this uses the \texttt{bible} command,
+	for which you need to install \texttt{bible-kjv}.
+This means that by default you will have the KJV translation.
+Because of the need for this package and other implementation details,
+	this package won't work on Windows.
+
+Because this package uses a binary program under the hood
+	(which is a potential security vulnerability),
+	you need to add the \texttt{-shell-escape} option to the command line arguments of your TeX processor.
+
+\section{Installation and source code}
+The \textsf{bible} package is available from CTAN: \url{https://ctan.org/pkg/bibletext}.
+The source code is on GitHub: \url{https://github.com/camilstaps/bibletext}.
+
+\section{Examples}
+\begin{example}
+	\bibletext{Jn 1:1-2}
+\end{example}
+
+\begin{example}
+	\bibletext[ref=true]{Jn 1:1-2}
+\end{example}
+
+\begin{example}
+	\bibletext[ref=true,omitrepeatedchapter=true]{Jn 1:1-2}
+\end{example}
+
+\begin{example}
+	\bibletext[ref=true,omitchapter=true]{Jn 1:1-2}
+\end{example}
+
+\section{Future work}
+\begin{itemize}
+	\item When \verb$omitrepeatedchapter=true$,
+		the chapter should again be outputted when a new chapter has begun.
+	\item The verse indications should be parsed and a \verb$\versefont$ command should be defined.
+	\item Implement the \verb$translation$ option to allow the writer to select a specific translation.
+\end{itemize}
+
+\section{Incompatibilities}
+The \textsf{bible} package needs to pipe shell commands,
+	for which it needs to do \verb$\DeleteShortVerb{\|}$.
+This means that you cannot use \verb$|foo|$ as shorthand for \verb$\verb|foo|$%
+	\footnote{Credits go to egreg on TeX.SE, \url{http://tex.stackexchange.com/q/294732/23992}.}.
+
+\end{document}
-- 
cgit v1.2.3

