summaryrefslogtreecommitdiff
path: root/macros/latex/contrib
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-09-18 03:04:07 +0000
committerNorbert Preining <norbert@preining.info>2023-09-18 03:04:07 +0000
commit04fec36be1d386c1f8d5a57c3cd613d494a5c323 (patch)
treeaf66bedf66747f24eedac74cd1df1b54f38023c4 /macros/latex/contrib
parente30e1de3ed00a127608d88a118c0b3f0b59a9dca (diff)
CTAN sync 202309180304
Diffstat (limited to 'macros/latex/contrib')
-rw-r--r--macros/latex/contrib/photobook/README.md15
-rw-r--r--macros/latex/contrib/photobook/photobook.cls43
-rw-r--r--macros/latex/contrib/photobook/photobook.pdfbin144969 -> 145475 bytes
-rwxr-xr-x[-rw-r--r--]macros/latex/contrib/photobook/scripts/make-spreads.sh2
4 files changed, 35 insertions, 25 deletions
diff --git a/macros/latex/contrib/photobook/README.md b/macros/latex/contrib/photobook/README.md
index 54e29d5eba..13daa3c373 100644
--- a/macros/latex/contrib/photobook/README.md
+++ b/macros/latex/contrib/photobook/README.md
@@ -12,7 +12,7 @@ Available on:
## Install / Build
The simplest way to install is to use either
-[TeX Live](https://www.tug.org/texlive/)'s or [MiLTeX](https://miktex.org/)'s
+[TeX Live](https://www.tug.org/texlive/)'s or [MiKTeX](https://miktex.org/)'s
standard way to install modules.
@@ -40,8 +40,17 @@ For more info on `make` targets see the: [./Makefile](./Makefile)
# Documentation
Pre-built documentation can be found on
-[CTAN](http://mirrors.ctan.org/macros/latex/contrib/photobook/photobook.pdf)
-or it can be built from source by:
+[CTAN](http://mirrors.ctan.org/macros/latex/contrib/photobook/photobook.pdf).
+
+
+A full book (dummy) example is included in [./examples/book/](./examples/book/)
+and can be used as a reference / starting point.
+
+
+
+## Building documentation
+
+Building the reference from source is done by:
```shell
$ make pdf
```
diff --git a/macros/latex/contrib/photobook/photobook.cls b/macros/latex/contrib/photobook/photobook.cls
index 7ecc155de8..a2a84809e8 100644
--- a/macros/latex/contrib/photobook/photobook.cls
+++ b/macros/latex/contrib/photobook/photobook.cls
@@ -38,14 +38,13 @@
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
-% XXX ASAP: imagecell: photobook@imagecell@left and photobook@imagecell@left
+% XXX ASAP: imagecell: photobook@imagecell@left and photobook@imagecell@top
% should explicitly account for clearence@left and clearence@top resp.
% XXX ASAP: imagecell: clearance should have the same semantics as cliptocell
% offsts...
% (CLEARANCE)
% XXX ASAP should cover/jacket/endpaper/spread cells set default cliptocell
% bleeds???
-% ...needs testing and experimenting...
% XXX ASAP: should \blockwidth include \bindingoffset (current) or not???
% ...currently I think that no, as \blockwidth indicates the outer
% width of the block, and this poses the question:
@@ -93,7 +92,7 @@
%%% NOTE: \def\<module-name>@[A-Z]+ macros will be visible to both the
%%% code and the generated docs...
-\edef\photobook@FILEVERSION{v0.1.28}
+\edef\photobook@FILEVERSION{v0.1.29}
\edef\photobook@FILEDATE{2023-08-24}
@@ -2108,7 +2107,6 @@
{-\the\photobook@cliptocell@right} %
{-\the\photobook@cliptocell@top}}}
-% XXX use \cliptocellclearances as default...
\newenvironment{cliptocell}[1][0mm]{%
\begingroup%
\setcliptocellbleeds{#1}
@@ -2220,7 +2218,9 @@
%% Image |clearance|. This sets the amount of clearance around an image
%% (default: |0pt|).
%%
-%% >> \imagecell[clearance=-4mm]{}{<image>}
+%% >> \imagecell[clearance=<size>]{}{<image>}
+%% >> \imagecell[clearance=<horizontal> <vertical>]{}{<image>}
+%% >> \imagecell[clearance=<left> <bottom> <top> <right>]{}{<image>}
%%
%% \begin{minipage}{\textwidth}
%% \begin{verbatim}
@@ -4033,9 +4033,9 @@
%%%%% Endpaper cells
%
%% \DescribeEnv{leftside}
-%%% \DescribeEnv{leftside*}
+%% \DescribeEnv{leftside*}
%% \DescribeEnv{rightside}
-%%% \DescribeEnv{rightside*}
+%% \DescribeEnv{rightside*}
%
%% \begin{minipage}{\textwidth}
%% \begin{verbatim}
@@ -4051,41 +4051,42 @@
%% \end{verbatim}
%% \end{minipage}
%%
-%%% The star versions set the appropriate bleeds for cliptocell.
-%%%
+%% The non-star versions will clip to bleeds except for the gutter side
+%% that has no bleeds.
+%%
+%% The star versions will not clip.
+%%
% XXX for some reason naming these anything starting with endpaper will
% make LaTeX complain that that is already defined...
% ...collision with bools???
-\newenvironment{leftside}{%
+\newenvironment{leftside*}{%
\begin{cell*}%
{\bleed, \bleed}%
{\pageblockwidth}{\pageblockheight}%
}{%
\end{cell*}}
-% XXX EXPERIMENTAL
-\newenvironment{leftside*}{%
- \begin{leftside}%
+\newenvironment{leftside}{%
+ \begin{leftside*}%
\begin{cliptocell}[{\bleed} {\bleed} 0mm {\bleed}]%
- \setcliptocellbleeds{{\bleed} {\bleed} 0mm {\bleed}}%
+ \setcliptocellbleeds{{\bleed} {\bleed} 0mm {\bleed}}%
}{%
\end{cliptocell}
- \end{leftside}}
+ \end{leftside*}}
-\newenvironment{rightside}{%
+\newenvironment{rightside*}{%
\begin{cell*}%
{\bleed + \pageblockwidth, \bleed}%
{\pageblockwidth}{\pageblockheight}%
}{%
\end{cell*}}
-% XXX EXPERIMENTAL
-\newenvironment{rightside*}{%
- \begin{rightside}%
+\newenvironment{rightside}{%
+ \begin{rightside*}%
\begin{cliptocell}[0mm {\bleed} {\bleed} {\bleed}]%
- \setcliptocellbleeds{0mm {\bleed} {\bleed} {\bleed}}%
+ \setcliptocellbleeds{0mm {\bleed} {\bleed} {\bleed}}%
}{%
\end{cliptocell}
- \end{rightside}}
+ \end{rightside*}}
diff --git a/macros/latex/contrib/photobook/photobook.pdf b/macros/latex/contrib/photobook/photobook.pdf
index dc2338a141..5e785e73cf 100644
--- a/macros/latex/contrib/photobook/photobook.pdf
+++ b/macros/latex/contrib/photobook/photobook.pdf
Binary files differ
diff --git a/macros/latex/contrib/photobook/scripts/make-spreads.sh b/macros/latex/contrib/photobook/scripts/make-spreads.sh
index 4f8b30db2a..eed90d5f1a 100644..100755
--- a/macros/latex/contrib/photobook/scripts/make-spreads.sh
+++ b/macros/latex/contrib/photobook/scripts/make-spreads.sh
@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
shopt -s nullglob extglob
#----------------------------------------------------------------------