From 04fec36be1d386c1f8d5a57c3cd613d494a5c323 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 18 Sep 2023 03:04:07 +0000 Subject: CTAN sync 202309180304 --- macros/latex/contrib/photobook/README.md | 15 +++++-- macros/latex/contrib/photobook/photobook.cls | 43 +++++++++++---------- macros/latex/contrib/photobook/photobook.pdf | Bin 144969 -> 145475 bytes .../contrib/photobook/scripts/make-spreads.sh | 2 +- 4 files changed, 35 insertions(+), 25 deletions(-) mode change 100644 => 100755 macros/latex/contrib/photobook/scripts/make-spreads.sh (limited to 'macros/latex/contrib') 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\@[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]{}{} +%% >> \imagecell[clearance=]{}{} +%% >> \imagecell[clearance= ]{}{} +%% >> \imagecell[clearance= ]{}{} %% %% \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 Binary files a/macros/latex/contrib/photobook/photobook.pdf and b/macros/latex/contrib/photobook/photobook.pdf differ diff --git a/macros/latex/contrib/photobook/scripts/make-spreads.sh b/macros/latex/contrib/photobook/scripts/make-spreads.sh old mode 100644 new mode 100755 index 4f8b30db2a..eed90d5f1a --- 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 #---------------------------------------------------------------------- -- cgit v1.2.3