summaryrefslogtreecommitdiff
path: root/doc/context/sources/general/manuals/start/en/ma-cb-en-usersetups.tex
blob: 1d63688fb1abb21cb6bd654ea77388514306b6ca (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
\startcomponent ma-cb-en-usersetups

\enablemode[**en-us]

\project ma-cb

\startchapter[title=User specifications]

\index{preamble}
\index{input file}

The setup area of your document is the area before
the \type{\starttext} command. For example:

\setuptyping
    [escape=yes]

\definestartstop
    [comment][style={\rm}]

\starttyping
                                   /BTEX \comment{first line of your file} /ETEX
\setuplayout[width=25cm]           /BTEX \comment{set the width of your text} /ETEX
                                   /BTEX \comment{empty line for readability} /ETEX
\starttext                         /BTEX \comment{starts your text} /ETEX
Hello Hasselt.                     /BTEX \comment{your text} /ETEX
\stoptext                          /BTEX \comment{ends your text} /ETEX
\stoptyping

Note that the first line of this file is empty. However, this first line
is a preamble and can be used for specific user specifications. For example:

\starttyping
% engine=luatex                    /BTEX \comment{use the \type{luatex} engine} /ETEX
                                   /BTEX \comment{empty line for readability} /ETEX
\setuplayout[width=25cm]           /BTEX \comment{set the width of your text} /ETEX
                                   /BTEX \comment{empty line for readability} /ETEX
\starttext                         /BTEX \comment{starts your text} /ETEX
Hello Hasselt.                     /BTEX \comment{your text} /ETEX
\stoptext                          /BTEX \comment{ends your text} /ETEX
\stoptyping

Note that \CONTEXT\ sees the text after the \type{ % }
sign in this first line not as a comment.

The preamble can have a meaning for both \CONTEXT\ and \SCITE:

\starttyping
% engine=pdftex interface=en modes=screen language=us

\starttext
Hello Hasselt.
\stoptext
\stoptyping

This will be interpreted as:

\starttabulate[|T||p|]
\NC engine=pdftex \NC \CONTEXT \EQ run as \PDFTEX \NC\NR
\NC interface=en  \NC \CONTEXT \EQ expect english \CONTEXT\ commands (lexing) \NC\NR
\NC               \NC \SCITE   \EQ use english lexing \NC\NR
\NC modes=screen  \NC \CONTEXT \EQ invoke mode \type{screen} that is set in the text \NC\NR
\NC language=uk   \NC \SCITE   \EQ use the english spell checker \NC\NR
\stoptabulate

\stopchapter

\stopcomponent