From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining 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