Debian Codegraph @

texmf-dist/source/latex/pfarrei/pfarrei.dtx

raw
1 % \CheckSum{455}
2 % \iffalse^^A meta-comment
3 % ======================================================================
4 % pfarrei.dtx
5 % Copyright (c) 2013 Markus Kohm
6 % komascript at gmx info
7 %
8 % This work may be distributed and/or modified under the conditions of
9 % the LaTeX Project Public License, version 1.3c of the license.
10 % The latest version of this license is in
11 % http://www.latex-project.org/lppl.txt
12 % and version 1.3c or later is part of all distributions of LaTeX
13 % version 2005/12/01.
14 %
15 % This work has the LPPL maintenance status `unmaintained'.
16 %
17 % This package is currently unmaintained.
18 %
19 % This work consists of the files `README' and `pfarrei.dtx'.
20 %
21 % If you're missing the installation batch file `pfarrei.ins', try
22 % tex pfarrei.dtx
23 % to unpack all files.
24 % The package documentation may be produced repeating
25 % pdflatex pfarrei.dtx
26 % at least three times.
27 % ----------------------------------------------------------------------
28 % pfarrei.dtx
29 % Copyright (c) 2013 Markus Kohm
30 % komascript at gmx info
31 %
32 % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
33 % Version 1.3c.
34 % Die neuste Version dieser Lizenz ist
35 % http://www.latex-project.org/lppl.txt
36 % und Version 1.3c ist Teil aller Verteilungen von LaTeX
37 % Version 2005/12/01.
38 %
39 % Dieses Wert hat den LPPL-Verwaltungszustand `unmaintained' (verwaltet).
40 %
41 % Autor dieses Werkes ist Markus Kohm.
42 %
43 % Das Werk besteht aus den Dateien `README' und `pfarrei.dtx'.
44 %
45 % Falls Sie die Installations-Batch-Datei `pfarrei.ins' vermissen,
46 % probieren Sie einfach einmal
47 % tex pfarrei.dtx
48 % um alle Dateien auszupacken.
49 % Die Anleitung erhalten Sie durch dreimalige Ausführung von:
50 % pdflatex pfarrei.dtx
51 % ======================================================================
52 % \fi^^A meta-comment
53 %
54 % \CharacterTable
55 % {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
56 % Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
57 % Digits \0\1\2\3\4\5\6\7\8\9
58 % Exclamation \! Double quote \" Hash (number) \#
59 % Dollar \$ Percent \% Ampersand \&
60 % Acute accent \' Left paren \( Right paren \)
61 % Asterisk \* Plus \+ Comma \,
62 % Minus \- Point \. Solidus \/
63 % Colon \: Semicolon \; Less than \<
64 % Equals \= Greater than \> Question mark \?
65 % Commercial at \@ Left bracket \[ Backslash \\
66 % Right bracket \] Circumflex \^ Underscore \_
67 % Grave accent \` Left brace \{ Vertical bar \|
68 % Right brace \} Tilde \~}
69 %
70 % \iffalse^^A meta-comment
71 %<*dtx|tex>
72 \begingroup
73 \def\revisiondate$#1: #2-#3-#4 #5${%
74 \gdef\pfarreirevisiondate{#2/#3/#4}%
75 }\revisiondate$Date: 2023-11-22 20:54:26 +0200 (Mi, 22. Nov 2023) $
76 \def\revision$#1: #2 #3${%
77 \gdef\pfarreirevision{#2}%
78 }\revision$Revision: 37 $
79 \endgroup
80 %<*dtx>
81 \def\LaTeXformat{LaTeX2e}
82 \ifx\fmtname\LaTeXformat
83 \makeatletter
84 \let\saved@@end\@@end
85 \def\@@end{\csname fi\endcsname\saved@@end}
86 \makeatother
87 \ProvidesFile{pfarrei.dtx}
88 %</dtx>
89 %<package>\ProvidesPackage{pfarrei}
90 %<a5toa4>\ProvidesFile{a5toa4.tex}
91 [\pfarreirevisiondate\space r\pfarreirevision\space LaTeX2e package
92 (for pastors)]
93 %</dtx|tex>
94 %<*driver>
95 \documentclass{ltxdoc}
96 \usepackage[english,ngerman]{babel}
97 \usepackage[utf8]{inputenc}
98 \usepackage[T1]{fontenc}
99 \usepackage{lmodern}
100 \usepackage{hypdoc}
101
102 \newcommand*{\StartBlock}[1][2]{%
103 \bigskip\nobreak\vskip#1\baselineskip\pagebreak[1]\vskip-#1\baselineskip
104 \nobreak\noindent
105 }
106
107 \CodelineIndex
108 \RecordChanges
109 \GetFileInfo{pfarrei.dtx}
110 \begin{document}
111 \title{Das Pfarrei-Paket\footnote{%
112 \protect\foreignlanguage{english}{Sorry if you don't understand German,
113 but currently there's only a German manual, because the idea of this is
114 from a German article at ``Die \TeX nische Komödie''. But at least you
115 may try to call ``\texttt{a5toa4 --help}'' to get some useful
116 information.%
117 }%
118 }%
119 }
120 \date{\filedate\footnote{Version \fileversion}}
121 \author{Markus Kohm\footnote{komascript at gmx info}}
122 \maketitle
123 \DocInput{pfarrei.dtx}
124 \PrintChanges
125 \PrintIndex
126 \end{document}
127 %</driver>
128 %<*dtx>
129 \fi
130 %</dtx>
131 %<*insfile>
132 \def\batchfile{pfarrei.dtx}
133 \input docstrip.tex
134 \ifToplevel{%
135 \keepsilent
136 \askforoverwritefalse
137 }
138
139 \let\MetaPrefix\relax
140 \declarepreamble\rawpreamble
141
142 Copyright (c) 2013 Markus Kohm
143 komascript at gmx info
144
145 This file was generated from file(s) of the work `pfarrei'.
146 ------------------------------------------------------------------
147
148 It may be distributed under the conditions of the
149 LaTeX Project Public License in the version distributed together
150 with the work `pfarrei'. You may however distribute the work
151 `pfarrei' without all such generated files. See also
152 <http://www.latex-project.org/lppl.txt> for additional
153 information.
154
155 This work has the LPPL maintenance status `unmaintained'.
156
157
158 This package is currently unmaintained.
159
160 The list of files belonging to the work `pfarrei' is given in
161 the file `pfarrei.dtx'.
162
163 \endpreamble
164
165 \let\MetaPrefix\DoubleperCent
166 \edef\texpreamble{\rawpreamble}
167
168 \generate{%
169 \usepreamble\texpreamble
170 \file{pfarrei.sty}{%
171 \from{pfarrei.dtx}{package,tex}%
172 }%
173 \file{a5toa4.tex}{%
174 \from{pfarrei.dtx}{a5toa4,tex}%
175 }%
176 }
177
178 \ifToplevel{%
179 \generate{%
180 \usepreamble\texpreamble
181 \file{pfarrei.ins}{%
182 \from{pfarrei.dtx}{insfile,tex}%
183 }%
184 }%
185 }
186
187 \def\MetaPrefix{--}
188 {
189 {
190 \catcode`\#=11
191 \gdef\Hash{#}%
192 }
193 \xdef\luapreamble{\Hash!/usr/bin/env texlua^^J%
194 ^^J%
195 \rawpreamble}
196 }
197
198 \declarepostamble\luapostamble
199
200 \endpostamble
201
202 \generate{%
203 \usepreamble\luapreamble\usepostamble\luapostamble
204 \file{a5toa4.tlu}{%
205 \from{pfarrei.dtx}{a5toa4,lua}%
206 }%
207 \file{pfarrei.tlu}{%
208 \from{pfarrei.dtx}{pfarrei,lua}%
209 }%
210 }
211
212 \ifToplevel{%
213 \Msg{+-------------------------------------------------------------------}
214 \Msg{| To finish the installation copy the files into a TEXMF tree:}
215 \Msg{| \space\space a5toa4.tlu --> scripts/pfarrei/a5toa5.tlu}
216 \Msg{| \space\space pfarrei.tlu --> scripts/pfarrei/pfarrei.tlu}
217 \Msg{| \space\space a5toa4.tex --> tex/latex/pfarrei/a5toa4.tex}
218 \Msg{| \space\space pfarrei.sty --> tex/latex/pfarrei/pfarrei.sty}
219 \Msg{| If you are not using Windows, you should also copy a5toa4.tlu}
220 \Msg{| to the binary directory of your TeX distribution and rename}
221 \Msg{| it into a5toa4.}
222 \Msg{| If you are using MiKTeX 2.9, you should rename file pfarrei.tlu}
223 \Msg{| into a5toa4.tlu, because the outdated texlua of MiKTeX 2.9 doesn't}
224 \Msg{| search for modules like the current vanilla version of texlua.}
225 \Msg{| If you are using Windows, you should make a copy of runscript.exe}
226 \Msg{| (TeX Live) resp. runtexlua.exe (MiKTeX) at the binary directory}
227 \Msg{| of your TeX distribution and rename it into a5toa4.exe.}
228 \Msg{+-------------------------------------------------------------------}
229 }
230 %</insfile>
231 %<*dtx|doc>
232 \csname endinput\endcsname
233 % \fi^^A meta-comment
234 %
235 % \begin{abstract}
236 % In "`Die \TeX nische Kömdie"', Ausgabe 1/2013 hat Christian Justen über
237 % seinen Einsatz von \LaTeX{} im Pfarrdienst berichtet. Einige der von ihm
238 % verwendeten bash-Scripte und seine Schilderungen dazu haben mich
239 % inspiriert, eine Sammlung zu beginnen, die entsprechende Dinge leisten.
240 % Allerdings habe ich mich entschlossen, keine bash-Script zu verwenden,
241 % sondern die Funktionalität derselben in lua-Scripte für die Ausführung mit
242 % \TeX Lua zu realisieren, da \TeX Lua inzwischen Bestandteil aller
243 % \TeX-Distributionen ist. Somit wurde das ganze besser vom Betriebssystem
244 % unabhängig.
245 %
246 % Ergänzt habe ich das ganze durch einige Befehle und Umgebungen, die für
247 % die Erstellung von Lied- und Gebetsheftchen für den Gottesdienst
248 % praktisch sein könnten. Jedenfalls habe ich selbst Nutzen daraus
249 % gezogen. Weiteres ist geplant.
250 % \end{abstract}
251 %
252 % \tableofcontents
253 %
254 % \section{Die Skripte-Seite}
255 % \label{sec:skripte}
256 %
257 % In besagtem Artikel wurden zwei Skripte, "`\texttt{a5toa}4"' und
258 % "`\texttt{a5toa4bogen}"' vorgestellt. Beide erzeugen aus PDF-Dateien, die im
259 % A5-Format vorliegen, neue PDF-Dateien im A4-quer-Format.
260 %
261 % Das erste, "`a5toa4", arrangiert die A5-Seiten dabei so, dass jeweils zwei
262 % aufeinander folgende A5-Seiten nebeneinandern ausgegeben werden. Das ist vor
263 % allem dann praktisch, wenn man nur einseitig druckt und die Seiten später
264 % geteilt werden sollen. Im folgenden wird diese Ausgabe \emph{side-by-side}
265 % genannt.
266 %
267 % Das zweite, "`a5toa4bogen"', erzeugt hingegen ein sogenanntes Booklet. Dabei
268 % werden die Seiten so angeordnet, dass nach dem beidseitigen Druck, der ganze
269 % Stapel nur noch in der Mitte geknickt werden muss, um eine Art Heft zu
270 % erhalten. Daher wird für diese Ausgabe im Weiteren die Bezeichnung
271 % \emph{booklet} verwendet.
272 %
273 % \StartBlock%^^A
274 % Ich\marginpar{\raggedleft\texttt{a5toa4.tlu}} dachte mir, das könne man in
275 % ein einziges Programm gießen. Dieses heißt bei mir dann schlicht
276 % "`a5toa4.tlu"'. Bei optimaler Installation kann es auch als "`a5toa4"'
277 % angesprochen werden.
278 %
279 % Ruft\marginpar{\raggedleft\texttt{-{}-version}} man das Programm mit der
280 % Option "`\texttt{-V}"' oder "`\texttt{-{}-version}"' auf, so gibt es lediglich
281 % eine Versionsinformation aus.
282 %
283 % Beim\marginpar{\raggedleft\texttt{-{}-help}} Aufruf mit Option
284 % "`\texttt{-h}"' oder "`\texttt{-{}-help}"' wird hingegen eine ausführliche
285 % Hilfe zu den Aufrufmöglichkeiten und den Optionen ausgegeben.
286 %
287 % Man\marginpar{\raggedleft\texttt{-{}-booklet}\\\texttt{-{}-sidebyside}} kann
288 % es aber auch mit einer Reihe von Durchführungsoptionen und Namen von
289 % PDF-Dateien aufrufen. In diesem Fall wird entweder eine booklet- oder eine
290 % side-by-side-Ausgabe erzeugt. Die Wahl, ob eine booklet- oder eine
291 % side-by-side-Ausgabe erfolgen soll, erfolgt über die Optionen
292 % "`\texttt{-b}"' oder "`\texttt{-{}-booklet}"' für booklet
293 % bzw. "`\texttt{-s}"' oder "`\texttt{-{}-sidebyside}"' für
294 % side-by-side. Voreingstellt ist die side-by-side-Ausgabe.
295 %
296 % Für die Durchführung wurde auch ein Verbesserungsvorschlag von Christian
297 % Justen selbst aufgegriffen. Bei ihm haben die Skripte mit einer
298 % Zwischendateien mit dem festen Namen "`\texttt{cj.tmp}"' gearbeitet. Im
299 % Extramfall konnte dies dazu führen, dass Dateien unerwünscht überschrieben
300 % und so vernichtet wurden.
301 %
302 % In meiner Fassung als texlua-Skript wird mit einem temporären Verzeichnis im
303 % aktuellen Arbeitsverzeichnis gearbeitet. Darin wird eine temporäre
304 % \LaTeX-Datei erzeugt und alle Ausgabedateien eines PDF\LaTeX-Laufs
305 % abgelegt. Das PDF-Ergebnis des PDF\LaTeX-Laufs wird dann wieder in das noch
306 % immer aktuelle Arbeitsverzeichnis kopiert. Im Normalfall wird dabei der
307 % Basisname (also ohne Extension) der Ursprungsdatei je nachdem, was erzeugt
308 % wurde, entweder um "`\texttt{-booklet.pdf}"' oder
309 % "`\texttt{-sidebyside.pdf}"' ergänzt. Auch dies ist eine Abweichung von
310 % Christian Justens Original-Skripten, bei denen immer die Ursprungsdatei vom
311 % Ergebnis überschrieben wurde.
312 %
313 % Ein\marginpar{\raggedleft\texttt{-{}-overwrite}} Überschreiben der
314 % Ursprungsdatei wie bei Christian Justens Original-Skripten kann man aber
315 % alternativ ebenfalls erreichen, indem man Option "`\texttt{-o}"' oder
316 % "`\texttt{-{}-overwrite}"' angibt. Nach erfolgreichem PDF\LaTeX-Lauf und dem
317 % Kopieren des Ergebnisses ins aktuelle Arbeitsverzeichnis, wird das temporäre
318 % Verzeichnis samt Inhalt wieder gelöscht.
319 %
320 % Eine weitere Änderung bei mir betrifft die Tatsache, dass man für die
321 % Verarbeitung mehrerer Dateien nicht mehrere Aufrufe benötigt, man kann auch
322 % in einem Aufruf beliebig oft Optionen und Dateien hintereinander anfügen,
323 % die dann nacheinander verarbeitet werden. So würde beispielsweise mit dem
324 % Aufruf:
325 % \begin{verbatim}
326 % a5toa4 -b foo.pdf -s bar.pdf -o bum.pdf
327 % \end{verbatim}\unskip\ignorespaces
328 % sowohl "`\texttt{foo-booklet.pdf}"' als auch "`\texttt{bar-sidebyside.pdf}"'
329 % erzeugt und anschließend "`\texttt{bum.pdf}"' durch eine
330 % side-by-side-Fassung von sich selbst überschrieben werden.
331 %
332 % Es ist zu beachten, dass nach jeder erzeugten Datei die
333 % Überschreibeinstellung von Option "`\texttt{-o}"' oder
334 % "`\texttt{--overwrite}"' aus Sicherheitsgründen wieder aufgehoben wird. Will
335 % man also mehrere Dateien nacheinander bearbeiten und bei mehreren davon soll
336 % die Ursprungsdatei überschrieben werden, so ist vor jeder dieser Dateien die
337 % Option erneut zu setzen.
338 %
339 % Tatsächlich\marginpar{\raggedleft\texttt{pfarrei.tlu}} ist
340 % "`\texttt{a5toa4.tlu}"' aber nur ein Wrapper für
341 % "`\texttt{pfarrei.tlu}"'. Das wurde deshalb so gemacht, damit das
342 % eigentliche Programm leichter durch Versionen in \texttt{TEXMFLOCAL} oder
343 % \texttt{TEXMFHOME} ersetzt werden kann, ohne dass jedes Mal das
344 % \emph{Binary} ersetzt werden muss.
345 %
346 % Eine letzte kleine Änderung meiner Fassung betrifft die Anforderungen an das
347 % Seitenformat der Quelldateien. Im Original wurde mit der \texttt{pdfpages}
348 % Option \texttt{noautoscale} gearbeitet. Damit wurden die Seiten der
349 % Quelldatei nicht an das Seitenformat der Zieldatei angepasst. War die
350 % Quelldatei also nicht im Format A5, sondern beispielsweise A6, dann wurden
351 % zwei A6-Seiten auf einer A4-quer-Seite platziert. War die Quelldatei im Format
352 % A4, passten ihre Seiten nicht einmal auf die A4-quer-Seite. Ich habe diese
353 % Option daher weggelassen. Nun werden die Seiten der Quelldatei automatisch
354 % ins A5-Format gebracht, bevor sie auf der A4-quer-Seite platziert werden.
355 %
356 %
357 % \subsection*{Zusammenfassung\marginpar{\raggedleft\texttt{a5toa4}}}
358 %
359 % Um\marginpar{\raggedleft\texttt{-s}} aus einem Quell-PDF
360 % "`\texttt{foo.pdf}"' ein Ziel-PDF "`\texttt{foo-sidebyside.pdf}"' zu
361 % erzeugen, bei dem die Seiten des Quell-PDF aufeinander folgend,
362 % nebeneinander auf einer A4-quer-Seite platziert sind, verwendet man:
363 % \begin{verbatim}
364 % a5toa4 -s foo.pdf
365 % \end{verbatim}\unskip\ignorespaces
366 % Soll die Ziel-PDF hingegen die Quell-PDF überschreiben, so gibt vor dem
367 % Dateinamen zusätzlich Option "`\texttt{-o}"' an.
368 %
369 % Um\marginpar{\raggedleft\texttt{-b}} aus einem Quell-PDF
370 % "`\texttt{foo.pdf}"' ein Ziel-PDF "`\texttt{foo-booklet.pdf}"' zu erzeugen,
371 % bei dem die Seiten des Quell-PDF so auf einer A4-quer-Seite platziert sind,
372 % dass durch Falten in der Mitte ein Heft entsteht, verwendet man:
373 % \begin{verbatim}
374 % a5toa4 -b foo.pdf
375 % \end{verbatim}\unskip\ignorespaces
376 %
377 % Soll\marginpar{\raggedleft\texttt{-o}} die Ziel-PDF hingegen die Quell-PDF
378 % überschreiben, so gibt vor dem Dateinamen zusätzlich Option "`\texttt{-o}"'
379 % an.
380 %
381 % Informationen\marginpar{\raggedleft\texttt{-V}} über die verwendete Version
382 % von "`\texttt{a5toa4}"' erhält man mit:
383 % \begin{verbatim}
384 % a5toa4 -V
385 % \end{verbatim}\unskip
386 %
387 % Eine\marginpar{\raggedleft\texttt{-h}} Hilfe zum Programm erhält man mit:
388 % \begin{verbatim}
389 % a5toa4 -h
390 % \end{verbatim}
391 %
392 %
393 % \section{Die \LaTeX-Seite}
394 % \label{sec:latex}
395 %
396 % Die \LaTeX-Seite zu den Skripten aus \autoref{sec:skripte} besteht
397 % zunächst einmal aus dem \LaTeX-Dokument "`\texttt{a5toa4.tex}"'. Dieses
398 % lädt wiederum das \LaTeX-Paket "`\texttt{pfarrei.sty}"'. Die eigentliche
399 % Funktionalität verbirgt sich darin.
400 %
401 % \StartBlock%^^A
402 % \DescribeMacro{\AvToAiv}\hspace*{-\marginparsep}\oarg{Original-Datei}\\%^^A
403 % \DescribeMacro{\OriginalFile}%^^A
404 % Die Anweisung \cs{AvToAiv} erledigt die Hauptarbeit für \texttt{a5toa4}. Die
405 % Voreinstellung für das optionale Argument \meta{Original-Datei} ist
406 % \cs{OriginalFile}. Das Skript "`\texttt{a5toa4.tlu}"' setzt dieses Makro
407 % entsprechend.
408 %
409 % \StartBlock[1]%^^A
410 % Man kann das \LaTeX-Paket \textsf{pfarrei} aber auch per
411 % \begin{verbatim}
412 % \usepackage{pfarrei}
413 % \end{verbatim}\unskip
414 % oder
415 % \begin{verbatim}
416 % \usepackage[booklet]{pfarrei}
417 % \end{verbatim}\unskip
418 % direkt in seinem Dokument laden. Dann stellt es Umgebungen und Befehle für
419 % die Erstellung von Textblättern oder Textheften für Pfarrer, Lektoren und
420 % andere Mitwirkende an einem Gottesdienst oder auch für die Gemeinde
421 % bereit.
422 %
423 % \StartBlock%^^A
424 % \DescribeMacro{\ifbooklet}
425 % \hspace*{-\marginparsep}\marg{Dann-Code}\marg{Sonst-Code}\\*
426 % Es kann Code davon abhängig ausgeführt werden, ob ein Booklet erzeugt wird
427 % oder nicht. Im Falle eines Booklets wird der \meta{Dann-Code} ausgeführt,
428 % anderenfalls der \meta{Sonst-Code}. Dies wird auch intern, beispielsweise
429 % innerhalb von \cs{AvToAiv} oder innerhalb der
430 % \texttt{booklet}\dots\texttt{page}-Umgebungen verwendet, um die
431 % entsprechende Entscheidung durchzuführen.
432 %
433 % \StartBlock%^^A
434 % \DescribeEnv{bookletfrontpage}%^^A
435 % \DescribeMacro{\bookletfrontpagestyle}%^^A
436 % Mit der Umgebung \texttt{bookletfontpage} kann eine Titelseite erstellt
437 % werden, die nur bei der Erzeugung eines Booklets ausgegeben wird. Die
438 % Umgebung sollte immer am Anfang des Dokuments stehen, anderenfalls
439 % produziert sie eine Fehlermeldung. Dies geschieht, weil die Titelseite nun
440 % einmal die erste Seite sein sollte. Sollte der Seitenstil \texttt{empty}
441 % einmal nicht für die Titelseite gewünscht werden, kann man
442 % \cs{bookletfrontpagestyle} auf den Namen des gewünschten Stils umdefinieren.
443 %
444 % \StartBlock[6]%^^A
445 % \DescribeMacro{\motto}\hspace*{-\marginparsep}\marg{Motto}\\*%^^A
446 % \DescribeMacro{\titlepicture}\hspace*{-\marginparsep}\marg{Bild}\\*%^^A
447 % \DescribeMacro{\title}\hspace*{-\marginparsep}\marg{Titel}\\*%^^A
448 % \DescribeMacro{\parish}\hspace*{-\marginparsep}\marg{Gemeinde}\\*%^^A
449 % \DescribeMacro{\date}\hspace*{-\marginparsep}\marg{Datum}\\*%^^A
450 % \DescribeMacro{\makebooklettitlepage}%^^A
451 % Ähnlich zu \cs{maketitle} bei den Standard-Klassen kann man für Booklets
452 % (aufbauend auf der oben erklärten Umgebung \texttt{bookletfrontpage} statt
453 % auf \texttt{titlepage}) mit Hilfe von \cs{makebooklettitlepage} eine
454 % Titelseite für ein Booklet erzeugen. Der Titel besteht aus einem Motto (oben
455 % auf der Seite), gefolgt von einem Titelbild, gefolgt von dem Titel, Angaben
456 % zur Gemeinde und zum Schluss das Datum. Es ist zu beachten, dass man
457 % \cs{makebooklettitlepage} \emph{nicht} selbst in eine Umgebung packen
458 % sollte, da diese Anweisung intern die Umgebung \texttt{bookletfrontpage}
459 % verwendet. Darüber hinaus ist zu beachten, dass als Titelbild nicht einfach
460 % ein Dateinamen angegeben wird, sondern die kompletten Anweisungen, um ein
461 % Bild einzuladen oder zu erstellen. Auch muss ggf. ein Grafikpaket selbst
462 % geladen werden.
463 %
464 % \StartBlock%^^A
465 % \DescribeEnv{bookletbackpage}%^^A
466 % \DescribeEnv{bookletemptypage}%^^A
467 % \DescribeMacro{\bookletbackpagestyle}%^^A
468 % \DescribeMacro{\bookletemptypagestyle}%^^A
469 % Für ein Booklet kann mit der Umgebung \texttt{bookletbackpage} außerdem eine
470 % Rückseite definiert werden. Die Definition kann an beliebiger Stelle
471 % erfolgen. Die Ausgabe findet auf einer durch vier teilbaren Seite am Ende
472 % des Dokuments statt. Dazu werden ggf. leere Seiten eingefügt. Den Inhalt der
473 % \emph{leeren Seiten} kann ebenfalls mit einer Umgebung, nämlich
474 % \texttt{bookletemptypage}, definiert werden. Wie bereits beim Seitenstil für
475 % die Vorderseite, kann auch der Seitenstil für die \emph{leeren Seiten} und
476 % die Rückseite umdefiniert werden.
477 %
478 % \StartBlock%^^A
479 % \DescribeEnv{samedoublepage}%^^A
480 % Wenn der Inhalt dieser Umgebung auf die aktuelle Seite passt, wird er
481 % ausgegeben. Passt er nicht auf die aktuelle Seite und die aktuelle Seite ist
482 % eine Seite mit einer ungeraden Seitenzahl, dann wird zunächst ein
483 % Seitenumbruch durchgeführt. Anschließend wird der Inhalt ausgegeben. Dadurch
484 % wird vermieden, dass beispielsweise ein Lektor oder Pfarrer unnötig
485 % innerhalb eines Textes umblättern muss. Es ist zu beachten, dass innerhalb
486 % dieser Umgebung Fußnoten, Marginalien und Gleitumgebungen nicht korrekt
487 % funktionieren.
488 %
489 % \StartBlock%^^A
490 % \DescribeMacro{\setupprayer}\hspace*{-\marginparsep}\marg{Optionen}\\*%^^A
491 % \DescribeEnv{prayer}%^^A
492 % \DescribeMacro{\noresponder}%^^A
493 % Die Umgebung \texttt{prayer} ist für Gebete gedacht. Die Umgebung hat ein
494 % optionales Argument. Dieses ist identisch mit \meta{Optionen} gilt dann aber
495 % nur lokal für diese Gebetsumgebung. Als \meta{Optionen} kann eine
496 % Komma-separierte Liste von \meta{Schlüssel}\texttt{=}\meta{Wert}-Optionen
497 % angegeben werden. Folgende Schlüssel werden verstanden:
498 % \begin{description}
499 % \item[\texttt{leader=}\meta{Vorbeter}:] Setzt die Voreinstellung für das
500 % optionale Argument von \cs{item} auf \meta{Vorbeter}.
501 % \item[\texttt{responder=}\meta{Antwortende(r)}:] Setzt die Voreinstellung
502 % für das optionale Argument des automatisch als Antwort eingefügten
503 % \cs{item} auf \meta{Antwortende(r)}.
504 % \item[\texttt{response=}\meta{Antwort}:] Setzt die automatisch eingefügte
505 % Antwort auf \meta{Antwort}.
506 % \end{description}
507 % Eine automatische Antwort wird nur eingefügt, wenn sowohl \texttt{responder}
508 % als auch \texttt{response} angegeben sind. Soll nur für einzelne \cs{item}
509 % keine automatische Antwort erstellt werden, so ist irgendwo innerhalb des
510 % entsprechenden \cs{item} (\emph{nicht} jedoch innerhalb des optionalen
511 % Arguments von \cs{item}) oder danach ein \cs{noresponder} einzufügen.
512 %
513 % \StopEventually{}
514 %
515 % \iffalse^^A meta-comment
516 %</dtx|doc>
517 % \fi^^A meta-comment
518 %
519 % \section{Implementierung der \LaTeX-Seite}
520 %
521 % \iffalse^^A meta-comment
522 %<*tex>
523 % \fi^^A meta-comment
524 %
525 % \subsection{Das \LaTeX-Dokument "`\texttt{a5toa4.tex}"'}
526 %
527 % \iffalse^^A meta-comment
528 %<*a5toa4>
529 % \fi^^A meta-comment
530 %
531 % Das ist wirklich geradezu trivial:
532 % \begin{macrocode}
533 \documentclass[a4paper,landscape]{article}
534 \usepackage{pfarrei}
535 \begin{document}
536 \AvToAiv
537 \end{document}
538 % \end{macrocode}
539 % Das war es schon. Trotzdem hat die Verwendung einer solchen zusätzlichen
540 % Datei den Vorteil, dass man bei Bedarf lokal auch ein ganz anderes
541 % "`\texttt{a5toa4.tex}"' speichern kann.
542 %
543 % \iffalse^^A meta-comment
544 %</a5toa4>
545 % \fi^^A meta-comment
546 %
547 % \subsection{Das \LaTeX-Paket "`\texttt{pfarrei}"'}
548 %
549 % \iffalse^^A meta-comment
550 %<*package>
551 % \fi^^A meta-comment
552 %
553 % \begin{macro}{\ifbooklet}
554 % \changes{r28}{2013/04/01}{neue Anweisung}
555 % Wir haben eine Option, die bestimmt, ob wir ein Booklet erzeugen oder
556 % nicht. Später wird das schlicht über das Makro \cs{ifbooklet}
557 % festgestellt. Falls ein Booklet erzeugt werden soll wird das erste, sonst
558 % das zweite Argument ausgeführt.
559 % \begin{macrocode}
560 \newcommand*{\ifbooklet}{}
561 \let\ifbooklet\@secondoftwo
562 \DeclareOption{booklet}{\let\ifbooklet\@firstoftwo}
563 \DeclareOption{nobooklet}{\let\ifbooklet\@secondoftwo}
564 % \end{macrocode}
565 % \end{macro}
566 %
567 % Dann werden die Optionen ausgeführt:
568 % \begin{macrocode}
569 \ProcessOptions*
570 % \end{macrocode}
571 % Dann benötigen wir ein paar Pakete:
572 % \begin{macrocode}
573 \RequirePackage{ifpdf}
574 \RequirePackage{pdfpages}
575 % \end{macrocode}
576 %
577 %
578 % \begin{macro}{\AvToAiv}
579 % Der Name des Makros kommt von \texttt{a5toa4}. Es muss sichergestellt sein,
580 % dass dies im PDF-Modus verwendet wird.
581 % \begin{macrocode}
582 \newcommand*{\AvToAiv}[1][\OriginalFile]{%
583 \ifpdf\else
584 \PackageError{pfarrei}{PDF mode needed}{%
585 a5toa4 needs the direct PDF mode.\MessageBreak
586 Usually this may be activated using either pdflatex, lualatex or
587 xelatex.%
588 }%
589 \input{x.tex}
590 \fi
591 \ifbooklet{%
592 \includepdf[pages=-,booklet]{#1}%
593 }{%
594 \includepdf[pages=-,nup=2x1]{#1}%
595 }%
596 }
597 % \end{macrocode}
598 % \end{macro}^^A \AvToAiv
599 %
600 % \begin{environment}{bookletpage}
601 % \changes{r28}{2013/04/01}{neue virtuelle Umgebung}
602 % Da mehrfach eine Umgebung für einzelne Seiten benötigt wird, definieren wir
603 % dafür eine eigene Umgebung, die dann entsprechend individualisiert wird. Es
604 % ist zu beachten, dass diese Umgebung nicht als Umgebung aufgerufen werden
605 % sollte, sondern direkt \cs{bookletpage} und \cs{endbookletpage}.
606 % \begin{macrocode}
607 \newenvironment*{bookletpage}{%
608 \edef\reserved@a{bookletpage}%
609 \ifx\@currenvir\reserved@a
610 \PackageError{pfarrei}{`bookletpage' used as ordinary environment}{%
611 Please note, that `bookletpage' is a virtual environment
612 only.\MessageBreak
613 You should not use it directly as an environment, but use
614 `\string\bookletpage' at the\MessageBreak
615 begin code and `\string\endbookletpage' at the end code of a wrapper
616 environment.\MessageBreak
617 If you'll continue, expect several additional errors%
618 }%
619 \let\bookletpagebox\@tempboxa
620 \let\bookletpagestyle\@empty
621 \else
622 \expandafter\let\expandafter\bookletpagebox
623 \csname \@currenvir box\endcsname
624 \expandafter\let\expandafter\bookletpagestyle
625 \csname \@currenvir style\endcsname
626 \fi
627 \edef\reserved@a{%
628 \noexpand\begin{lrbox}{\bookletpagebox}
629 \noexpand\begin{minipage}[t][\textheight][t]{\textwidth}%
630 \begingroup
631 \def\noexpand\@currenvir{\@currenvir}%
632 \def\noexpand\@currenvline{\@currenvline}%
633 \noexpand\parskip=\the\parskip
634 \noexpand\parindent=\the\parindent
635 \noexpand\parfillskip=\the\parfillskip
636 }\reserved@a
637 }{%
638 % \end{macrocode}
639 % Das Ende wird in zwei Portionen aufgeteilt:
640 % \begin{macrocode}
641 \endbookletpagebox
642 \printbookletpagebox
643 }
644 % \end{macrocode}
645 % \begin{macro}{\endbookletpagebox}
646 % \changes{r28}{2013/04/01}{neue (eigentlich interne) Anweisung}
647 % das Beenden der Erzeugung der Box für die Seite
648 % \begin{macrocode}
649 \def\endbookletpagebox{%
650 \par
651 \endgroup
652 \end{minipage}%
653 \end{lrbox}%
654 \global\setbox\bookletpagebox\box\bookletpagebox
655 }
656 % \end{macrocode}
657 % \end{macro}
658 % \begin{macro}{\printbookletpagebox}
659 % \changes{r28}{2013/04/01}{neue (eigentlich interne) Anweisung}
660 % und die Ausgabe der Box, falls ein Booklet erzeugt wird.
661 % \begin{macrocode}
662 \newcommand*\printbookletpagebox[1][\@currenvir]{%
663 \ifbooklet{%
664 \@ifundefined{bookletpagestyle}{}{%
665 \ifx\bookletpagestyle\@empty\else\thispagestyle{\bookletpagestyle}\fi%
666 }%
667 \clearpage\noindent\usebox\bookletpagebox\clearpage
668 }{%
669 \PackageInfo{pfarrei}{`#1' not printed}%
670 }%
671 }
672 % \end{macrocode}
673 % \end{macro}
674 % \end{environment}
675 %
676 %
677 % \begin{environment}{bookletfrontpage}
678 % \changes{r26}{2013/03/31}{neue Umgebung}
679 % Umgebung, um eine Booklet-Titelseite zu erzeugen.
680 % \begin{macro}{\bookletfrontpagebox}
681 % \changes{r26}{2013/03/31}{neue Box}
682 % \begin{macro}{\bookletfrontpagestyle}
683 % \changes{r26}{2013/03/31}{neues Makro}
684 % Es ist nur eine Seite erlaubt. Also packen wir das ganze in eine Box. Dafür
685 % brauchen wir eine solche:
686 % \begin{macrocode}
687 \newsavebox\bookletfrontpagebox
688 \newcommand*{\bookletfrontpagestyle}{empty}
689 \newenvironment*{bookletfrontpage}{%
690 \bookletpage
691 }{%
692 \endbookletpagebox
693 \clearpage
694 \ifbooklet{%
695 \ifnum\c@page>\@ne
696 \PackageError{pfarrei}{Booklet front page not first page}{%
697 The booklet font page should be the first page, but it seems, that it
698 is\MessageBreak
699 page no. \the\c@page. \space Maybe you should put it immediately after
700 `\string\begin{document}.%
701 Nevertheless, if you'll continue it will be printed here%
702 }%
703 \fi
704 \printbookletpagebox
705 }{%
706 \PackageInfo{pfarrei}{Booklet front page ignored}%
707 }%
708 }
709 % \end{macrocode}
710 % \end{macro}
711 % \end{macro}
712 % \end{environment}
713 %
714 % \begin{environment}{bookletbackpage}
715 % \changes{r26}{2013/03/31}{neue Umgebung}%^^A
716 % \begin{macro}{\bookletbackpagebox}
717 % \changes{r26}{2013/03/31}{neue Box}%^^A
718 % \begin{macro}{\bookletbackpagestyle}
719 % \changes{r26}{2013/03/31}{neues Makro}
720 % Im Prinzip ist die Booklet-Rückseite fast wie bei der Titelseite,
721 % allerdings fügen wir hier so viele Leerseiten ein, dass wir wirklich auf
722 % einer durch 4 teilbaren Seite landen.
723 % \begin{environment}{bookletemptypage}
724 % \changes{r26}{2013/03/31}{neue Box}%^^A
725 % \begin{macro}{\bookletemptypagebox}
726 % \changes{r26}{2013/03/31}{neue Umgebung}%^^A
727 % \begin{macro}{\bookletemptypagestyle}
728 % \changes{r26}{2013/03/31}{neues Makro}%^^A
729 % Die Umgebung für die konfigurierbare \emph{Leerseite}, besitzt keine eigene
730 % Ausgabe, sondern sammelt tatsächlich nur den Inhalt. Die Ausgabe erfolgt
731 % dann bei der Ausgabe der Booklet-Rückseite.
732 % \begin{macrocode}
733 \newsavebox\bookletemptypagebox
734 \newcommand*{\bookletemptypagestyle}{empty}
735 \newenvironment*{bookletemptypage}{%
736 \bookletpage
737 }{%
738 \endbookletpagebox
739 }
740 \newsavebox\bookletbackpagebox
741 \newcommand*{\bookletbackpagestyle}{empty}
742 \newenvironment*{bookletbackpage}{%
743 \bookletpage
744 }{%
745 \endbookletpagebox
746 \if@filesw\immediate\write\@mainaux{\string\printbookletbackpage}\fi
747 }%
748 % \end{macrocode}
749 % \end{macro}
750 % \end{macro}
751 % \end{environment}
752 % \begin{macro}{\printbookletbackpage}
753 % \changes{r26}{2013/03/31}{neue Anweisung}%^^A
754 % \begin{macro}{\@printbookletbackpage}
755 % \changes{r26}{2013/03/31}{neue interne Anweisung}%^^A
756 % Die eigentliche Ausgabe der letzten Seite geschieht über einen Eintrag in
757 % der \texttt{aux}-Datei. Das ist zwar nicht ganz sauber (und
758 % \textsf{scrlfile} meckert deshalb ggf.), aber die Standard-Klasse
759 % \textsf{letter} macht das ähnlich für die Etiketten. Also hoffen wir
760 % einfach, dass es gut geht.
761 % \begin{macrocode}
762 \newcommand*{\printbookletbackpage}{}
763 \newcommand*{\@printbookletbackpage}{%
764 \ifbooklet{%
765 \clearpage
766 \let\bookletpagestyle\bookletemptypagestyle
767 \ifvoid\bookletemptypagebox
768 \let\bookletpagebox\strutbox
769 \else
770 \let\bookletpagebox\bookletemptypagebox
771 \fi
772 \@tempcnta=\c@page
773 \divide\@tempcnta by 4
774 \multiply\@tempcnta by 4
775 \ifnum \@tempcnta=\c@page\else
776 \advance\@tempcnta by 4
777 \@whilenum \c@page<\@tempcnta\do{%
778 \printbookletpagebox
779 }%
780 \fi
781 \let\bookletpagestyle\bookletbackpagestyle
782 \let\bookletpagebox\bookletbackpagebox
783 \printbookletpagebox
784 }{%
785 \PackageInfo{pfarrei}{Booklet back page ignored}%
786 }%
787 }
788 % \end{macrocode}
789 % Das Drucken darf während des Lesens der \texttt{aux}-Datei in
790 % \cs{begin{document}} nicht erfolgen. Daher definieren wir es erst danach
791 % entsprechend um. Dadurch ist es während des Lesens der \texttt{aux}-Datei in
792 % \cs{end{document}} funktionsfähig.
793 % \begin{macrocode}
794 \AtBeginDocument{\let\printbookletbackpage\@printbookletbackpage}
795 % \end{macrocode}
796 % \end{macro}
797 % \end{macro}
798 % \end{macro}
799 % \end{macro}
800 % \end{environment}
801 %
802 %
803 % \begin{macro}{\makebooklettitlepage}
804 % \changes{r26}{2013/03/31}{neue Anweisung}%^^A
805 % \begin{macro}{\motto}
806 % \changes{r26}{2013/03/31}{neue Anweisung}%^^A
807 % \begin{macro}{\@motto}
808 % \changes{r26}{2013/03/31}{neues internes Makro}%^^A
809 % \begin{macro}{\titlepicture}
810 % \changes{r26}{2013/03/31}{neue Anweisung}%^^A
811 % \begin{macro}{\@titlepicture}
812 % \changes{r26}{2013/03/31}{neues internes Makro}%^^A
813 % \begin{macro}{\title}
814 % \changes{r26}{2013/03/31}{neue Anweisung}%^^A
815 % \begin{macro}{\@title}
816 % \changes{r26}{2013/03/31}{neues internes Makro}%^^A
817 % \begin{macro}{\parish}
818 % \changes{r26}{2013/03/31}{neue Anweisung}%^^A
819 % \begin{macro}{\@parish}
820 % \changes{r26}{2013/03/31}{neues internes Makro}%^^A
821 % \begin{macro}{\date}
822 % \changes{r26}{2013/03/31}{neue Anweisung}%^^A
823 % \begin{macro}{\@date}
824 % \changes{r26}{2013/03/31}{neues internes Makro}%^^A
825 % Der Standard-Titel für Booklets besteht aus einem Motto, einem Bild, einem
826 % Titel, der Gemeinde und dem Datum. Wir gehen davon aus, dass die
827 % Klasse bereits \cs{date}, \cs{@date}, \cs{title} und \cs{@title} zur
828 % Verfügung stellt. Allerdings ergibt die Voreinstellung \cs{today} für das
829 % Datum hier wenig Sinn, weshalb die Voreinstellung in einen leeren Wert
830 % geändert wird. Den Rest machen wir komplett selbst:
831 % \begin{macrocode}
832 \newcommand*{\motto}[1]{\gdef\@motto{#1}}
833 \newcommand*{\@motto}{}
834 \newcommand*{\titlepicture}[1]{\gdef\@titlepicture{#1}}
835 \newcommand*{\@titlepicture}{}
836 \providecommand*{\title}[1]{\gdef\@title{#1}}
837 \providecommand*{\@title}{}
838 \newcommand*{\parish}[1]{\gdef\@parish{#1}}
839 \newcommand*{\@parish}{}
840 \providecommand*{\date}[1]{\gdef\@date{#1}}
841 \def\@date{}
842 \newcommand*{\makebooklettitlepage}{%
843 \begin{bookletfrontpage}
844 \parskip.5\baselineskip
845 \parindent\z@
846 \parfillskip \z@ \@plus 1fil
847 \centering
848 \ifx\@motto\@empty\else{\Huge\@motto\par}\fi
849 \vfill
850 \ifx\@titlepicture\@empty\else\@titlepicture\par\fi
851 \vfill
852 \parskip\z@
853 \Huge
854 \@title\par
855 \@parish\par
856 \@date\par
857 \ifx\@title\@empty\ifx\@parish\@empty\ifx\@date\@empty\null\fi\fi\fi
858 \end{bookletfrontpage}
859 }
860 % \end{macrocode}
861 % \end{macro}
862 % \end{macro}
863 % \end{macro}
864 % \end{macro}
865 % \end{macro}
866 % \end{macro}
867 % \end{macro}
868 % \end{macro}
869 % \end{macro}
870 % \end{macro}
871 % \end{macro}
872 %
873 %
874 % \begin{environment}{samedoublepage}
875 % \changes{r28}{2013/03/31}{neue Umgebung}%^^A
876 % \begin{macro}{\samedoublepage@save@hbox}
877 % \changes{r28}{2013/03/31}{neues internes Makro}%^^A
878 % Es wird etwas umständlich eine vertikale Box gespeichert,
879 % \begin{macrocode}
880 \let\samedoublepage@save@hbox\hbox
881 \newenvironment*{samedoublepage}{%
882 \par
883 \let\hbox\vbox
884 \begin{lrbox}{\@tempboxa}%
885 \let\hbox\samedoublepage@save@hbox
886 }{%
887 \end{lrbox}%
888 \let\hbox\samedoublepage@save@hbox
889 % \end{macrocode}
890 % um diese dann in Stücke zu zerschneiden, die auf eine Seite passen,
891 % \begin{macrocode}
892 \@tempdima\ifdim\pagegoal=\maxdimen\textheight
893 \else\dimexpr\pagegoal-\pagetotal\fi
894 \ifdim \@tempdima
895 <\dimexpr\ht\@tempboxa+\dp\@tempboxa\relax
896 \ifodd\c@page
897 % \end{macrocode}
898 % Wobei aber nicht auf ungeraden Seiten mit nur einem Stück des Kuchens
899 % begonnen wird.
900 % \begin{macrocode}
901 \newpage
902 \@tempdima\textheight
903 \else \typeout{even page}%
904 \fi
905 \@whiledim \@tempdima
906 <\dimexpr\ht\@tempboxa+\dp\@tempboxa\relax\do{%
907 \splitmaxdepth\dp\strutbox
908 \splittopskip\topskip
909 \setbox\z@\vsplit\@tempboxa to \@tempdima
910 \usebox\z@
911 \newpage
912 \@tempdima\textheight
913 }%
914 \fi
915 % \end{macrocode}
916 % Und am Ende nicht vergessen, den Rest der Box auch noch auszugeben.
917 % \begin{macrocode}
918 \ifvoid\@tempboxa\else\usebox\@tempboxa\fi
919 }
920 % \end{macrocode}
921 % \end{macro}
922 % \end{environment}
923 %
924 % \begin{environment}{prayer}
925 % \changes{r28}{2013/04/01}{neue Umgebung}
926 % \begin{macro}{\setupprayer}
927 % \changes{r28}{2013/04/01}{neue Anweisung}
928 % Die Gebetsumgebung wird mit Hilfe von \textsf{keyval} definiert. Sie kann
929 % außer mit dem optionalen Argument auch jederzeit mit \cs{setupprayer}
930 % konfiguriert werden.
931 % \begin{macro}{\prayer@responder}
932 % \changes{r28}{2013/04/01}{neues internes Makro}
933 % \begin{macro}{\prayer@response}
934 % \changes{r28}{2013/04/01}{neues internes Makro}
935 % \begin{macro}{\prayer@leader}
936 % \changes{r28}{2013/04/01}{neues internes Makro}
937 % Dafür werden mehrere interne Makros benötigt, um die gewünschten Werte
938 % aufzunehmen.
939 % \begin{macrocode}
940 \RequirePackage{keyval}
941 \define@key{pfarrei.prayer}{response}{\def\prayer@response{#1}}
942 \define@key{pfarrei.prayer}{responder}{\def\prayer@responder{#1:}}
943 \define@key{pfarrei.prayer}{leader}{\def\prayer@leader{#1:}}
944 \newcommand*{\prayer@responder}{}
945 \newcommand*{\prayer@response}{}
946 \newcommand*{\prayer@leader}{}
947 \newcommand*{\setupprayer}{%
948 \setkeys{pfarrei.prayer}%
949 }
950 % \end{macrocode}
951 % \end{macro}
952 % \end{macro}
953 % \end{macro}
954 % \end{macro}
955 % \begin{macro}{\ifprayer@firstitem}
956 % \changes{r28}{2013/04/01}{neuer interner Schalter}
957 % \begin{macro}{prayer@response@item}
958 % \changes{r28}{2013/04/01}{neue interne Anweisung}
959 % Da die Antwort beim ersten \cs{item} noch nicht ausgegeben werden darf,
960 % sondern nur nach den nachfolgenden, muss die Information, ob es das erste
961 % \cs{item} ist, über einen Schalter gespeichert werden.
962 % \begin{macrocode}
963 \newif\ifprayer@firstitem
964 \newcommand*{\prayer@response@item}{%
965 \ifprayer@firstitem\else
966 \ifx\prayer@responder\@empty\else
967 \ifx\prayer@response\@empty\else
968 \prayer@save@item[\prayer@responder] \prayer@response
969 \fi
970 \fi
971 \fi
972 }
973 % \end{macrocode}
974 % \end{macro}
975 % \end{macro}
976 % \begin{macro}{\prayer@item}
977 % \changes{r28}{2013/04/01}{neue interne Anweisung}
978 % \begin{macro}{\prayer@save@item}
979 % \changes{r28}{2013/04/01}{neue interne Anweisung}
980 % Die \cs{item}-Anweisung von \texttt{prayer} ist etwas anders als von anderen
981 % Listen-Umgebungen. Sie baut jedoch auf der Originaldefinition auf. Daher
982 % muss die Originaldefinition gespeichert und entsprechend erweitert verwendet
983 % werden.
984 % \begin{macrocode}
985 \newcommand*{\prayer@item}[1][\prayer@leader]{%
986 \prayer@response@item
987 \prayer@firstitemfalse
988 \prayer@save@item[{#1}]%
989 }
990 % \end{macrocode}
991 % \begin{macro}{\noresponder}
992 % \changes{r28}{2013/04/01}{neue Anweisung}
993 % Das Abschalten der nächsten automatischen Antwort geschieht einfach, indem
994 % so getan wird, als wäre das nächste \cs{item} wieder das erste.
995 % \begin{macrocode}
996 \newenvironment*{prayer}[1][]{%
997 \begin{description}
998 \begingroup
999 \def\@currenvir{prayer}%
1000 \setupprayer{#1}%
1001 \let\prayer@save@item\item
1002 \let\item\prayer@item
1003 \prayer@firstitemtrue
1004 \let\noresponder\prayer@firstitemtrue
1005 }{%
1006 \prayer@response@item
1007 \endgroup
1008 \end{description}
1009 }
1010 % \end{macrocode}
1011 % \end{macro}
1012 % \end{macro}
1013 % \end{macro}
1014 % \end{environment}
1015 %
1016 %
1017 % \iffalse^^A meta-comment
1018 %</package>
1019 % \fi^^A meta-comment
1020 %
1021 %
1022 % \iffalse^^A meta-comment
1023 %</tex>
1024 % \fi^^A meta-comment
1025 %
1026 % \section{Implementierung der Skripten}
1027 %
1028 % \iffalse^^A meta-comment
1029 %<*lua>
1030 % \fi^^A meta-comment
1031 %
1032 % \subsection{Der kleine Wrapper "`\texttt{a5toa4.tlu}"'}
1033 %
1034 % \iffalse^^A meta-comment
1035 %<*a5toa4>
1036 % \fi^^A meta-comment
1037 % \begin{macrocode}
1038 -- $Id: pfarrei.dtx 37 2023-11-22 18:54:26Z ps $
1039
1040 kpse.set_program_name(arg[-1], 'a5toa4')
1041 require('pfarrei.pfarrei')
1042 % \end{macrocode}
1043 % \iffalse^^A meta-comment
1044 %</a5toa4>
1045 % \fi^^A meta-comment
1046 %
1047 % \subsection{Das Haupt-Skript "`\texttt{pfarrei.tlu}"'}
1048 %
1049 % \iffalse^^A meta-comment
1050 %<*pfarrei>
1051 % \fi^^A meta-comment
1052 % \begin{macrocode}
1053 local version_number = string.sub( '$Revision: 37 $', 12, -2 )
1054 local action_version = ' r' .. version_number .. '\n' .. [[
1055
1056 Copyright (c) 2013 Markus Kohm.
1057 License: lppl 1.3c or later. See <http://www.latex-project.org/lppl.txt>.
1058 ]]
1059 local action_help = [[
1060 action options:
1061
1062 -h, --help Print this help message.
1063 -V, --version Print the version information.
1064
1065 processing options:
1066 -b, --booklet Generate a booklet instead of only two pages side by
1067 side onto one page. The whole booklet will be one
1068 signature.
1069 -s, --sidebyside Generate only two pages side by side onto one page
1070 instead of a booklet.
1071 -o, --overwrite Write the output to the <PDF file> instead of appending
1072 "-sidebyside.pdf" or "--booklet.pdf" to the basename
1073 of <PDF file>
1074 ]]
1075 local action_opts = {
1076 ['-h'] = 'help',
1077 ['--help'] = 'help',
1078 ['-V'] = 'version',
1079 ['--version'] = 'version',
1080 }
1081 local processing_opts = {
1082 ['-b'] = 'booklet',
1083 ['--booklet'] = 'booklet',
1084 ['-s'] = 'sidebyside',
1085 ['--sidebyside'] = 'sidebyside',
1086 ['-o'] = 'overwrite',
1087 ['--overwrite'] = 'overwrite',
1088 ['-d'] = 'debug',
1089 ['--debug'] = 'debug',
1090 }
1091
1092 -- detect action options and do action
1093 local i = 1
1094 local action
1095 while arg[i] do
1096 action = action_opts[arg[i]]
1097 i = i+1
1098 if action == 'help' then
1099 print( arg[0]..action_version );
1100 print( 'Usage: ' .. arg[0] .. ' <action option>' )
1101 print( ' ' .. arg[0] .. ' [<processing options>] <PDF file> ...\n' )
1102 print( action_help );
1103 os.exit( 0 );
1104 elseif action == 'version' then
1105 print( arg[0] .. action_version );
1106 os.exit( 0 );
1107 end
1108 end
1109
1110 -- process options and parameters
1111 local booklet = false
1112 local overwrite = false
1113 local debug = false
1114 i = 1
1115 while arg[i] do
1116 action = processing_opts[arg[i]]
1117 if action == 'booklet' then booklet = true
1118 elseif action == 'sidebyside' then booklet = false
1119 elseif action == 'overwrite' then overwrite = true
1120 elseif action == 'debug' then debug = true
1121 elseif action == nil then
1122 -- build the temporary tex file
1123 local tmpdir = os.tmpdir("pfarrei.XXXXXX" )
1124 local tmpfile = string.match( arg[i], '.*/(.*)$') or arg[i]
1125 -- pdflatex's -output-directory search for source pdf works with path specification but fails
1126 -- when simple file name in the current working directory is provided, we need to provide '../' then
1127 local local_source=''
1128 if tmpfile == arg[i] then local_source = '../' end
1129 local basename = string.match( tmpfile,'(.*)%.[^.]*$') or tmpfile
1130 tmpfile = tmpdir..'/'..basename..'.tex'
1131 local file = assert( io.open( tmpfile, 'w' ) )
1132 if booklet then assert( file:write("\\PassOptionsToPackage{booklet}{pfarrei}\n") ) end
1133 assert( file:write("\\def\\OriginalFile{"..local_source,arg[i],"}\n") )
1134 assert( file:write("\\input{a5toa4.tex}\n") )
1135 assert( file:flush() )
1136 file:close()
1137 -- call pdflatex
1138 assert( os.execute( 'pdflatex -interaction=batchmode -output-directory='..tmpdir..' '..tmpfile ) )
1139 -- copy the resulting pdf file
1140 local srcfile = assert( io.open( tmpdir..'/'..basename..'.pdf', 'rb' ) )
1141 if overwrite
1142 then
1143 tmpfile = arg[i]
1144 else
1145 tmpfile = string.match( arg[i], '(.*)%.[^.]*$' ) or arg[i]
1146 if booklet
1147 then
1148 tmpfile = tmpfile..'-booklet.pdf'
1149 else
1150 tmpfile = tmpfile..'-sidebyside.pdf'
1151 end
1152 end
1153 local destfile = assert( io.open( tmpfile, 'wb' ) )
1154 local buffer
1155 while true do
1156 buffer = srcfile:read(8388608)
1157 if buffer==nil then break end
1158 assert( destfile:write(buffer) )
1159 end
1160 assert( destfile:close() )
1161 srcfile:close()
1162 if debug
1163 then
1164 print('DEBUG: Temporary files in: '..tmpdir);
1165 else
1166 tmpfile=tmpdir..'/'..basename
1167 os.remove( tmpfile..'.aux' )
1168 os.remove( tmpfile..'.tex' )
1169 os.remove( tmpfile..'.log' )
1170 os.remove( tmpfile..'.pdf' )
1171 os.remove( tmpdir )
1172 end
1173 overwrite = false
1174 end
1175 i=i+1
1176 end
1177 % \end{macrocode}
1178 % \iffalse^^A meta-comment
1179 %</pfarrei>
1180 % \fi^^A meta-comment
1181 %
1182 % \iffalse^^A meta-comment
1183 %</lua>
1184 % \fi^^A meta-comment
1185 %
1186 % \Finale
1187 %
1188 \endinput
1189 %
1190 % end of file `pfarrei.dtx'
1191 %
1192 %%% Local Variables:
1193 %%% mode: doctex
1194 %%% TeX-PDF-mode: t
1195 %%% mode: flyspell
1196 %%% ispell-local-dictionary: "de_DE"
1197 %%% TeX-master: t
1198 %%% End:
1199