summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/context/sources/general/manuals/start/en/ma-cb-en-usersetups.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/context/sources/general/manuals/start/en/ma-cb-en-usersetups.tex')
-rw-r--r--Master/texmf-dist/doc/context/sources/general/manuals/start/en/ma-cb-en-usersetups.tex68
1 files changed, 68 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/context/sources/general/manuals/start/en/ma-cb-en-usersetups.tex b/Master/texmf-dist/doc/context/sources/general/manuals/start/en/ma-cb-en-usersetups.tex
new file mode 100644
index 00000000000..2d89e937a46
--- /dev/null
+++ b/Master/texmf-dist/doc/context/sources/general/manuals/start/en/ma-cb-en-usersetups.tex
@@ -0,0 +1,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=uk
+
+\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