summaryrefslogtreecommitdiff
path: root/Master/texmf-dist
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-04-26 19:41:30 +0000
committerKarl Berry <karl@freefriends.org>2023-04-26 19:41:30 +0000
commit2df5be7518778a44a40349e286690a3d278d1ff7 (patch)
tree01874200bc782da3c234299001b9e377ae3abbe5 /Master/texmf-dist
parent62bac7bb7d52d91532e93307f692f0e6167a7465 (diff)
context-collatingmarks (26apr23)
git-svn-id: svn://tug.org/texlive/trunk@66948 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r--Master/texmf-dist/doc/context/third/collating-marks/LICENSE1
-rw-r--r--Master/texmf-dist/doc/context/third/collating-marks/README.md17
-rw-r--r--Master/texmf-dist/doc/context/third/collating-marks/VERSION1
-rw-r--r--Master/texmf-dist/doc/context/third/collating-marks/t-collatingmarks-module-doc.pdfbin0 -> 140294 bytes
-rw-r--r--Master/texmf-dist/doc/context/third/collating-marks/t-collatingmarks-module-doc.tex3
-rw-r--r--Master/texmf-dist/tex/context/third/collating-marks/t-collatingmarks.mkiv174
6 files changed, 196 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/context/third/collating-marks/LICENSE b/Master/texmf-dist/doc/context/third/collating-marks/LICENSE
new file mode 100644
index 00000000000..a7a158b93c3
--- /dev/null
+++ b/Master/texmf-dist/doc/context/third/collating-marks/LICENSE
@@ -0,0 +1 @@
+Public Domain \ No newline at end of file
diff --git a/Master/texmf-dist/doc/context/third/collating-marks/README.md b/Master/texmf-dist/doc/context/third/collating-marks/README.md
new file mode 100644
index 00000000000..bbdd0eff822
--- /dev/null
+++ b/Master/texmf-dist/doc/context/third/collating-marks/README.md
@@ -0,0 +1,17 @@
+# Module: Collating Marks
+
+## Editorial
+
+Author = W. Egger
+Version = 2023.04.15
+License = Public Domain
+
+## Introduction
+
+Collating marks are small black rules placed on the spine of printed sections. On each section the mark is moved by the length of the black rule. When the book is assembled on the spine appears a stair like pattern. Continuity of this pattern insures that the book is ordered in the correct sequence of sections.
+
+## Description
+
+The module is used in connection with arranging pages for folding to form sections.
+
+Depending on the arranging scheme used the module must be set up accordingly in the set of MetaPost variables. \ No newline at end of file
diff --git a/Master/texmf-dist/doc/context/third/collating-marks/VERSION b/Master/texmf-dist/doc/context/third/collating-marks/VERSION
new file mode 100644
index 00000000000..4689b28be54
--- /dev/null
+++ b/Master/texmf-dist/doc/context/third/collating-marks/VERSION
@@ -0,0 +1 @@
+2023.04.25
diff --git a/Master/texmf-dist/doc/context/third/collating-marks/t-collatingmarks-module-doc.pdf b/Master/texmf-dist/doc/context/third/collating-marks/t-collatingmarks-module-doc.pdf
new file mode 100644
index 00000000000..52bf0eed688
--- /dev/null
+++ b/Master/texmf-dist/doc/context/third/collating-marks/t-collatingmarks-module-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/context/third/collating-marks/t-collatingmarks-module-doc.tex b/Master/texmf-dist/doc/context/third/collating-marks/t-collatingmarks-module-doc.tex
new file mode 100644
index 00000000000..ab3abb9aa34
--- /dev/null
+++ b/Master/texmf-dist/doc/context/third/collating-marks/t-collatingmarks-module-doc.tex
@@ -0,0 +1,3 @@
+The documentation of this module can be created from the source-file by running:
+
+mtxrun --script modules --process t-collatingmarks.tex \ No newline at end of file
diff --git a/Master/texmf-dist/tex/context/third/collating-marks/t-collatingmarks.mkiv b/Master/texmf-dist/tex/context/third/collating-marks/t-collatingmarks.mkiv
new file mode 100644
index 00000000000..c0f13da3d0a
--- /dev/null
+++ b/Master/texmf-dist/tex/context/third/collating-marks/t-collatingmarks.mkiv
@@ -0,0 +1,174 @@
+%D \module
+%D [ file=t-collatingmarks,
+%D version=2023.04.15,
+%D title=Collating Marks \CONTEXT\ User Module,
+%D subtitle=Environment for collating marks,
+%D author={W. Egger},
+%D date=\currentdate,
+%D copyright={W. Egger},
+%D email=w.egger@boede.nl,
+%D license=Public Domain]
+%D
+%D The documentation can be generated with:
+%D mtxrun --script modules --process t-collatingmarks.tex
+
+\startmodule[collatingmarks]
+
+\writestatus{loading}{Context Module for Collating Marks}
+
+%D\enablemode[demo]
+
+%D \startsubject[title={Introduction}]
+%D
+%D This code is based on the work of Thomas A. Schmitz, who created the module for
+%D different crop marks.
+%D
+%D If a book consists of multiple sections, each section should be marked
+%D along the spine with a collating mark. This mark moves down along the spine
+%D according to the number of the section. After collating the book it becomes
+%D easy tho check whether the sequence of the sections is correct. One should
+%D see a \quotation{stair case} on the spine of the book.
+%D \stopsubject
+%D
+%D \startsubject[title={Using the module}]
+%D
+%D If the collating marks should be placed, then the system should be setup with
+%D \type{\setupMPvariables[pages=8,sheets=2,shift=0mm,frenchdoors=false,wickel=false]} Note that the
+%D collating marks-setup needs to know how many pages are placed on a
+%D doublesided printed sheet of paper and how many such sheets result in a
+%D section i.e. these values depend on the \type{\setuparranging} command. The
+%D shift-option is 0mm if no horizontal page shifting is issued during
+%D imposition. If a horizontal page shifting is used, then the shift option is
+%D used to position the collating mark precisely on the spine.
+%D
+%D The two keys \quotation{frenchdoors} and \quotation{wickel} are used for
+%D special purposes. These are not intended for general use.
+%D For the preparation of a binding called
+%D French doors, where there is a left (normal) and a right book, which opens
+%D from left to right the MPvariable \quotation{frenchdoors} must be set to true
+%D (boolean).
+%D For preparing a section with parallelfolding/letterfolding/Wickelfalz the
+%D MPvariable \quotation{wickel} must be set to true (boolean).
+%D\stopsubject
+
+%D \startsubject[title={Vocabulary}]
+%D
+%D EN: Collating mark, DE: Kollationiermarke, NL: collationeerblokje
+%D \stopsubject
+
+
+\unprotect
+
+\setupmodule[Collatingmarks=yes]
+
+\setupMPvariables
+ [Collatingmarks]
+ [pages=16, %pages per sheet doublesided
+ sheets=1,% number of sheets forming one section
+ horpageshift=0,
+ frenchdoors=false,
+ wickel=false]
+
+%D We prepare collating marks:
+
+\processaction[\currentmoduleparameter{Collatingmarks}]
+ [yes=>\def\Collatingmarks{Collatingmarks},
+ no=>\def\Collatingmarks{},
+ \v!unknown=>\def\Collatingmarks{},
+ \v!default=>\def\Collatingmarks{}]
+
+%D The newly prepared macros go into the page background:
+
+\setupbackgrounds[page][state=repeat,background={\Collatingmarks}]
+
+%D We define an overlay for the collating marks.
+
+\defineoverlay[Collatingmarks][\useMPgraphic{Collatingmarks}]
+
+%D We let \METAPOST do the calculations and draw de collating marks.
+
+\startusableMPgraphic{Collatingmarks}
+StartPage;
+
+numeric offset, sectionno, pages, sheets, factor, correction, offset, pageshift;
+path p,q;
+boolean frenchdoors,wickel;
+
+pages := \MPvar{pages};
+sheets := \MPvar{sheets};
+pageshift := \MPvar{horpageshift};
+frenchdoors := \MPvar{frenchdoors};
+wickel := \MPvar{wickel};
+
+z5colm = ulcorner Page;
+z6colm = (x5colm, y5colm-10mm);
+
+p := unitsquare xscaled 1mm yscaled 7mm;
+
+if \realpagenumber mod 2 = 1 : % on uneven pages only
+ sectionno := \realpagenumber div (sheets*pages)+1;
+ label.lrt(textext("\switchtobodyfont[5pt]"& decimal sectionno &""),llcorner Page shifted (1mm,-2mm));
+ if \realpagenumber mod (sheets*pages) = 1 : % on the first page of a section only
+ nofmarkings := (y6colm-7mm) div 7mm;
+ offset := y6colm-sectionno*7mm;
+ if sectionno > nofmarkings :
+ correction := sectionno div nofmarkings;
+ offset := y6colm-(sectionno-correction*nofmarkings)*7mm;
+ fi;
+ if frenchdoors or wickel :
+ p := p shifted ((PaperWidth),offset);
+ else :
+ p := p shifted (-1mm-2pageshift,offset);
+ fi;
+ fill p withcolor black;
+ if sectionno < 9 :
+ label.rt(textext("\switchtobodyfont[3pt] \white "& decimal sectionno &""), center p shifted (-1.3mm,0));
+ else :
+ label.rt(textext("\switchtobodyfont[3pt] \white "& decimal sectionno &""), center p shifted (-1.5mm,0));
+ fi;
+ fi;
+fi;
+\stopusableMPgraphic
+
+\protect
+\stopmodule
+
+\doifnotmode{demo}{\endinput}
+
+
+
+%D Example:
+%D \usemodule[collatingmarks][Collatingmarks=yes]
+%D \setuppapersize[A5][A2]
+%D \setuplayout[location=middle,marking=on]
+%D \setuppagenumbering[alternative=doublesided]
+%D \setuparranging[2*4]
+%D
+%D \setupMPvariables
+%D [pages=8, % pages per sheet of paper doublesided
+%D sheets=1, % sheets of paper used per section
+%D horpageshift=0mm, % used for correction if horizontal page-shifting is used
+%D frenchdoors=false,
+%D wickel=false]
+%D
+%D \starttext
+%D \dorecurse{10}{\section{Text \recurselevel}\input tufte \par\subject{Ward} \input ward\par}
+%D \stoptext
+
+
+\usemodule[collatingmarks][Collatingmarks=yes]
+\setuppapersize[A5][A2]
+\setuplayout[location=middle,marking=on]
+\setuppagenumbering[alternative=doublesided]
+\setuparranging[2*4*2]
+
+\setupMPvariables
+ [pages=8, % pages per sheet of paper doublesided
+ sheets=2, % sheets of paper used per section
+ horpageshift=0mm, % used for correction if horizontal page-shifting is used
+ frenchdoors=false,
+ wickel=false]
+
+\starttext
+ \dorecurse{10}{\section{Text \recurselevel}\input tufte \par\subject{Ward} \input ward\par}
+\stoptext