summaryrefslogtreecommitdiff
path: root/tex/context/base/strc-prc.mkiv
blob: 2955a396b5a042916be8f1d7ce617e2622ba2959 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
%D \module
%D   [       file=strc-prc,
%D        version=2008.10.20,
%D          title=\CONTEXT\ Structure Macros,
%D       subtitle=Processors,
%D         author=Hans Hagen,
%D           date=\currentdate,
%D      copyright=PRAGMA-ADE / Hans Hagen]
%C
%C This module is part of the \CONTEXT\ macro||package and is
%C therefore copyrighted by \PRAGMA. See mreadme.pdf for
%C details.

\writestatus{loading}{ConTeXt Structure Macros / Processors}

\registerctxluafile{strc-prc}{1.001}

\unprotect

%D Processors are used when we cannot easily associate typesetting directives
%D with (for instance) structural elements. Instead of ending up with numerous
%D additional definitions we can group treatments in so called processors.
%D
%D An example of where processors can be used is in separator sets (these are
%D related to typesetting numbers using structure).
%D
%D \starttyping
%D \defineprocessor[demo][style=\bfb,color=red]
%D \stoptyping
%D
%D This defines a processor named \type {demo}. Such a name ends up as prefix in
%D for instance:
%D
%D \starttyping
%D \definestructureseparatorset [demosep] [demo->!,demo->?,demo->!,demo->?] [demo->@]
%D \stoptyping
%D
%D Here the \type {!} and \type {?} are just the seperator characters that end
%D up between part, chapter, section, etc.\ numbers. The third argument defines the
%D default. When a separator is inserted, the \type{demo} processor will be applied.
%D Here the number will be separated by red slightly bigger than normal bold
%D exclamation marks and questionmarks
%D
%D Valid keys for defining a processor are \type {style}, \type {color}, \type {left},
%D \type {right}, and \type {command} (the given command takes one argument).

\unexpanded\def\defineprocessor
  {\dodoubleargument\dodefineprocessor}

\def\dodefineprocessor[#1][#2]%
  {\ifsecondargument
     \letbeundefined{\??po#1\c!command}%
     \ctxlua{structure.processors.register("#1")}%
     \getparameters[\??po#1][\c!style=,\c!color=,\c!left=,\c!right=,#2]%
   \else
     \letbeundefined{\??po#1\c!style}%
     \ctxlua{structure.processors.reset("#1")}%
   \fi}

%D The following command can be used by users but normally it will be
%D invoked behind the screens. After all, processor prefixes need to
%D be split off first.

\unexpanded\def\applyprocessor#1%
  {\ifcsname\??po#1\c!style\endcsname
     \expandafter\dodoapplyprocessor
   \else
     \expandafter\secondoftwoarguments
   \fi{#1}}

\def\dodoapplyprocessor#1#2%
  {\begingroup
   \dostartattributes{\??po#1}\c!style\c!color
   \csname\??po#1\c!left\endcsname
   \ifcsname\??po#1\c!command\endcsname
     \csname\??po#1\c!command\endcsname{#2}%
   \else
     #2%
   \fi
   \csname\??po#1\c!right\endcsname
   \dostopattributes
   \endgroup}

\protect \endinput