From 64ad7bef0e32fb9049b0f3797d01ab086e9081d7 Mon Sep 17 00:00:00 2001
From: "Alex A. Naanou" <alex.nanou@gmail.com>
Date: Fri, 10 Sep 2021 15:54:38 +0300
Subject: [PATCH] docs + demo... need more tweaking/fixes...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
---
 photobook.cls     |  31 +++++++++--
 workflow/demo.tex | 133 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 160 insertions(+), 4 deletions(-)
 create mode 100644 workflow/demo.tex

diff --git a/photobook.cls b/photobook.cls
index b9f0cdd..bc9e9ff 100644
--- a/photobook.cls
+++ b/photobook.cls
@@ -2802,6 +2802,23 @@
 %% templates.
 %%
 
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+%%%%% Generic
+
+%% \DescribeMacro{\emptypage\{..\}}
+%
+%% Create an empty page.
+%
+%%	>> \emptypage
+%%	>> \emptypage[<style>]
+%% 
+\newcommand\emptypage[1][empty]{
+	\begin{page}%
+		\ifthenelse{\equal{#1}{}}{}{
+			\thispagestyle{#1}}
+	\end{page}}
+
+
 % - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 %%%%% Tweaking
 %
@@ -3495,7 +3512,7 @@
 % XXX do a better default...
 %		...adaptive???
 \ResettableMacro{ImageSpreadCaption}[1]{%
-	\captioncell[under, align=flushleft]{%
+	\captioncell[under]{%
 		\captionformat{#1}}}
 
 \ImagePageTemplate{ImageSpread}{%
@@ -3550,7 +3567,7 @@
 %% \end{minipage}
 %%
 \ResettableMacro{ImageSpreadTCaption}[1]{%
-	\captionblockcell[under]{%
+	\captioncell[under]{%
 		\captionformat{#1}}}
 \ImagePageTemplate{ImageSpreadT}{%
 	\ImageSpread*[%
@@ -3682,7 +3699,7 @@
 	\ImageSpreadFit*[top, #1]{#2}{#3}}
 
 \ResettableMacro{ImageSpreadFitBCaption}[1]{%
-	\captioncell[above]{%
+	\captioncell[over]{%
 		\captionformat{#1}}}
 \ImagePageTemplate{ImageSpreadFitB}{%
 	\ImageSpreadFit*[bottom, #1]{#2}{#3}}
@@ -3758,10 +3775,16 @@
 %% These macros and environments are used internally to help define cells
 %% and templates and thus can be useful when extending the functionality 
 %% of this class both when authoring styles and when creating user 
-%% macros/templates.
+%% macros/templates.\footnote{%
+%% 		Note that in code the relevant meta-macros are defined in the logical 
+%% 		locations for each macro, i.e. before first use and at the start of 
+%% 		the relevant context. This section in the reference is placed near 
+%% 		the end so as to focus the user's attention on the main class interface,
+%% 		class internal architecture and extension API being secondary.}
 %%
 %% \input{\jobname-meta}
 %%
+%%
 
 
 
diff --git a/workflow/demo.tex b/workflow/demo.tex
new file mode 100644
index 0000000..ae80c91
--- /dev/null
+++ b/workflow/demo.tex
@@ -0,0 +1,133 @@
+%----------------------------------------------------------------------
+
+\documentclass[
+	layoutmode=block,
+	% page size...
+	blockwidth=240mm, blockheight=220mm,
+	bleed=4mm,
+	bindingoffset=5mm,
+	% image block configuration...
+	imageblockwidth=0.98, imageblockheight=0.98,
+	imageblockoffsettop=0,
+	% misc...
+	9pt,final,openany
+]{photobook}
+
+\usepackage{lipsum}
+\usepackage{ragged2e}
+
+
+\setlength\parindent{0pt}
+
+\edef\TestImage{DSC00403-2}
+\edef\TestImageV{DSC00403-2vert}
+
+
+\newcommand\Chapter[1]{
+	\cleartoleftpage%
+	\emptypage%
+	\chapter{#1}}
+
+\newcommand\Section[1]{
+	\cleartoleftpage%
+	\emptypage%
+	\section{#1}}
+
+
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+
+
+
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+
+\begin{document}
+
+\Chapter{Page templates}
+
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+\Section{ImagePage}
+
+\ImagePage{Caption text}{\TestImage}
+
+
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+\Section{ImagePageClear}
+
+\ImagePageClear{ImagePageClear}{\TestImage}
+
+% XXX this is a bit off...
+\ImagePageClearT{ImagePageClearT}{\TestImage}
+% XXX caption/image a bit off vertically...
+\ImagePageClearB{ImagePageClearB}{\TestImage}
+\ImagePageClearL{ImagePageClearL}{\TestImageV}
+\ImagePageClearR{ImagePageClearR}{\TestImageV}
+
+
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+\Section{ImagePageFit}
+
+\ImagePageFit{ImagePageFit}{\TestImage}
+
+\cleartoleftpage
+Special case: image that fits vertically will be offset by \verb+\bindingoffset+
+\ImagePageFit{ImagePageFit}{\TestImageV}
+
+\ImagePageFitT{ImagePageFitT}{\TestImage}
+% XXX this is a bit too low...
+\ImagePageFitB{ImagePageFitB}{\TestImage}
+\ImagePageFitL{ImagePageFitL}{\TestImageV}
+\ImagePageFitR{ImagePageFitR}{\TestImageV}
+
+
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+\Section{ImagePageFill}
+
+\ImagePageFill{ImagePageFill}{\TestImage}
+
+
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+\Section{ImageHalfPageL}
+
+\ImageHalfPageL{ImageHalfPageL}{\TestImage}
+
+
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+\Section{ImageHalfPageR}
+
+\ImageHalfPageR{ImageHalfPageR}{\TestImage}
+
+
+
+%----------------------------------------------------------------------
+\Chapter{Spread templates}
+
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+\Section{ImageSpread}
+\ImageSpread{ImageSpread}{\TestImage}
+
+% XXX top/bottom have problems...
+\ImageSpreadT{ImageSpreadR}{\TestImage}
+\ImageSpreadB{ImageSpreadB}{\TestImage}
+\ImageSpreadL{ImageSpreadL}{\TestImage}
+\ImageSpreadR{ImageSpreadR}{\TestImage}
+
+
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+\Section{ImageSpreadFit}
+\ImageSpreadFit{ImageSpreadFit}{\TestImage}
+
+\ImageSpreadFitT{ImageSpreadFitT}{\TestImage}
+\ImageSpreadFitB{ImageSpreadFitB}{\TestImage}
+\ImageSpreadFitL{ImageSpreadFitL}{\TestImage}
+\ImageSpreadFitR{ImageSpreadFitR}{\TestImage}
+
+
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+\Section{ImageSpreadFill}
+\ImageSpreadFill{ImageSpreadFill}{\TestImage}
+
+
+
+
+%----------------------------------------------------------------------
+\end{document} %                                    vim:set ts=4 sw=4 :