summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-06-26 20:19:05 +0000
committerKarl Berry <karl@freefriends.org>2023-06-26 20:19:05 +0000
commitc85ad0f14d77bd654bfa06eec8e8b02cd0fb5482 (patch)
tree4fbd34817ea0d7cb9b1b195f76deda1e240d8174 /Master/texmf-dist/doc/latex
parent9c223dbd17ea28e9c3a242eb2ff3c3e220e151a0 (diff)
photobook (26jun23)
git-svn-id: svn://tug.org/texlive/trunk@67484 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/photobook/Makefile27
-rw-r--r--Master/texmf-dist/doc/latex/photobook/README.md52
-rw-r--r--Master/texmf-dist/doc/latex/photobook/photobook.pdfbin143897 -> 144078 bytes
-rw-r--r--Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh12
4 files changed, 58 insertions, 33 deletions
diff --git a/Master/texmf-dist/doc/latex/photobook/Makefile b/Master/texmf-dist/doc/latex/photobook/Makefile
index 769c5c2ac4a..59b7ea002c8 100644
--- a/Master/texmf-dist/doc/latex/photobook/Makefile
+++ b/Master/texmf-dist/doc/latex/photobook/Makefile
@@ -43,9 +43,6 @@
#----------------------------------------------------------------------
# Config...
-.EXPORT_ALL_VARIABLES:
-
-
# NOTE: this makes things run consistently on different systems including
# things like Android...
SHELL := bash
@@ -245,14 +242,10 @@ LN := cp -l
# list of dependencies...
#
-# NOTE: grep's -z flag generates a bunch if nulls that we need to clean
-# out via tr.
DEPENDS.txt: $(MODULE).cls
- cat $< \
- | grep -Ezo '\s*\\RequirePackage(\[[^]]*\])?\{[^}]*\}' \
- | sed -e 's/.*{\(.*\)}/hard \1\n/' \
- | grep -a hard \
- | tr -d '\000' \
+ make depends \
+ | grep -v make \
+ | sed -e 's/^/hard /' \
> $@
@@ -265,6 +258,20 @@ version:
@echo $(VERSION)
+# NOTE: grep's -z flag generates a bunch if nulls that we need to clean
+# out via tr.
+# XXX this is a bit ugly -- adding/removing "hard" and then adding it
+# again for DEPENDS.txt...
+.PHONY: depends
+depends: $(MODULE).cls
+ @cat $< \
+ | grep -Ezo '\s*\\RequirePackage(\[[^]]*\])?\{[^}]*\}' \
+ | sed -e 's/.*{\(.*\)}/hard \1\n/' \
+ | grep -a hard \
+ | tr -d '\000' \
+ | cut -d " " -f 2
+
+
#----------------------------------------------------------------------
# Main targets...
diff --git a/Master/texmf-dist/doc/latex/photobook/README.md b/Master/texmf-dist/doc/latex/photobook/README.md
index 004a438e86c..54e29d5eba4 100644
--- a/Master/texmf-dist/doc/latex/photobook/README.md
+++ b/Master/texmf-dist/doc/latex/photobook/README.md
@@ -4,27 +4,19 @@ photobook
[LaTeX](https://www.latex-project.org/) document class for making photo books.
-## Build requirements for docs
-
-- LaTeX tool chain (including: `lualatex`, `latexmk`, ..)
- The simplest way to get started is [TeX Live](https://www.tug.org/texlive/),
- either a full install or for specific modules see the _Packages_ section
- in [photobook.cls](./photobook.cls),
-- Un\*x-like environment (`bash`, GNU Make, coreutils, ...),
- on Windows systems, either [Cygwin](https://www.cygwin.com/) or
- [WSL/WSL2](https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux)
- should work fine.
-
+Available on:
+- CTAN: https://ctan.org/pkg/photobook
+- GitHub: https://github.com/flynx/photobook
-## Build / Install
+## Install / Build
-The package is available on:
-- CTAN: https://ctan.org/pkg/photobook
-- GitHub: https://github.com/flynx/photobook
+The simplest way to install is to use either
+[TeX Live](https://www.tug.org/texlive/)'s or [MiLTeX](https://miktex.org/)'s
+standard way to install modules.
-To install from source:
+Installing from source:
```shell
# get the source...
$ git clone https://github.com/flynx/photobook.git
@@ -34,14 +26,38 @@ $ cd ./photobook
$ make install
```
-If only building the docs is required without installing:
+The `photobook` document class requires a set of modules to be installed
+for it to function, the full list is included in the docs and can be
+printed by calling:
```shell
-$ make pdf
+$ make depends
```
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:
+```shell
+$ make pdf
+```
+
+Build requirements for docs:
+- LaTeX tool chain (including: `lualatex`, `latexmk`, ..)
+ The simplest way to get started is [TeX Live](https://www.tug.org/texlive/),
+ either a full install or for specific modules see the _Packages_ section
+ in [photobook.cls](./photobook.cls),
+- Un\*x-like environment (`bash`, GNU Make, coreutils, ...),
+ on Windows systems, either [Cygwin](https://www.cygwin.com/) or
+ [WSL/WSL2](https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux)
+ should work fine.
+
+
+
## Notes
- The main refetence is inline with the source [photobook.cls](./photobook.cls)
diff --git a/Master/texmf-dist/doc/latex/photobook/photobook.pdf b/Master/texmf-dist/doc/latex/photobook/photobook.pdf
index 9368564c5d1..d78e1f2b17b 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 6505e1091f0..41dae4ec270 100644
--- a/Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh
+++ b/Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh
@@ -56,9 +56,11 @@ ANOTATE_IMAGE_PATHS=${ANOTATE_IMAGE_PATHS:=}
# supported formats/extensions...
TEXT_FORMATS=${TEXT_FORMATS:=$CFG_TEXT_FORMATS}
TEXT_FORMATS=${TEXT_FORMATS:=txt}
+TEXT_FORMATS=${TEXT_FORMATS,,}
IMAGE_FORMATS=${IMAGE_FORMATS:=$CFG_IMAGE_FORMATS}
IMAGE_FORMATS=${IMAGE_FORMATS:=jpeg|jpg|png|pdf|svg|eps}
+IMAGE_FORMATS=${IMAGE_FORMATS,,}
SPREADS_DIR=${SPREADS_DIR:=$CFG_SPREADS_DIR}
@@ -366,9 +368,9 @@ populateTemplate(){
local txt=()
local elem
for elem in "${items[@]}" ; do
- if [[ "$elem" =~ $IMAGE_FORMATS ]] ; then
+ if [[ "${elem,,}" =~ $IMAGE_FORMATS ]] ; then
img+=("$elem")
- elif [[ "$elem" =~ $TEXT_FORMATS ]] ; then
+ elif [[ "${elem,,}" =~ $TEXT_FORMATS ]] ; then
txt+=("$elem")
fi
done
@@ -491,10 +493,10 @@ handleSpread(){
local txt=()
local items=()
for elem in "$spread"/* ; do
- if [[ "$elem" =~ $IMAGE_FORMATS ]] ; then
+ if [[ "${elem,,}" =~ $IMAGE_FORMATS ]] ; then
img+=("$elem")
items+=("$elem")
- elif [[ "$elem" =~ $TEXT_FORMATS ]] ; then
+ elif [[ "${elem,,}" =~ $TEXT_FORMATS ]] ; then
txt+=("$elem")
items+=("$elem")
fi
@@ -574,7 +576,7 @@ handleSpread(){
# slots/files from list...
# image...
- if [[ "$elem" =~ $IMAGE_FORMATS ]] ; then
+ if [[ "${elem,,}" =~ $IMAGE_FORMATS ]] ; then
echo %
echo "% $P page (image)..."
template=`getTemplate "$spread" "$IMAGE_PAGE"`