From 94c93aab885d39a26d41dbfff06d9d33a0f69c81 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 20 Oct 2021 21:16:12 +0000 Subject: incgraph (20oct21) git-svn-id: svn://tug.org/texlive/trunk@60810 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/incgraph/CHANGES | 62 --- Master/texmf-dist/doc/latex/incgraph/CHANGES.md | 138 +++++++ Master/texmf-dist/doc/latex/incgraph/README | 52 --- Master/texmf-dist/doc/latex/incgraph/README.md | 55 +++ .../texmf-dist/doc/latex/incgraph/incgraph-doc.sty | 140 +++++++ .../doc/latex/incgraph/incgraph-example-a.pdf | Bin 317031 -> 317493 bytes .../doc/latex/incgraph/incgraph-example-b.pdf | Bin 327514 -> 328766 bytes .../doc/latex/incgraph/incgraph-example-c.pdf | Bin 320045 -> 320763 bytes Master/texmf-dist/doc/latex/incgraph/incgraph.pdf | Bin 994963 -> 1023673 bytes Master/texmf-dist/doc/latex/incgraph/incgraph.tex | 419 ++++++++++++--------- 10 files changed, 572 insertions(+), 294 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/incgraph/CHANGES create mode 100644 Master/texmf-dist/doc/latex/incgraph/CHANGES.md delete mode 100644 Master/texmf-dist/doc/latex/incgraph/README create mode 100644 Master/texmf-dist/doc/latex/incgraph/README.md create mode 100644 Master/texmf-dist/doc/latex/incgraph/incgraph-doc.sty (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/incgraph/CHANGES b/Master/texmf-dist/doc/latex/incgraph/CHANGES deleted file mode 100644 index 14901dbd116..00000000000 --- a/Master/texmf-dist/doc/latex/incgraph/CHANGES +++ /dev/null @@ -1,62 +0,0 @@ -%% The LaTeX package incgraph - version 1.12 (2015/03/12) -%% -%% ------------------------------------------------------------------------------------------- -%% Copyright (c) 2012-2015 by Prof. Dr. Dr. Thomas F. Sturm -%% ------------------------------------------------------------------------------------------- -%% -%% This work may be distributed and/or modified under the -%% conditions of the LaTeX Project Public License, either version 1.3 -%% of this license or (at your option) any later version. -%% The latest version of this license is in -%% http://www.latex-project.org/lppl.txt -%% and version 1.3 or later is part of all distributions of LaTeX -%% version 2005/12/01 or later. -%% -%% This work has the LPPL maintenance status `author-maintained'. -%% -%% This work consists of all files listed in README -%% - -version 1.00 (2012/06/21): initial public release - -version 1.01 (2012/07/04): -- the code of the hypertarget setting is rewritten to place it at - the top left corner of the page (previously it was placed at the - top left corner of the text area). -- new macro '\igrtargetset' to set hypertarget values manually -- new key 'target' to set hypertarget values manually - -version 1.02 (2012/07/06): -- bug fixed in '\igrboxtikz' which caused a small shift. -- key 'nohyper' renamed to 'no hyper' -- new macro '\igrboxtikzcenter' to support tikz pictures with a centered box. -- option key 'include command' now has a default. -- new feature to overlay included graphics with tikz picture code - using the new option keys 'overlay', 'overlay page number at', - 'overlay page number at bottom', 'overlay page number at top', - 'no overlay'. - -version 1.10 (2012/09/28): -- overlay code and graphics inclusion decoupled internally -- interlineskip problem fixed -- output macro implementation rewritten -- new macro '\igrcenterfit' for an arbitrary paper size -- new user interface environment 'inctext' to support - arbitrary internal graphics -- documentation structure changed -- introduction of various paper format options with the key 'paper' -- new 'landscape' and 'portrait' keys -- new keys 'currentpaper', 'graphicspaper' and 'documentpaper' - to replace the deprecated keys 'page' and 'center' -- various internal code changes - -version 1.11 (2013/01/16): -- bug fixed: positioning on even pages for twosided documents -- bug fixed: option 'paper=document' could not be used inside the preamble -- added clearpage at begin of inctext - -version 1.12 (2015/03/12): -- ugly pictures of the documentation exchanged by not so ugly ones. -- new options: - 'left border', 'bottom border', 'right border', 'top border', - 'horizontal border', 'vertical border', 'border' diff --git a/Master/texmf-dist/doc/latex/incgraph/CHANGES.md b/Master/texmf-dist/doc/latex/incgraph/CHANGES.md new file mode 100644 index 00000000000..0b6698f2100 --- /dev/null +++ b/Master/texmf-dist/doc/latex/incgraph/CHANGES.md @@ -0,0 +1,138 @@ +# Changelog +All notable changes to this project will be documented in this file. + +The format is based on +[Keep a Changelog](https://keepachangelog.com/en/1.0.0/), +and this project adheres to +[Semantic Versioning](http://semver.org/spec/v2.0.0.html). + +## [Unreleased] + +### Added +### Changed +### Deprecated +### Removed +### Fixed +### Security + + + +## [1.2.0] - 2021-10-20 + +### Added +- Option `overlay page number options` (issue #2) +- `\igrGetPageSize` +- `\igrPageWidth` +- `\igrPageHeight` +- `\igrSetPageSize` +- `\igrGetLastPage` +- `\igrLastPage` +- Adding/Guessing file name extensions (issue #1): + - Option `extensions` + - Option `extensions add` + - Option `extensions from graphics` + - Option `ignore on not found with extensions` + - Option `ignore on not found with extensions*` +- Option `no existence check` + +### Changed +- Changelog moved from CHANGES to CHANGES.md and adapted to + [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) +- From now on version numbers adhere to + [Semantic Versioning](http://semver.org/spec/v2.0.0.html) +- Readme moved from README to README.md and adapted to +- Documentation code revised +- Internal package creation process modernized (invisible to the user) +- Adaption of paper size made compatible with lualatex +- Implementation of `\incgraph` and `\incmultigraph` changed (to LaTeX3) + +### Fixed +- Documentation typos corrected (issue #3) +- `\incgraph` ignored option settings for not existing files. + + + +## [1.12] - 2015-03-12 + +### Added +- Option `left border` +- Option `bottom border` +- Option `right border` +- Option `top border` +- Option `horizontal border` +- Option `vertical border` +- Option `border` + +### Changed +- ugly pictures of the documentation exchanged by not so ugly ones. + + + +## [1.11] - 2013-01-16 + +### Added +- added `clearpage` at begin of `inctext` + +### Fixed +- Positioning on even pages for twosided documents +- Option `paper=document` could not be used inside the preamble + + + +## [1.10] - 2012-09-28 + +### Added +- new macro `\igrcenterfit` for an arbitrary paper size +- new user interface environment `inctext` to support + arbitrary internal graphics +- introduction of various paper format options with the key `paper` +- new `landscape` and `portrait` keys +- new keys `currentpaper`, `graphicspaper` and `documentpaper` + to replace the deprecated keys `page` and `center` + +### Changed +- overlay code and graphics inclusion decoupled internally +- output macro implementation rewritten +- documentation structure changed +- various internal code changes + +### Fixed +- interlineskip problem fixed + + + +## [1.02] - 2012-07-06 + +### Added +- new macro `\igrboxtikzcenter` to support tikz pictures with a centered box. +- new feature to overlay included graphics with tikz picture code + using the new option keys `overlay`, `overlay page number at`, + `overlay page number at bottom`, `overlay page number at top`, + `no overlay`. + +### Changed +- key `nohyper` renamed to `no hyper` +- option key `include command` now has a default. + +### Fixed +- bug fixed in `\igrboxtikz` which caused a small shift. + + + +## [1.01] - 2012-07-04 + +### Added +- new macro `\igrtargetset` to set hypertarget values manually +- new key `target` to set hypertarget values manually + +### Changed +- the code of the hypertarget setting is rewritten to place it at + the top left corner of the page (previously it was placed at the + top left corner of the text area). + + + +## [1.00] - 2012-06-21 + +### Added +- initial public release diff --git a/Master/texmf-dist/doc/latex/incgraph/README b/Master/texmf-dist/doc/latex/incgraph/README deleted file mode 100644 index 4acfe46fbe6..00000000000 --- a/Master/texmf-dist/doc/latex/incgraph/README +++ /dev/null @@ -1,52 +0,0 @@ -%% The LaTeX package incgraph - version 1.12 (2015/03/12) -%% -%% ------------------------------------------------------------------------------------------- -%% Copyright (c) 2012-2015 by Prof. Dr. Dr. Thomas F. Sturm -%% ------------------------------------------------------------------------------------------- -%% -%% This work may be distributed and/or modified under the -%% conditions of the LaTeX Project Public License, either version 1.3 -%% of this license or (at your option) any later version. -%% The latest version of this license is in -%% http://www.latex-project.org/lppl.txt -%% and version 1.3 or later is part of all distributions of LaTeX -%% version 2005/12/01 or later. -%% -%% This work has the LPPL maintenance status `author-maintained'. -%% -%% This work consists of all files listed in README -%% - -incgraph provides tools for including graphics on full paper size. The graphics -can be centered for a given paper format or the paper may be resized to the -graphics dimensions. The main use case for the package incgraph is to transform -one or many scans or taken pictures to a PDF document. It can also be applied -for full paper size LaTeX created graphics. The package incgraph provides a tool -box with basic macros and a convenience user interface which wraps the -well-known includegraphics. Also, bookmarking is especially supported. - -Contents of the package -======================= - 'README' this file - 'CHANGES' log of changes (history) - 'incgraph.sty' LaTeX package file (style file) - 'incgraph.pdf' documentation for csvsimple - 'incgraph.tex' source code of the documentation - 'incgraph-example-a.tex' example file A for package usage - 'incgraph-example-a.pdf' compiled example A - 'incgraph-example-b.tex' example file B for package usage - 'incgraph-example-b.pdf' compiled example B - 'incgraph-example-c.tex' example file C for package usage - 'incgraph-example-c.pdf' compiled example C - 'example.jpg' example image file - 'exaimage-0001.png' example image file - 'exaimage-0037.png' example image file - 'exaimage-0123.png' example image file - -Installation -============ -Copy the contents of the 'incgraph.tds.zip' from CTAN to your local TeX file tree. - -Alternatively, put the files to their respective locations within the TeX installation: - 'incgraph.sty' -> /tex/latex/incgraph - all other files -> /doc/latex/incgraph diff --git a/Master/texmf-dist/doc/latex/incgraph/README.md b/Master/texmf-dist/doc/latex/incgraph/README.md new file mode 100644 index 00000000000..78e1983b504 --- /dev/null +++ b/Master/texmf-dist/doc/latex/incgraph/README.md @@ -0,0 +1,55 @@ +# The LaTeX package incgraph - version 1.2.0 (2021/10/20) + + +> Copyright (c) 2012-2021 by Prof. Dr. Dr. Thomas F. Sturm + +> This work may be distributed and/or modified under the +> conditions of the LaTeX Project Public License, either version 1.3 +> of this license or (at your option) any later version. +> The latest version of this license is in +> http://www.latex-project.org/lppl.txt +> and version 1.3 or later is part of all distributions of LaTeX +> version 2005/12/01 or later. + +> This work has the LPPL maintenance status `author-maintained`. + +> This work consists of all files listed in README.md + + +`incgraph` provides tools for including graphics on full paper size. The graphics +can be centered for a given paper format or the paper may be resized to the +graphics dimensions. The main use case for the package `incgraph` is to transform +one or many scans or taken pictures to a PDF document. It can also be applied +for full paper size *LaTeX* created graphics. The package `incgraph` provides a tool +box with basic macros and a convenience user interface which wraps the +well-known `includegraphics`. Also, bookmarking is especially supported. + + +## Contents of the package + +- `README.md` this file +- `CHANGES.md` log of changes (history) +- `incgraph.sty` LaTeX package file (style file) +- `incgraph.pdf` documentation for csvsimple +- `incgraph.tex` source code of the documentation +- `incgraph-doc.sty` style file of the documentation +- `incgraph-example-a.tex` example file A for package usage +- `incgraph-example-a.pdf` compiled example A +- `incgraph-example-b.tex` example file B for package usage +- `incgraph-example-b.pdf` compiled example B +- `incgraph-example-c.tex` example file C for package usage +- `incgraph-example-c.pdf` compiled example C +- `example.jpg` example image file +- `exaimage-0001.png` example image file +- `exaimage-0037.png` example image file +- `exaimage-0123.png` example image file + + +## Installation + +Copy the contents of the `incgraph.tds.zip` from CTAN to your local TeX file tree. + +Alternatively, put the files to their respective locations within the TeX installation: + +- `incgraph.sty` -> /tex/latex/incgraph +- all other files -> /doc/latex/incgraph diff --git a/Master/texmf-dist/doc/latex/incgraph/incgraph-doc.sty b/Master/texmf-dist/doc/latex/incgraph/incgraph-doc.sty new file mode 100644 index 00000000000..efa2c71447b --- /dev/null +++ b/Master/texmf-dist/doc/latex/incgraph/incgraph-doc.sty @@ -0,0 +1,140 @@ +% \LaTeX-Main\ +% !TeX encoding=UTF-8 +%% The LaTeX package incgraph - version 1.2.0 (2021/10/20) +%% incgraph.tex: Manual +%% +%% ------------------------------------------------------------------------------------------- +%% Copyright (c) 2012-2021 by Prof. Dr. Dr. Thomas F. Sturm +%% ------------------------------------------------------------------------------------------- +%% +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either version 1.3 +%% of this license or (at your option) any later version. +%% The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.3 or later is part of all distributions of LaTeX +%% version 2005/12/01 or later. +%% +%% This work has the LPPL maintenance status `author-maintained'. +%% +%% This work consists of all files listed in README +%% +\def\version{1.2.0}% +\def\datum{2021/10/20}% + +\IfFileExists{incgraph-doc.cfg}{\input{incgraph-doc.cfg}}{}\providecommand\igrpkgprefix{} + +\RequirePackage[T1]{fontenc} +\RequirePackage[english]{babel} +\RequirePackage{lmodern,parskip,array,makeidx} +\RequirePackage{amsmath,amssymb} +\RequirePackage[svgnames,table,hyperref]{xcolor} +\RequirePackage{tikz} + +\RequirePackage[bookmarks,raiselinks,pageanchor,hyperindex,colorlinks]{hyperref} +\urlstyle{sf} +\RequirePackage{cleveref} + +\RequirePackage[a4paper,left=2.5cm,right=2.5cm,top=1.5cm,bottom=1.5cm, + marginparsep=3mm,marginparwidth=18mm, + headheight=0mm,headsep=0cm, + footskip=1.5cm,includeheadfoot]{geometry} +\RequirePackage{fancyhdr} +\fancyhf{} +\fancyfoot[C]{\thepage}% +\renewcommand{\headrulewidth}{0pt} +\renewcommand{\footrulewidth}{0pt} +\pagestyle{fancy} +\tolerance=2000% +\setlength{\emergencystretch}{20pt}% + +\RequirePackage[many,minted,documentation]{tcolorbox} +\RequirePackage{csquotes} +\RequirePackage[style=numeric-comp,sorting=nyt, + maxnames=8,minnames=8,abbreviate=false,backend=biber]{biblatex} +\DeclareFieldFormat{url}{\newline\url{#1}}% +\DeclareListFormat{language}{}% +\setlength{\bibitemsep}{\smallskipamount} +\addbibresource{\jobname.bib} + +\tcbset{skin=enhanced, + doc head={colback=yellow!10!white,interior style=fill}, + doc head key={colback=magenta!5!white,interior style=fill}, + color key=DarkViolet, + color value=Teal, + color color=Teal, + color counter=Orange!85!black, + color length=Orange!85!black, + index colorize, + index annotate, + beforeafter example/.style={ + before skip=4pt plus 2pt minus 1pt, + after skip=8pt plus 4pt minus 2pt + }, +} +\renewcommand*{\tcbdocnew}[1]{\textcolor{green!50!black}{\sffamily\bfseries N} #1} +\renewcommand*{\tcbdocupdated}[1]{\textcolor{blue!75!black}{\sffamily\bfseries U} #1} + +\RequirePackage{\igrpkgprefix incgraph} + +\hypersetup{ + pdftitle={Manual for the incgraph package}, + pdfauthor={Thomas F. Sturm}, + pdfsubject={graphics inclusion}, + pdfkeywords={graphics inclusion page} +} + +\RequirePackage{tikz,multicol} + +\tcbset{ + docexample/.style={bicolor, + beforeafter example, + fonttitle=\bfseries, + fontlower=\footnotesize, + colframe=Navy!50!ExampleFrame, + colback=Navy!5!ExampleBack!50!white, + colbacklower=ExampleBack!5!white, + drop fuzzy shadow, + listing engine=minted, + documentation minted style=colorful, + documentation minted options={fontsize=\footnotesize}, + }, + example/.style={ + docexample, + listing only, + before title={\hypersetup{linkcolor=white}}, + }, +} + +\tcbmakedocSubKey{docIgrKey}{igr} +\tcbmakedocSubKeys{docIgrKeys}{igr} + +\newcounter{texexp} + +\newtcblisting[use counter=texexp]{texexptitled}[3][]{% + example, + title={Example~\thetcbcounter: #2}, + listing file={\jobname.\thetcbcounter.listing}, + label={#3},#1 +} + +\newtcbinputlisting[use counter from=texexptitled]{\inputexamplelisting}[3][]{ + example, + title={Example~\thetcbcounter: \texttt{#2}}, + listing file={#2}, + label={#3},#1 +} + +\newcommand{\inputlisting}[1]{\input{\jobname.#1.listing}} +\newcommand{\inputlastlisting}{\inputlisting{\thetexexp}} + +\def\tikzname{Ti\emph{k}Z} + +\makeindex + +\ExplSyntaxOn +\sys_if_engine_pdftex:T + { + \pdfsuppresswarningpagegroup=1 + } +\ExplSyntaxOff diff --git a/Master/texmf-dist/doc/latex/incgraph/incgraph-example-a.pdf b/Master/texmf-dist/doc/latex/incgraph/incgraph-example-a.pdf index cc78605606e..1e5b76d3044 100644 Binary files a/Master/texmf-dist/doc/latex/incgraph/incgraph-example-a.pdf and b/Master/texmf-dist/doc/latex/incgraph/incgraph-example-a.pdf differ diff --git a/Master/texmf-dist/doc/latex/incgraph/incgraph-example-b.pdf b/Master/texmf-dist/doc/latex/incgraph/incgraph-example-b.pdf index 9934a81f585..9ee06ea60da 100644 Binary files a/Master/texmf-dist/doc/latex/incgraph/incgraph-example-b.pdf and b/Master/texmf-dist/doc/latex/incgraph/incgraph-example-b.pdf differ diff --git a/Master/texmf-dist/doc/latex/incgraph/incgraph-example-c.pdf b/Master/texmf-dist/doc/latex/incgraph/incgraph-example-c.pdf index 7609eccc316..67ca683b623 100644 Binary files a/Master/texmf-dist/doc/latex/incgraph/incgraph-example-c.pdf and b/Master/texmf-dist/doc/latex/incgraph/incgraph-example-c.pdf differ diff --git a/Master/texmf-dist/doc/latex/incgraph/incgraph.pdf b/Master/texmf-dist/doc/latex/incgraph/incgraph.pdf index 4cbee4db693..1dd52b2d1dd 100644 Binary files a/Master/texmf-dist/doc/latex/incgraph/incgraph.pdf and b/Master/texmf-dist/doc/latex/incgraph/incgraph.pdf differ diff --git a/Master/texmf-dist/doc/latex/incgraph/incgraph.tex b/Master/texmf-dist/doc/latex/incgraph/incgraph.tex index 7425a75ab2b..1b739cfaf8c 100644 --- a/Master/texmf-dist/doc/latex/incgraph/incgraph.tex +++ b/Master/texmf-dist/doc/latex/incgraph/incgraph.tex @@ -1,9 +1,10 @@ % \LaTeX-Main\ -%% The LaTeX package incgraph - version 1.12 (2015/03/12) +% !TeX encoding=UTF-8 +%% The LaTeX package incgraph - version 1.2.0 (2021/10/20) %% incgraph.tex: Manual %% %% ------------------------------------------------------------------------------------------- -%% Copyright (c) 2012-2013 by Prof. Dr. Dr. Thomas F. Sturm +%% Copyright (c) 2012-2021 by Prof. Dr. Dr. Thomas F. Sturm %% ------------------------------------------------------------------------------------------- %% %% This work may be distributed and/or modified under the @@ -20,111 +21,7 @@ %% \documentclass[a4paper,11pt]{ltxdoc} -\usepackage[T1]{fontenc} -\usepackage[latin1]{inputenc} -\usepackage[english]{babel} -\usepackage{lmodern,parskip,array,ifthen,calc,makeidx} -\usepackage{amsmath,amssymb} -\usepackage[svgnames,table,hyperref]{xcolor} -\usepackage{tikz} -\usepackage[pdftex,bookmarks,raiselinks,pageanchor,hyperindex,colorlinks]{hyperref} -\urlstyle{sf} - -\usepackage[a4paper,left=2.5cm,right=2.5cm,top=1.5cm,bottom=1.5cm, - marginparsep=3mm,marginparwidth=18mm, - headheight=0mm,headsep=0cm, - footskip=1.5cm,includeheadfoot]{geometry} -\usepackage{fancyhdr} -\fancyhf{} -\fancyfoot[C]{\thepage}% -\renewcommand{\headrulewidth}{0pt} -\renewcommand{\footrulewidth}{0pt} -\pagestyle{fancy} -\tolerance=2000% -\setlength{\emergencystretch}{20pt}% - -\RequirePackage{csquotes} -\RequirePackage[style=numeric-comp,sorting=nyt, - maxnames=8,minnames=8,abbreviate=false,backend=biber]{biblatex} -\DeclareFieldFormat{url}{\newline\url{#1}}% -\DeclareListFormat{language}{}% -\setlength{\bibitemsep}{\smallskipamount} -\addbibresource{\jobname.bib} - -\usepackage[many,listings,documentation]{tcolorbox} - -\tcbset{skin=enhanced, - doc head={colback=yellow!10!white,interior style=fill}, - doc head key={colback=magenta!5!white,interior style=fill}, - color key=DarkViolet, - color value=Teal, - color color=Teal, - color counter=Orange!85!black, - color length=Orange!85!black, - index colorize, - index annotate, - %external/externalizer=tcolorbox.doc.externalizer, -} -\renewcommand*{\tcbdocnew}[1]{\textcolor{green!50!black}{\sffamily\bfseries N} #1} -\renewcommand*{\tcbdocupdated}[1]{\textcolor{blue!75!black}{\sffamily\bfseries U} #1} - -\usepackage{incgraph} - -\hypersetup{ - pdftitle={Manual for the incgraph package}, - pdfauthor={Thomas F. Sturm}, - pdfsubject={graphics inclusion}, - pdfkeywords={graphics inclusion page} -} - -\usepackage{tikz,multicol} - -\lstdefinestyle{mydocumentation}{style=tcbdocumentation, - classoffset=0, - texcsstyle=\color{blue}, - % LaTeX and other packages - moretexcs={arrayrulecolor,draw,path,fill,includegraphics,ifthenelse,isodd,lipsum,path,pgfkeysalso,foreach}, - classoffset=1, - moretexcs={% - incgraph,incmultigraph,n,ni,nn,nt,igrset,igrpage,igrcenter,igrcenterfit, - igrtargetset,igrboxset,igrboxcenter,igrpagestyle,igrboxtikz,igrboxtikzpage, - igrboxtikzcenter,igrsetmatchvalue,igrsetmatches,igrifmatch,igrmakezerofill, - }, - texcsstyle=\color{Definition}\bfseries, - classoffset=2, - keywordstyle=\color{Option}\bfseries, - % option list - morekeywords={% - }, - classoffset=0% restore default - } - -\tcbset{documentation listing style=mydocumentation,% - docexample/.style={enhanced,colframe=Navy!50!ExampleFrame,colback=Navy!5!ExampleBack,fontlower=\footnotesize, - bicolor,colbacklower=ExampleBack!5!white,drop fuzzy shadow}, -} - -\tcbmakedocSubKey{docIgrKey}{igr} - -\newcounter{texexp} - -\tcbset{ - example/.code 2 args={\refstepcounter{texexp}% - \pgfkeysalso{label={#2},docexample,listing style=mydocumentation,fonttitle=\bfseries,title={Example \thetexexp: #1}}}, -} - -\newenvironment{texexptitled}[3][]{% - \hypersetup{linkcolor=white}% - \tcbset{example={#2}{#3},listing file={\jobname.\thetexexp.listing},#1}% - \tcblisting{}}{\endtcblisting} - - -\newcommand{\inputlisting}[1]{\input{\jobname.#1.listing}} -\newcommand{\inputlastlisting}{\inputlisting{\thetexexp}} - -\def\version{1.12}% -\def\datum{2015/03/12}% -\makeindex +\usepackage{incgraph-doc} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -140,7 +37,10 @@ {\large Thomas F.~Sturm% \footnote{Prof.~Dr.~Dr.~Thomas F.~Sturm, Institut f\"{u}r Mathematik und Informatik, Universit\"{a}t der Bundeswehr M\"{u}nchen, D-85577 Neubiberg, Germany; - email: \href{mailto:thomas.sturm@unibw.de}{thomas.sturm@unibw.de}} } + email: \href{mailto:thomas.sturm@unibw.de}{thomas.sturm@unibw.de}}\par\medskip +\normalsize\url{https://www.ctan.org/pkg/incgraph}\par +\url{https://github.com/T-F-S/incgraph} +} \end{center} \bigskip \begin{absquote} @@ -185,11 +85,13 @@ An important use case for the package |incgraph| is to transform one or many sca or taken pictures to a PDF document. Optionally, the included graphics can be commented with bookmarks for the resulting PDF document. -The well-known |graphicx| package \cite{carlisle:1999a} allows the inclusion +The well-known |graphicx| package \cite{carlisle:graphics} allows the inclusion of several types of external graphics files. The convenience user interface of |incgraph| described in Section \ref{sec:interface} relies on this package and adds assistance for the described purpose. Note that the package is designed for and -tested with |pdflatex| to produce PDF directly. Some features like the paper +tested with |pdflatex| to produce PDF directly. Also, the package is +intended to harmonize with |lualatex|. +Some features like the paper resizing may not be applicable for other work-flows. Many of the features of the convenience user interface can be used directly @@ -197,7 +99,7 @@ with various basic macros. These are collected and described as a 'basic tool box' in Section \ref{sec:basictoolbox}. If this package does not aid your intended purpose, you may take a look -at the |pdfpages| package \cite{matthias:2012a} which also supports the insertion of +at the |pdfpages| package \cite{matthias:pdfpages} which also supports the insertion of external multi-page PDF documents. @@ -208,10 +110,10 @@ external multi-page PDF documents. \end{dispListing} The package |incgraph| loads the package -|pgfkeys| \cite{tantau:2013a}. If no options are given, it also -loads the packages |pgf|, |pgffor| \cite{tantau:2013a}, -the package |graphicx| \cite{carlisle:1999a}, and the -package |bookmark| \cite{oberdiek:2011a}. +|pgfkeys| \cite{tantau:tikz}. If no options are given, it also +loads the packages |pgf|, |pgffor| \cite{tantau:tikz}, +the package |graphicx| \cite{carlisle:graphics}, and the +package |bookmark| \cite{oberdiek:bookmark}. \begin{itemize} \item The option |nopgf| prevents the loading of |pgf| and |pgffor|.\\ @@ -231,13 +133,13 @@ Note that you can always load the mentioned packages yourself. This is intended to avoid possible option clashes the easy way. - +\clearpage %-------------------------------------- \section{User Interface}\label{sec:interface} \subsection{Inclusion Macros for External Graphics} The macros of this section rely on the |\includegraphics| command from -the package |graphicx| \cite{carlisle:1999a}. +the package |graphicx| \cite{carlisle:graphics}. %Section \ref{sec:basictoolbox} describes more basic commands. \begin{docCommand}{incgraph}{\oarg{options}\oarg{graphics options}\marg{file name}} @@ -247,22 +149,22 @@ the package |graphicx| \cite{carlisle:1999a}. The applicable \meta{options} are listed in Section \ref{sec:keys}. If \meta{graphics options} are given, these are added to the options for the underlying |\includegraphics| command. See the documentation of - |graphicx| \cite{carlisle:1999a} for a list of applicable \meta{graphics options}. + |graphicx| \cite{carlisle:graphics} for a list of applicable \meta{graphics options}. -\begin{texexptitled}[listing only,before={\par\medskip}]% +\begin{texexptitled}% {The hand-drawn example (centered); see page~\pageref{exacenter}}{exacenter.listing} \incgraph[paper=current,label={exacenter},overlay page number at bottom, bookmark={The hand-drawn example (centered)}]{example.jpg} \end{texexptitled} -\begin{texexptitled}[listing only,before={\par\medskip}]% +\begin{texexptitled}% {The hand-drawn example (resized page); see page~\pageref{exaresized}}{exaresized.listing} \incgraph[paper=graphics,label={exaresized}, bookmark={The hand-drawn example (resized page)}]{example.jpg} \end{texexptitled} -\begin{texexptitled}[listing only,before={\par\medskip}]% +\begin{texexptitled}% {The hand-drawn example (rotated and oversized); see page~\pageref{exarotated}}{exarotated.listing} \incgraph[paper=current,label={exarotated},target=oversized, bookmark={The hand-drawn example (rotated and oversized)}]% @@ -279,8 +181,8 @@ the package |graphicx| \cite{carlisle:1999a}. The applicable \meta{options} are listed in Section \ref{sec:keys}. If \meta{graphics options} are given, these are added to the options for the underlying |\includegraphics| command. See the documentation of - |graphicx| \cite{carlisle:1999a} for a list of applicable \meta{graphics options}.\\ - The \meta{list} may contain any construction allowed for the |\foreach| statement \cite{tantau:2013a}, + |graphicx| \cite{carlisle:graphics} for a list of applicable \meta{graphics options}.\\ + The \meta{list} may contain any construction allowed for the |\foreach| statement \cite{tantau:tikz}, especially a list of numbers. The elements of the list can be used inside the \meta{file name pattern} with the following macros: @@ -297,7 +199,7 @@ the package |graphicx| \cite{carlisle:1999a}. \end{itemize} In the default behavior, non existing files are ignored. -\begin{texexptitled}[listing only,before={\par\medskip}]% +\begin{texexptitled}% {A series of pictures; see from page~\pageref{exaseries.1}. The image files exaimage-0001.png to exaimage-0150.png are included but only three of them exist.}{exaseries.listing} @@ -315,7 +217,7 @@ the package |graphicx| \cite{carlisle:1999a}. The applicable \meta{options} are listed in Section \ref{sec:keys}. -\begin{texexptitled}[listing only,before={\par\medskip}]% +\begin{texexptitled}% {Some text on a shrunk paper; see page~\pageref{inctext1}}{inctext1.listing} \begin{inctext}[paper=graphics,label={inctext1},bookmark={A huge ABC}] \Huge ABC @@ -323,7 +225,7 @@ the package |graphicx| \cite{carlisle:1999a}. \end{texexptitled} -\begin{texexptitled}[listing only,before={\par\medskip}]% +\begin{texexptitled}% {A tikzpicture as text content; see page~\pageref{inctext2}}{inctext2.listing} \begin{inctext}[paper=a6,landscape,label={inctext2},bookmark={Graph}, overlay page number at bottom=8mm] @@ -397,7 +299,7 @@ the package |graphicx| \cite{carlisle:1999a}. |b0|, |b1|, |b2|, |b3|, |b4|, |b5|, |b6|, |b7|, |b8|, |b9|, |b10|, |c0|, |c1|, |c2|, |c3|, |c4|, |c5|, |c6|, |c7|, |c8|, |c9|, |c10|, |d0|, |d1|, |d2|, |d3|, |d4|, |d5|, |d6|, |d7|, - executive, letter, legal, ledger. + |executive|, |letter|, |legal|, |ledger|. \end{docIgrKey} \begin{docIgrKey}{landscape}{}{no value} @@ -437,10 +339,10 @@ the package |graphicx| \cite{carlisle:1999a}. \subsection{Graphics Inclusion} \begin{docIgrKey}{options}{=\marg{graphics options}}{no default, initially empty} - The \meta{graphics options} are applied to the underlying |\includegraphics| command. + The \meta{graphics options} are applied to the underlying \docAuxCommand*{includegraphics} command. See the documentation of - |graphicx| \cite{carlisle:1999a} for a list of applicable \meta{graphics options}. -\begin{texexptitled}[listing only,before={\par\medskip}]% + |graphicx| \cite{carlisle:graphics} for a list of applicable \meta{graphics options}. +\begin{texexptitled}% {A resized image; see page~\pageref{exagraphresize}}{exagraphresize.listing} \igrset{options={width=10cm,height=10cm}, paper=graphics, overlay page number at top=5mm @@ -453,31 +355,116 @@ the package |graphicx| \cite{carlisle:1999a}. \begin{docIgrKey}{options add}{=\marg{graphics options}}{no default, initially empty} The \meta{graphics options} are added to the current list of options - for the underlying |\includegraphics| command. + for the underlying \docAuxCommand*{includegraphics} command. \end{docIgrKey} \begin{docIgrKey}{include command}{\colOpt{=\meta{macro}}}{default and initially \cs{includegraphics}} - Replaces the internally used \cs{includegraphics} command by the given \meta{macro}. - Note that \meta{macro} has to have the same signature as \cs{includegraphics}, + Replaces the internally used \docAuxCommand*{includegraphics} command by the given \meta{macro}. + Note that \meta{macro} has to have the same signature as \docAuxCommand*{includegraphics}, i.\,e.\ it has to take two arguments where the first argument is optional. \end{docIgrKey} \begin{docIgrKey}{existence check}{=\meta{macro}}{no default} - Replaces the internally used \cs{IfFileExists} command by the given \meta{macro}. - Note that \meta{macro} has to have the same signature as \cs{IfFileExists}, + Replaces the internally used \docAuxCommand*{IfFileExists} + (in truth \docAuxCommand*{file_if_exist:nTF}) + command by the given \meta{macro}. + Note that \meta{macro} has to have the same signature as \docAuxCommand*{IfFileExists}, i.\,e.\ it has to take three arguments. \end{docIgrKey} -\begin{docIgrKey}{fail on not found}{}{no value} - Stops the compilation with an error if the included file does not exist. -\end{docIgrKey} +\begin{docIgrKeys}[ + doc parameter = {}, + doc description = {no value} + ] + { + { + doc name = no existence check, + doc new = 2021-10-16, + }, + { + doc name = fail on not found, + }, + } + Omits any existence checks by the package, i.e. the underlying + \docAuxCommand*{includegraphics} is called directly any may + stop the compilation with an error if the included file does not exist. + Both options are equal, but the newer \refKey{/igr/no existence check} + is considered to be more comprehensible. +\end{docIgrKeys} \begin{docIgrKey}{ignore on not found}{}{no value, initially set} - Not existing included files are ignored without warning. + Not existing included files are ignored without warning. This is the default + setting and is intended to be used with fragmentary file lists. +\end{docIgrKey} + +\clearpage + +\begin{docIgrKeys}[ + doc parameter = \colOpt{=\marg{extension list}}, + doc description = {initially unset}, + doc new = 2021-10-16, + ] + { + { + doc name = ignore on not found with extensions, + }, + { + doc name = ignore on not found with extensions*, + }, + } + Tests, if the included file with an added \emph{extension} exists and + performs the inclusion on existence. Otherwise, included files are ignored without warning. + Tested \emph{extensions} are taken from the optional comma separated \meta{extension list} + or (exclusively) from the configured list from \refKey{/igr/extensions} and friends + (only, if \meta{extension list} is not given).\par + \refKey{/igr/ignore on not found with extensions*} also tests, if the included + file without added \emph{extension} exists and takes it on existence.\par + Note that if a file is included with a given extension, this extension is not + replaced by the listed extension, but prolonged with it.\par + These options are intended for mixed file lists, e.g. |.jpg| and |.png|, or + unkown type file lists. + Note that if you \emph{know} the (singular) extension of your files, you are + encouraged to use \refKey{/igr/ignore on not found} instead for performance reasons. +\begin{dispListing} +\incmultigraph[ignore on not found with extensions={.jpg,.png}]{myfile\n}{1,...,100} + % includes e.g. `myfile1.jpg`, `myfile2.png`, `myfile42.jpg`, ... +\incmultigraph[ignore on not found with extensions={.jpg,.png}]{myfile\n.xy}{1,...,100} + % includes e.g. `myfile1.xy.jpg`, `myfile2.xy.png`, `myfile42.xy.jpg`, ... +\incgraph[ignore on not found with extensions={.jpg,.png}]{myfile} + % tests `myfile.jpg` and `myfile.png` for existence (and inclusion) +\incgraph[ignore on not found with extensions*={.jpg,.png}]{myfile} + % tests `myfile`, `myfile.jpg`, and `myfile.png` for existence (and inclusion) +\incmultigraph[ignore on not found with extensions]{myfile\n}{1,...,100} + % includes files with extensions given by /igr/extensions +\end{dispListing} +\end{docIgrKeys} + + +\begin{docIgrKey}[][doc new=2021-10-16]{extensions}{=\marg{extension list}}{initially |.jpg,.png|} + Specifies a comma separated \meta{extension list} to be used in combination with + \refKey{/igr/ignore on not found with extensions}. +\end{docIgrKey} + + +\begin{docIgrKey}[][doc new=2021-10-16]{extensions add}{=\marg{extension list}}{initially unset} + Adds a comma separated \meta{extension list} to an already defined list from + \refKey{/igr/extensions}. \end{docIgrKey} +\begin{docIgrKey}[][doc new=2021-10-16]{extensions from graphics}{}{initially unset} + Takes the list of extensions from \docAuxCommand*{DeclareGraphicsExtensions} + of the |graphics| \cite{carlisle:graphics} package as setup for \refKey{/igr/extensions}. + While this looks like the most comfortable options, this can significantely + increase compilation time when used for fragmentary file lists, because + every non-existing file from the file list will induce a lot of existence checks. + Also note that this options uses internals from |graphics| and is not + guaranteed to work with future versions of |graphics|. +\end{docIgrKey} + + +\clearpage \subsection{Hypertargets, Labels, and Bookmarks} \begin{docIgrKey}{hyper}{}{no value, initially set} @@ -515,8 +502,8 @@ see page~\pageref{exarotated.listing}. \begin{docIgrKey}{bookmark options}{=\marg{bookmark options}}{no default, initially empty} Sets the options for a bookmark. See the documentation of - |bookmark| \cite{oberdiek:2011a} for a list of applicable \meta{bookmark options}. -\begin{texexptitled}[listing only,before={\par\medskip}]% + |bookmark| \cite{oberdiek:bookmark} for a list of applicable \meta{bookmark options}. +\begin{texexptitled}% {Bookmark options; see page~\pageref{exabookmark}}{exabookmark.listing} % not every PDF reader will show the effect! \igrset{bookmark options={bold,color={red}},currentpaper} @@ -528,7 +515,7 @@ see page~\pageref{exarotated.listing}. \begin{docIgrKey}{bookmark heading}{=\meta{text}}{no default, initially empty} For \refCom{incmultigraph}, an additional bookmark with the given \meta{text} is set as a heading before the images are included. -\begin{texexptitled}[listing only,before={\par\medskip}]% +\begin{texexptitled}% {A series of pictures; see from page~\pageref{exaheading.1}}{exaheading.listing} \incmultigraph[zerofill=4,currentpaper, bookmark heading={A series of pictures}, @@ -542,7 +529,7 @@ see page~\pageref{exarotated.listing}. \begin{docIgrKey}{bookmark heading options}{=\marg{bookmark options}}{no default, initially empty} Sets the options for a \refKey{/igr/bookmark heading}. See the documentation of - |bookmark| \cite{oberdiek:2011a} for a list of applicable \meta{bookmark options}. + |bookmark| \cite{oberdiek:bookmark} for a list of applicable \meta{bookmark options}. \end{docIgrKey} \clearpage @@ -593,15 +580,15 @@ Adds a space of \meta{length} at all four sides. \refKey{/igr/if match set}, and \refKey{/igr/if match set bookmark}. -\begin{tcblisting}{docexample,listing only} +\begin{dispListing} \igrset{set matches={ foo = bar, 1 = A very red image, 37 = A not so centered number, 123 = A greenish example}} -\end{tcblisting} +\end{dispListing} \end{docIgrKey} -\tcbuselistingtext +\tcbusetemp \begin{docIgrKey}{if match code}{=\marg{key}\marg{then}\marg{else}}{no default} If the \meta{key} was defined by \refKey{/igr/set matches}, @@ -626,7 +613,7 @@ Adds a space of \meta{length} at all four sides. the corresponding value is put in the macro |\igrmatchvalue| and the current PDF bookmark is set to \meta{then}. If the \meta{key} is unknown, the current PDF bookmark is set to \meta{else}. -\begin{texexptitled}[listing only,before={\par\medskip}]% +\begin{texexptitled}% {Map and match example; see from page~\pageref{examatch.1}}{examatch.listing} \incmultigraph[zerofill=4,paper=graphics, bookmark heading={Map and match example}, @@ -651,12 +638,12 @@ Adds a space of \meta{length} at all four sides. \begin{docIgrKey}{overlay}{=\marg{tikz code}}{no default, initially unset} Introduces arbitrary \meta{tikz code} to be drawn over the included image. - Note that the |tikz| package \cite{tantau:2013a} has to be loaded separately. + Note that the \tikzname\ package \cite{tantau:tikz} has to be loaded separately. To support positioning inside the picture, two |tikz| nodes named |box| and |page| are defined. |box| takes the dimensions of the included image and |page| takes the dimensions of the image or of the page depending on the usage of \refKey{/igr/paper}. -\begin{texexptitled}[listing only,before={\par\medskip}]% +\begin{texexptitled}% {Overlay; see page~\pageref{overlay}}{overlay.listing} \igrset{bookmark options={level=subsection}, paper=current} \incgraph[bookmark={Picture with overlay},label={overlay}, @@ -694,11 +681,21 @@ Adds a space of \meta{length} at all four sides. and the result on page~\pageref{exagraphresize}. \end{docIgrKey} + +\begin{docIgrKey}[][doc new=2021-10-11]{overlay page number options}{=\marg{tikz options}}{no default, initially\\ + \texttt{fill opacity=0.35,draw opacity=0.5,text opacity=1,inner xsep=1em,\\ + rounded corners,fill=white,draw=black}} + Defines the \tikzname\ node style for drawing the page number with one + of the options above, e.g. \refKey{/igr/overlay page number at} +\end{docIgrKey} + + \begin{docIgrKey}{no overlay}{}{no value, initially set} Removes the overlay setting. \end{docIgrKey} +\clearpage \subsection{Miscellaneous} @@ -742,9 +739,12 @@ Here, the images |example.jpg|, All included images are automatically bookmarked with the page number and the file name of the source image. -\def\thecurrentexample{\jobname-example-a.tex} -\tcbinputlisting{listing file=\thecurrentexample,listing only, - example={\texttt{\thecurrentexample}}{somescans}} + +\inputexamplelisting{\jobname-example-a.tex}{somescans} + +%\def\thecurrentexample{\jobname-example-a.tex} +%\tcbinputlisting{listing file=\thecurrentexample,listing only, +% example={\texttt{\thecurrentexample}}{somescans}} The compiled result of this stand-alone source code is not found in this document but as a separate file in the documentation directory of the package. @@ -769,9 +769,12 @@ The example shows a mixed usage of the macros. Note that the bookmarks of the multi-page part are matched with the numbers contained in the file names of |exaimage-0001.png| to |exaimage-0150.png|. -\def\thecurrentexample{\jobname-example-b.tex} -\tcbinputlisting{listing file=\thecurrentexample,listing only, - example={\texttt{\thecurrentexample}}{picturebook}} + +\inputexamplelisting{\jobname-example-b.tex}{picturebook} + +%\def\thecurrentexample{\jobname-example-b.tex} +%\tcbinputlisting{listing file=\thecurrentexample,listing only, +% example={\texttt{\thecurrentexample}}{picturebook}} The compiled result of this stand-alone source code is not found in this document but as a separate file in the documentation directory of the package. @@ -780,7 +783,7 @@ a separate file in the documentation directory of the package. \clearpage \subsection{Reformatting from Letter to DIN A4 (and vice versa)} In this scenario, we assume to have a PDF document with the 'wrong' paper size. -Here, |incgraph-example-a.pdf| has the letter format, but DIN A4 paper +Here, |incgraph-example-a.pdf| has the letter format, but A4 paper is needed. |incgraph| is used to reformat to the desired paper size. Of course, it also works the other way around. @@ -793,9 +796,12 @@ shrunk or enlarged easily by adding a |scale| option for the underlying |\includegraphics| macro. -\def\thecurrentexample{\jobname-example-c.tex} -\tcbinputlisting{listing file=\thecurrentexample,listing only, - example={\texttt{\thecurrentexample}}{reformatting}} +\inputexamplelisting{\jobname-example-c.tex}{reformatting} + +%\def\thecurrentexample{\jobname-example-c.tex} +%\tcbinputlisting{listing file=\thecurrentexample,listing only, +% example={\texttt{\thecurrentexample}}{reformatting}} + The compiled result of this stand-alone source code is not found in this document but as a separate file in the documentation directory of the package. @@ -817,7 +823,7 @@ In Example \ref{fullpaperdrawing1}, a |tikzpicture| is drawn. The whole picture is put inside an \refEnv{inctext} environment which puts the drawing on a separate page which gets the dimensions of the drawing. -\begin{texexptitled}[listing only]{Creation of a special text page (resized)}{fullpaperdrawing1} +\begin{texexptitled}{Creation of a special text page (resized)}{fullpaperdrawing1} \begin{inctext}[paper=graphics, bookmark=My special text page (resized)] \begin{tikzpicture}% \coordinate (A) at (0,0); \coordinate (B) at (16,16); @@ -848,7 +854,7 @@ To draw seamlessly, the document paper size of 21cm to 29.7cm is used directly inside the |tikzpicture|. -\begin{texexptitled}[listing only]{Creation of a special text page (fitted)}{fullpaperdrawing2} +\begin{texexptitled}{Creation of a special text page (fitted)}{fullpaperdrawing2} \begin{inctext}[paper=current, target=mytarget, bookmark=My special text page (fitted)] \begin{tikzpicture}% @@ -885,6 +891,59 @@ It is assumed that most users will only need the macros from the user interface described in Section \ref{sec:interface} and Section \ref{sec:keys}. +\subsection{Page Size Commands} + +The following macros are auxiliary tools which wrap corresponding length registers +from |pdflatex| and |lualatex|. + +\begin{docCommand}[doc new=2021-10-12]{igrGetPageSize}{} + Reads the current page dimensions and stores them into the macros + \refCom{igrPageWidth} and \refCom{igrPageHeight}. +\end{docCommand} + +\begin{docCommand}[doc new=2021-10-12]{igrPageWidth}{} + After using \refCom{igrGetPageSize}, \refCom{igrPageWidth} contains + the current page width. This is |\pdfpagewidth| for |pdflatex|, + |\pagewidth| for |lualatex| and a choice of |\pdfpagewidth| or |\paperwidth| + for other engines. +\end{docCommand} + +\begin{docCommand}[doc new=2021-10-12]{igrPageHeight}{} + After using \refCom{igrGetPageSize}, \refCom{igrPageHeight} contains + the current page height. This is |\pdfpageheight| for |pdflatex|, + |\pageheight| for |lualatex| and a choice of |\pdfpageheight| or |\paperheight| + for other engines. +\end{docCommand} + + +\begin{docCommand}[doc new=2021-10-12]{igrSetPageSize}{\marg{width}\marg{height}} + Sets the current page dimensions to \meta{width} and \meta{height}. + In depends on the used engine, if a call to this command has success or + not. This should work for |pdflatex| and |lualatex|. +\end{docCommand} + + +\subsection{Last Page Commands (Number of Pages)} + +The following macros are auxiliary tools which wrap corresponding functions +from |pdflatex| and |lualatex|. + +\begin{docCommand}[doc new=2021-10-18]{igrGetLastPage}{\marg{file}} + Reads the last page (page count) from the given (PDF-)\meta{file} + and stores it into the macro \refCom{igrLastPage}. +\end{docCommand} + + +\begin{docCommand}[doc new=2021-10-18]{igrLastPage}{} + After using \refCom{igrGetLastPage}, \refCom{igrLastPage} contains + the last page of the currently tested file. + This is |\pdflastximagepages| for |pdflatex|, + |\lastsavedimageresourcepages| for |lualatex| and simply $1$ + for other engines. +\end{docCommand} + + +\clearpage \subsection{Full Page Commands} \begin{docCommand}{igrpage}{\marg{text}} @@ -967,7 +1026,7 @@ user interface described in Section \ref{sec:interface} and Section \ref{sec:key \clearpage \begin{docCommand}{igrboxtikz}{} The current content of the |\igrbox| is embedded into a |\node| command - from the |tikz| package \cite{tantau:2013a} which has to be loaded separately. + from the |tikz| package \cite{tantau:tikz} which has to be loaded separately. Also, the bounding box is adjusted to the |\igrbox|.\\ To support positioning inside the picture, two |tikz| nodes named |box| and |page| are defined which both take the dimensions of the |\igrbox|. @@ -1002,7 +1061,7 @@ The boxing macros can also be used nested (see the result on the following page) \begin{docCommand}{igrboxtikzcenter}{} The current content of the |\igrbox| is embedded into a |\node| command - from the |tikz| package \cite{tantau:2013a} which has to be loaded separately. + from the |tikz| package \cite{tantau:tikz} which has to be loaded separately. This node is placed in the center of a bounding box which takes the current page dimensions. Afterwards, |\igrBoxWidth| and |\igrBoxHeight| are redefined to the dimensions of the total page.\\ @@ -1037,7 +1096,7 @@ See the result on the following page. \igrsetmatchvalue{my key A}{my value A} \def\keytester#1{\igrifmatch{#1}{Hurray: '\igrmatchvalue'}{'#1' unknown}} -\keytester{foo}\\ +\keytester{something}\\ \keytester{my key A} \end{dispExample} \end{docCommand} @@ -1050,7 +1109,7 @@ See the result on the following page. \igrsetmatches{my key A = my value A, bar = Shakespeare} \def\keytester#1{\igrifmatch{#1}{Hurray: '\igrmatchvalue'}{'#1' unknown}} -\keytester{foo}\\ +\keytester{something}\\ \keytester{bar}\\ \keytester{my key A} \end{dispExample} @@ -1117,33 +1176,33 @@ See the result on the following page. % Do not follow this bad example ... \begin{tcbverbatimwrite}{\jobname.bib} -@manual{tantau:2013a, +@manual{tantau:tikz, author = {Till Tantau}, title = {The TikZ and PGF Packages}, - subtitle = {Manual for version 3.0.0}, - url = {http://sourceforge.net/projects/pgf/}, - date = {2013-12-20}, + subtitle = {Manual for version 3.1.9a}, + url = {https://mirrors.ctan.org/graphics/pgf/base/doc/pgfmanual.pdf}, + date = {2021-05-15}, } -@manual{carlisle:1999a, - author = {D. P. Carlisle and S. P. Q. Rahtz}, - title = {The graphicx package}, - url = {http://mirror.ctan.org/macros/latex/required/graphics/}, - date = {1999-02-16}, +@manual{carlisle:graphics, + author = {D. P. Carlisle}, + title = {Packages in the ‘graphics’ bundle}, + url = {https://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf}, + date = {2021-03-05}, } -@manual{matthias:2012a, +@manual{matthias:pdfpages, author = {Andreas Matthias}, title = {The pdfpages Package}, - url = {http://mirror.ctan.org/macros/latex/contrib/pdfpages/pdfpages.pdf}, - date = {2012-04-03}, + url = {https://mirrors.ctan.org/macros/latex/contrib/pdfpages/pdfpages.pdf}, + date = {2021-03-06}, } -@manual{oberdiek:2011a, +@manual{oberdiek:bookmark, author = {Heiko Oberdiek}, title = {The bookmark Package}, - url = {http://mirror.ctan.org/macros/latex/contrib/oberdiek/bookmark.pdf}, - date = {2011-12-02}, + url = {https://mirrors.ctan.org/macros/latex/contrib/bookmark/bookmark.pdf}, + date = {2020-11-06}, } \end{tcbverbatimwrite} -- cgit v1.2.3