context-collatingmarks (26apr23)

git-svn-id: svn://tug.org/texlive/trunk@66948 c570f23f-e606-0410-a88d-b1316a301751

10 files changed, 208 insertions, 4 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
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
diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check
index 2ab8c63a52c..7a56f1ea57f 100755
--- a/Master/tlpkg/bin/tlpkg-ctan-check
+++ b/Master/tlpkg/bin/tlpkg-ctan-check
@@ -209,6 +209,7 @@ my @TLP_working = qw(
     context-account context-algorithmic context-animation context-annotation
     context-bnf
     context-calendar-examples context-chromato context-cmscbf context-cmttbf
+    context-collating-marks
     context-construction-plan context-cyrillicnumbers
     context-degrade context-fancybreak context-filter
     context-french context-fullpage
diff --git a/Master/tlpkg/libexec/ctan2tds b/Master/tlpkg/libexec/ctan2tds
index 273e75c1496..885c63ecc81 100755
--- a/Master/tlpkg/libexec/ctan2tds
+++ b/Master/tlpkg/libexec/ctan2tds
@@ -341,13 +341,13 @@ chomp (my $ctan_root = `tlpkginfo --ctan-root`);
  'context-animation',   "&MAKEcopy",
  'context-annotation',  "&MAKEcopy",
  'context-bnf',         "&MAKEcopy",
- 'context-calendar-examples', "&MAKEcopy",
+ 'context-calendar-examples',	"&MAKEcopy",
  'context-chromato',    "&MAKEcopy",
  'context-cmscbf',	"&MAKEcopy",
  'context-cmttbf',	"&MAKEcopy",
- 'context-collatingmarks', "die 'skipping, generic filename'",
- 'context-construction-plan',"&MAKEcopy",
- 'context-cyrillicnumbers',  "&MAKEcopy",
+ 'context-collating-marks',	"&MAKEcopy",
+ 'context-construction-plan',	"&MAKEcopy",
+ 'context-cyrillicnumbers',	"&MAKEcopy",
  'context-degrade',     "&MAKEcopy",
  'context-fancybreak',	"&MAKEcopy",
  'context-filter',      "&MAKEcopy",
@@ -4188,6 +4188,9 @@ sub MAKEcopy {
   # for arev et al., remove symlinks.
   &SYSTEM ("find $dest -type l | xargs --no-run-if-empty rm");
 
+  # remove __MACOSX (and report to CTAN).
+  &SYSTEM ("find $dest -name __MACOSX | xargs --no-run-if-empty rm -rf");
+
   # ditto assorted other for lm (files are in doc subtree already).  
   -r "$dest/MANIFEST.txt"
   && &SYSTEM ("cd $dest && $RM GUST*.txt MANIFEST.txt README.eng");
diff --git a/Master/tlpkg/tlpsrc/collection-context.tlpsrc b/Master/tlpkg/tlpsrc/collection-context.tlpsrc
index 66bb0aecc8a..64501b2fab2 100644
--- a/Master/tlpkg/tlpsrc/collection-context.tlpsrc
+++ b/Master/tlpkg/tlpsrc/collection-context.tlpsrc
@@ -18,6 +18,7 @@ depend context-calendar-examples
 depend context-chromato
 depend context-cmscbf
 depend context-cmttbf
+depend context-collating-marks
 depend context-construction-plan
 depend context-cyrillicnumbers
 depend context-degrade
diff --git a/Master/tlpkg/tlpsrc/context-collating-marks.tlpsrc b/Master/tlpkg/tlpsrc/context-collating-marks.tlpsrc
new file mode 100644
index 00000000000..716cc4461ba
--- /dev/null
+++ b/Master/tlpkg/tlpsrc/context-collating-marks.tlpsrc
@@ -0,0 +1,3 @@
+category ConTeXt
+depend context
+catalogue context-collatingmarks