diff options
author | Karl Berry <karl@freefriends.org> | 2023-06-26 20:19:05 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2023-06-26 20:19:05 +0000 |
commit | c85ad0f14d77bd654bfa06eec8e8b02cd0fb5482 (patch) | |
tree | 4fbd34817ea0d7cb9b1b195f76deda1e240d8174 /Master/texmf-dist/doc/latex | |
parent | 9c223dbd17ea28e9c3a242eb2ff3c3e220e151a0 (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/Makefile | 27 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/photobook/README.md | 52 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/photobook/photobook.pdf | bin | 143897 -> 144078 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh | 12 |
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 Binary files differindex 9368564c5d1..d78e1f2b17b 100644 --- a/Master/texmf-dist/doc/latex/photobook/photobook.pdf +++ b/Master/texmf-dist/doc/latex/photobook/photobook.pdf 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"` |