summaryrefslogtreecommitdiff
path: root/macros/context/contrib
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-04-28 03:01:37 +0000
committerNorbert Preining <norbert@preining.info>2023-04-28 03:01:37 +0000
commitecdd3beb4fb3bcd9ea2f1c6349a68f74a40f1679 (patch)
treef9f048d640b29aaf501c9db5491a351fa48fb2fd /macros/context/contrib
parente947b2310e888cd5b10265d596eb332da9f6bdec (diff)
CTAN sync 202304280301
Diffstat (limited to 'macros/context/contrib')
-rw-r--r--macros/context/contrib/context-collating-marks/LICENSE1
-rw-r--r--macros/context/contrib/context-collating-marks/README.md17
-rw-r--r--macros/context/contrib/context-collating-marks/VERSION1
-rw-r--r--macros/context/contrib/context-collating-marks/doc/context/third/collating-marks/README.md46
-rw-r--r--macros/context/contrib/context-collating-marks/doc/context/third/collating-marks/t-collatingmarks-module-doc.pdfbin0 -> 140294 bytes
-rw-r--r--macros/context/contrib/context-collating-marks/doc/context/third/collating-marks/t-collatingmarks-module-doc.tex3
-rw-r--r--macros/context/contrib/context-collating-marks/tex/context/third/collating-marks/t-collatingmarks.mkiv174
7 files changed, 242 insertions, 0 deletions
diff --git a/macros/context/contrib/context-collating-marks/LICENSE b/macros/context/contrib/context-collating-marks/LICENSE
new file mode 100644
index 0000000000..a7a158b93c
--- /dev/null
+++ b/macros/context/contrib/context-collating-marks/LICENSE
@@ -0,0 +1 @@
+Public Domain \ No newline at end of file
diff --git a/macros/context/contrib/context-collating-marks/README.md b/macros/context/contrib/context-collating-marks/README.md
new file mode 100644
index 0000000000..bbdd0eff82
--- /dev/null
+++ b/macros/context/contrib/context-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/macros/context/contrib/context-collating-marks/VERSION b/macros/context/contrib/context-collating-marks/VERSION
new file mode 100644
index 0000000000..a327302c23
--- /dev/null
+++ b/macros/context/contrib/context-collating-marks/VERSION
@@ -0,0 +1 @@
+2023.04.26
diff --git a/macros/context/contrib/context-collating-marks/doc/context/third/collating-marks/README.md b/macros/context/contrib/context-collating-marks/doc/context/third/collating-marks/README.md
new file mode 100644
index 0000000000..b953b7761f
--- /dev/null
+++ b/macros/context/contrib/context-collating-marks/doc/context/third/collating-marks/README.md
@@ -0,0 +1,46 @@
+# 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.
+
+## Usage
+
+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.
+
+### Example:
+
+Example setup for the collating marks:
+
+\usemodule[collatingmarks][Collatingmarks=yes]
+
+\setupMPvariables
+ [pages=8, % pages per sheet of paper doublesided
+ sheets=2, % sheets of paper used per section
+ horpageshift=0.5mm, % used for correction if horizontal page-shifting is used
+ frenchdoors=false,
+ wickel=false]
+
+This setup is used for the arranging scheme \setuparranging[2*4*2] which indicates that it is double-sided printed with 4 pages recto and verso and there are two sheets of paper forming together the sections containing 16 pages.
+
+The shift parameter is used to adjust the position of the collating mark centered on the spine. This is specially important when a horizontal shift-list is used for arranging!
+
+Example setup for horizontal page shifting:
+
+\definepageshift
+ [hor]
+ [horizontal]
+ [1mm,-1mm,.75mm,-.75mm,.5mm,-.5mm,.25mm,0mm,
+ 0mm,-.25mm,.5mm,-.5mm,.75mm,-.75mm,1mm,-1mm]
+
+\setuppageshift[paper][hor] %paper= arrange only, horizontal only
+
+\setuparranging[2*4*2]
diff --git a/macros/context/contrib/context-collating-marks/doc/context/third/collating-marks/t-collatingmarks-module-doc.pdf b/macros/context/contrib/context-collating-marks/doc/context/third/collating-marks/t-collatingmarks-module-doc.pdf
new file mode 100644
index 0000000000..52bf0eed68
--- /dev/null
+++ b/macros/context/contrib/context-collating-marks/doc/context/third/collating-marks/t-collatingmarks-module-doc.pdf
Binary files differ
diff --git a/macros/context/contrib/context-collating-marks/doc/context/third/collating-marks/t-collatingmarks-module-doc.tex b/macros/context/contrib/context-collating-marks/doc/context/third/collating-marks/t-collatingmarks-module-doc.tex
new file mode 100644
index 0000000000..ab3abb9aa3
--- /dev/null
+++ b/macros/context/contrib/context-collating-marks/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/macros/context/contrib/context-collating-marks/tex/context/third/collating-marks/t-collatingmarks.mkiv b/macros/context/contrib/context-collating-marks/tex/context/third/collating-marks/t-collatingmarks.mkiv
new file mode 100644
index 0000000000..c0f13da3d0
--- /dev/null
+++ b/macros/context/contrib/context-collating-marks/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