From dbd8aabd96c560c57b1f6bce21b484468eb729e4 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 2 Sep 2017 21:42:48 +0000 Subject: bibletext (2sep17) git-svn-id: svn://tug.org/texlive/trunk@45196 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/bibletext/LICENSE | 21 ++++++++ .../texmf-dist/doc/latex/bibletext/bibletext.pdf | Bin 136914 -> 139812 bytes .../texmf-dist/doc/latex/bibletext/bibletext.tex | 58 +++++++++++++-------- 3 files changed, 58 insertions(+), 21 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/bibletext/LICENSE (limited to 'Master/texmf-dist/doc/latex/bibletext') diff --git a/Master/texmf-dist/doc/latex/bibletext/LICENSE b/Master/texmf-dist/doc/latex/bibletext/LICENSE new file mode 100644 index 00000000000..38669306c23 --- /dev/null +++ b/Master/texmf-dist/doc/latex/bibletext/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2016-2017 Camil Staps + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/Master/texmf-dist/doc/latex/bibletext/bibletext.pdf b/Master/texmf-dist/doc/latex/bibletext/bibletext.pdf index 6ee4947dfd0..28324fe464b 100644 Binary files a/Master/texmf-dist/doc/latex/bibletext/bibletext.pdf and b/Master/texmf-dist/doc/latex/bibletext/bibletext.pdf differ diff --git a/Master/texmf-dist/doc/latex/bibletext/bibletext.tex b/Master/texmf-dist/doc/latex/bibletext/bibletext.tex index a7872894ad6..d51f86acd80 100644 --- a/Master/texmf-dist/doc/latex/bibletext/bibletext.tex +++ b/Master/texmf-dist/doc/latex/bibletext/bibletext.tex @@ -2,59 +2,75 @@ \usepackage[hidelinks]{hyperref} -\title{Inserting Bible texts with the \textsf{bible} package} +\title{Typesetting Bible texts with the \textsf{bible} package} \author{Camil Staps\footnote{info@camilstaps.nl}} -\date{Version 0.1\\2016-02-18} +\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[xleftmargin=-8pt]{latex}{\jobname.tmp} - \medskip - \input{\jobname.tmp} - \end{framed}} + {\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. +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. +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} + \bibletext{Jn 1:1-2} \end{example} \begin{example} - \bibletext[ref=true]{Jn 1:1-2} + \bibletext[ref=true]{Jn 1:1-2} \end{example} \begin{example} - \bibletext[ref=true,omitrepeatedchapter=true]{Jn 1:1-2} + \bibletext[ref=true,omitrepeatedchapter=true]{Jn 1:1-2} \end{example} \begin{example} - \bibletext[ref=true,omitchapter=true]{Jn 1:1-2} + \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 is 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. + \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 \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}.}. +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