summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-09-18 20:06:44 +0000
committerKarl Berry <karl@freefriends.org>2023-09-18 20:06:44 +0000
commitab418e2b9511d7b27d67420ea672aa93726b9bdd (patch)
treee0cdd93a590d48fe88c54b63f21ab92beaa7ff13
parent232fce76fb4354d53125f15fb60e6cb267519538 (diff)
photobook (18sep23)
git-svn-id: svn://tug.org/texlive/trunk@68313 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/photobook/README.md15
-rw-r--r--Master/texmf-dist/doc/latex/photobook/photobook.pdfbin144969 -> 145475 bytes
-rw-r--r--Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh2
-rw-r--r--Master/texmf-dist/tex/latex/photobook/photobook.cls43
4 files changed, 35 insertions, 25 deletions
diff --git a/Master/texmf-dist/doc/latex/photobook/README.md b/Master/texmf-dist/doc/latex/photobook/README.md
index 54e29d5eba4..13daa3c373a 100644
--- a/Master/texmf-dist/doc/latex/photobook/README.md
+++ b/Master/texmf-dist/doc/latex/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/Master/texmf-dist/doc/latex/photobook/photobook.pdf b/Master/texmf-dist/doc/latex/photobook/photobook.pdf
index dc2338a1411..5e785e73cf6 100644
--- a/Master/texmf-dist/doc/latex/photobook/photobook.pdf
+++ b/Master/texmf-dist/doc/latex/photobook/photobook.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh b/Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh
index 4f8b30db2a5..eed90d5f1a8 100644
--- a/Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh
+++ b/Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh
@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
shopt -s nullglob extglob
#----------------------------------------------------------------------
diff --git a/Master/texmf-dist/tex/latex/photobook/photobook.cls b/Master/texmf-dist/tex/latex/photobook/photobook.cls
index 7ecc155de86..a2a84809e8b 100644
--- a/Master/texmf-dist/tex/latex/photobook/photobook.cls
+++ b/Master/texmf-dist/tex/latex/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*}}