ma-cb-en-whatever.tex /size: 22 Kb    last modification: 2020-07-01 14:35
1\startcomponent ma-cb-en-whatever
2
3\enablemode[**en-us]
4
5\project ma-cb
6
7\startchapter[title=Miscellaneous]
8
9\startsection[title=A titlepage]
10
11\index{titlepage}
12
13\Command{\tex{startstandardmakeup}}
14\Command{\tex{definemakeup}}
15\Command{\tex{setupmakeup}}
16
17In the first example of this manual on \at{page}[inputfile] we used the command:
18
19\shortsetup{startnamemakeup}
20%\shortsetup{start<<name>>makeup} % does not work
21
22This command can be used to define titlepages. Such a command is needed since
23title pages often have a different layout than that of the bodytext. With the
24command pair \type{\start ... \stopstandardmakeup} you can make up a page within
25the default page dimensions.
26
27A simple titlepage may look like this:
28
29\startbuffer
30\startstandardmakeup
31\blank
32\rightaligned{\tfd Hasselt in the 21st century}
33\blank
34\rightaligned{\tfb The future}
35\vfill
36\rightaligned{\tfa C. van Marle}
37\rightaligned{Hasselt, 2013}
38\stopstandardmakeup
39\stopbuffer
40
41\typebuffer
42
43In a doublesided document you have to go through some additional actions to
44typeset the back of the titlepage.
45
46\startbuffer
47\startstandardmakeup[doublesided=no]
48\blank
49\rightaligned{\tfd Hasselt in the 21st century}
50\blank
51\rightaligned{\tfb The future}
52\vfill
53\rightaligned{\tfa C. van Marle}
54\rightaligned{Hasselt, \currentdate[year]}
55\stopstandardmakeup
56\startstandardmakeup[page=no]
57\vfill
58\copyright \currentdate[year]
59
60This book is dedicated to the people living in Hasselt. We
61want to thank photographer J. Jonker for manipulating the
62photos in this book in such a way that readers can get a
63clear picture of Hasselt's future look.
64\stopstandardmakeup
65\stopbuffer
66
67\typebuffer
68
69Your own make ups can be made and set up with:
70
71\shortsetup{definemakeup}
72
73and
74
75\shortsetup{setupmakeup}
76
77Please refer to the \goto {\CONTEXTWIKI} [ url (http://wiki.contextgarden.net/Command/setupmakeup) ]
78for more information on the \type{\start...\stopmakeup} command.
79
80\stopsection
81
82\startsection[reference=overlays,title=Overlays]
83
84\index{overlay}
85
86The overlay mechanism gives you the opportunity to add a specific layout
87to a text component. When there is a background option in a \CONTEXT\ command
88you can use overlays.
89
90\startbuffer
91\defineoverlay
92    [verticalbar]
93    [{\blackrule[height=2cm,width=.5cm,color=red]}]
94
95\defineoverlay
96    [horizontalbar]
97    [{\blackrule[height=.5cm,width=12cm,color=red]}]
98
99\framed
100  [width=12cm,
101   height=6cm,
102   background={color,foreground,verticalbar,horizontalbar},
103   offset=overlay,
104   backgroundcolor=blue,
105   frame=off]
106  {\blackrule[width=12cm,height=2cm,color=white]}
107\stopbuffer
108
109The flag of Hasselt could be defined with framed and a number of overlays:
110
111\typebuffer
112
113This will become:
114
115\startlinecorrection
116\getbuffer
117\stoplinecorrection
118
119The pagenumber in this manual has a background with an overlay where the
120\type{\MPclipFive} command takes care of drawing the image with \METAPOST.
121
122\startbuffer
123\defineoverlay
124  [NumberBackground]
125  [\MPclipFive{\overlaywidth}{\overlayheight}{30pt}{5pt}]
126
127\setuppagenumbering
128  [\location={footer,middle},
129   \command=\NummerCommand]
130
131\def\NummerCommand#1%
132  {\framed
133     [\background=NumberBackground,
134      \frame=off,
135      \offset=6pt]
136     {\lower.5\dp\strutbox\hbox spread 60pt{\hss#1\hss}}}
137\stopbuffer
138
139\typebuffer
140
141\stopsection
142
143\startsection[reference=setups,title=Setups]
144
145\index{setups}
146
147\Command{\tex{setup}}
148
149While defining the layout of a document you can define setups
150with \type{\start...\stopsetups}. Setups are placed in the setup area of
151input file and mostly used to combine a number of commands.
152
153\startbuffer
154\startsetups colorize
155    \blue
156\stopsetups
157
158\startsetups decolorize
159    \black
160\stopsetups
161
162\setupitemize
163    [before=\setups{colorize},
164     after=\setups{decolorize}]
165
166Some data on the church are:
167
168\startitemize[packed,3*broad]
169\sym{997}  mentioned for the first time
170\sym{1380} destroyed by fire
171\sym{1466} rebuild
172\sym{1657} restored after shelling by enemy troops
173\sym{1725} struck by lightning
174\stopitemize
175
176\stopbuffer
177
178\typebuffer
179
180Which would result in:
181
182\start % AFO: to keep color and distance local
183\getbuffer
184\stop
185
186Another way of invoking the setups is by the \type{setups} option
187that comes with some \CONTEXT\ commands:
188
189\startbuffer
190\definestartstop[remark]
191
192\setupstartstop[remark]
193  [before=\startframed,
194   after=\stopframed]
195
196\startsetups important
197  \inleftmargin
198    [scope=local,
199     hoffset=1em]{\bf\color[blue]{→}}
200\stopsetups
201
202\setupframed
203  [align=normal,
204   setups=important,
205   frame=on,
206   framecolor=blue,
207   offset=5pt]
208
209\startremark
210  The Stephanus Church was built in 997. After an enormous
211  fire in 1380 it was rebuilt and that's why it has Gothic
212  features. The rebuilding was finished in 1466.\endgraf
213\stopremark
214\stopbuffer
215
216\typebuffer
217
218This becomes:
219
220\blank
221
222\start
223\getbuffer
224\stop
225
226\stopsection
227
228\startsection[reference=variables,title=Variables]
229
230\index{variables}
231
232\Command{\tex{getvariable}}
233\Command{\tex{setvariables}}
234
235There is a mechanism in \CONTEXT\ that enables you to compact information in a
236list of variables that you can recall throughout the document.
237
238\shortsetup{setvariables}
239
240The example below shows how to use variables in defining a coverpage.
241
242\startbuffer
243\setvariables
244  [cover]
245  [set=\setups{coverpage},
246   student=no,
247   teacher=yes,
248   title=From Hasselt to America,
249   subtitle=An Odyssey,
250   authors=\setup{allauthors},
251   edition=2012,
252   isbn=0123456789]
253\stopbuffer
254
255\typebuffer
256
257The moment you need the title on your cover page (or somewhere else in your document) you can
258summon it by:
259
260\startbuffer
261\getvariable{cover}{title}
262\stopbuffer
263
264\typebuffer
265
266\stopsection
267
268\startsection[reference=floatingblocks,title=Floating blocks]
269
270\index{floating blocks}
271\index{postponing a block}
272
273\Command{\tex{definefloat}}
274\Command{\tex{setupfloat}}
275\Command{\tex{setupfloats}}
276\Command{\tex{setupcaptions}}
277\Command{\tex{placeintermezzo}}
278
279A block in \CONTEXT\ is a text element, for example a table or a figure that you
280can process in a special way. You have already seen the use of
281\type{\placefigure} and \type{\placetable}. These are both examples of floating
282blocks. The floating mechanism is described in \in{chapter}[figures] and
283\in[tables].
284
285You can define these kind of blocks yourself with:
286
287\shortsetup{definefloat}
288
289The bracket pairs are used for the name in singular and
290plural form. For example:
291
292\starttyping
293\definefloat[intermezzo][intermezzi]
294\stoptyping
295
296Now the following commands are available:
297
298\starttyping
299\placeintermezzo[][]{}{}
300\startintermezzotext ... \stopintermezzotext
301\placelistofintermezzi
302\completelistofintermezzi
303\stoptyping
304
305The newly defined floating block can be set up with:
306
307\shortsetup{setupfloat}
308
309You can set up the layout of floating blocks with:
310
311\shortsetup{setupfloats}
312
313You can set up the numbering and the labels with:
314
315\shortsetup{setupcaption}
316
317These commands are typed in the set up area of your input file and will have a
318global effect on all floating blocks.
319
320\setupframedtexts
321    [width=.8\makeupwidth,
322     background=color,
323     backgroundcolor=gray,
324     corner=round,
325     framecolor=blue,
326     rulethickness=2pt]
327
328\startbuffer
329\setupfloat[intermezzo][location=middle]
330\setupcaption[location=bottom,headstyle=boldslanted]
331
332\placeintermezzo{An intermezzo.}
333\startframedtext
334At the beginning of this century there was a tram line from
335Zwolle to Blokzijl via Hasselt. Other means of transport became
336more important and just before the second world war the tram line
337was stopped. Nowadays such a tram line would have been very
338profitable.
339\stopframedtext
340\stopbuffer
341
342\typebuffer
343
344\start
345\getbuffer
346\stop
347
348The framed texts inherits its layout from the example \at{page}[block:bridge].
349
350Tables or figures may take up a lot of space. The placing of these text elements
351can be postponed till the next page break. This is done with:
352\type{\start ... \stoppostponing}:
353
354\startbuffer
355\startpostponing
356\placefigure
357  {A postponed figure.}
358  {\externalfigure[ma-cb-16][width=\textwidth]}
359\stoppostponing
360\stopbuffer
361
362\typebuffer
363
364The figure will be placed at the top of the next page and will cause minimal
365disruption of the running text.
366
367\getbuffer
368
369\stopsection
370
371% \startsection[reference=textblocks,title=Text blocks] % AFO 2013: weggehaald, wordt toch nooit gebruikt
372
373% \index{text blocks}
374
375% \Command{\tex{defineblock}}
376% \Command{\tex{useblocks}}
377% \Command{\tex{hideblocks}}
378% \Command{\tex{setupblock}}
379
380% \stopsection
381
382\startsection[title=Storing text for later use]
383
384\index{storing text}
385
386\Command{\tex{startbuffer}}
387\Command{\tex{getbuffer}}
388\Command{\tex{typebuffer}}
389\Command{\tex{savebuffer}}
390\Command{\tex{setupbuffer}}
391
392You can store information temporarily for future use in your document with:
393
394\shortsetup{startbuffer}
395
396For example:
397
398\starttyping
399\startbuffer[visit]
400If you want to see what Hasselt has in store you should come and
401visit it some time. If you take this manual with you, you will
402recognise some locations.
403\stopbuffer
404
405\getbuffer[visit]
406\stoptyping
407
408With \type{\getbuffer[visit]} you recall the stored text. The logical name is
409optional. With \type{\typebuffer[visit]} you get back the typeset version of the
410content of the buffer.
411
412Buffers are set up with:
413
414\shortsetup{setupbuffer}
415
416You can also save a buffer to an external file with:
417
418\shortsetup{savebuffer}
419
420If you want to save the buffer \type{visit} in an external file called
421\type{myfile-sightseeing.tmp} you type:
422
423\starttyping
424\savebuffer[visit][sightseeing]
425\stoptyping
426
427\stopsection
428
429\startsection[title=Lines]
430
431\index{lines}
432
433\Command{\tex{hairline}}
434\Command{\tex{starttextrule}}
435\Command{\tex{thinrule}}
436\Command{\tex{thinrules}}
437\Command{\tex{setupthinrules}}
438\Command{\tex{underbar}}
439\Command{\tex{overstrikes}}
440\Command{\tex{periods}}
441
442There are many comands to draw lines. For a single line you type:
443
444\shortsetup{hairline}
445
446or:
447
448\shortsetup{thinrule}
449
450For more lines you type:
451
452\shortsetup{thinrules}
453
454Text in combination with lines is also possible:
455
456\startbuffer
457\starttextrule{Hasselt -- Amsterdam}
458If you draw a straight line from Hasselt to Amsterdam you would have
459to cover a distance of almost 145 \unit{Kilo Meter}.
460\stoptextrule
461
462If you draw two straight lines from Hasselt to Amsterdam you would
463have to cover a distance of almost 290 \unit{Kilo Meter}.
464
465Amsterdam \thinrules[n=3] Hasselt
466\stopbuffer
467
468\getbuffer
469
470The code of this example is:
471
472\typebuffer
473
474You always have to be careful in drawing lines. Empty lines around
475\type{\thinrules} must not be forgotten and the vertical spacing is always a
476point of concern.
477
478You can set up line spacing with:
479
480\shortsetup{setupthinrules}
481
482There are a few complementary commands that might be very
483useful.
484
485\shortsetup{setupfillinrules}
486
487These commands are introduced in the examples below:
488
489\startbuffer
490\setupfillinrules[width=2cm]
491\setupfillinlines[width=3cm]
492
493\fillinrules[n=1]{\bf name}
494\fillinrules[n=3]{\bf adress}
495
496\fillinline{Can you please state the \underbar{number} of houses
497            in Hasselt.} \par
498
499Strike out \overstrikes{Hasselt in this text}\periods[18]
500\stopbuffer
501
502\typebuffer
503
504This will become:
505
506\getbuffer
507
508These commands are used in questionaires. Text that is
509struck out or underlined will not be hyphenated.
510
511In \in{section}[overlays] you have already seen the use of the
512\type{\blackrule} command that can be set up with:
513
514\shortsetup{setupblackrules}
515
516\startbuffer
517\blank
518\blackrule[width=\textwidth,height=1cm,color=blue]
519\stopbuffer
520
521\typebuffer
522
523This will result in a rather fat line:
524
525\getbuffer
526
527
528\stopsection
529
530\startsection[title=Super- and subscript in text]
531
532\index{subscript}
533\index{superscript}
534
535\Command{\tex{low}}
536\Command{\tex{high}}
537\Command{\tex{lohi}}
538
539\startbuffer
540Hasselt's economy has known its \high{ups} and \low{downs}.
541Since the nineties of the last century its economy is
542\lohi{so}{so}.
543\stopbuffer
544
545\getbuffer
546
547This ugly text was made with \type{\low{}}, \type{\high{}} and \type{\lohi{}{}}.
548The text was placed between the curly braces.
549
550\stopsection
551
552\startsection[title=Date]
553
554\index{date}
555
556\Command{\tex{currentdate}}
557
558You can invoke the system date in your text with:
559
560\shortsetup{currentdate}
561
562With \type{\currentdate[day]}, \type{\currentdate[month]} and \type{\currentdate[year]} you can
563invoke day, month and year separately.
564
565\stopsection
566
567\startsection[title=Rotating text, figures and tables]
568
569\index{rotating}
570
571\Command{\tex{rotate}}
572
573Sometimes you may want to rotate text or images. You can rotate
574text and other objects with:
575
576\shortsetup{rotate}
577
578The first bracket pair is optional. Within that bracket pair
579you specify the rotation: \type{rotation=90}. The curly
580braces contain the text or object you want to rotate.
581
582\startbuffer
583Hasselt got its municipal rights in 1252. From that time on it had
584the \rotate[rotation=90]{right} to use its own seal on official
585documents. This seal showed Holy Stephanus known as one of the first
586Christian martyrs, and was the \rotate[rotation=270]{patron} of
587Hasselt. After the Reformation the seal was redesigned and Stephanus
588lost his \quote{holiness} and was from that time on depicted without
589his aureole.
590\stopbuffer
591
592\typebuffer
593
594This results in a very ugly paragraph:
595
596\getbuffer
597
598You can rotate an image just as easily:
599
600%  \placetable[rotate][]{}{}
601
602\startbuffer
603\placefigure
604  [][fig:rotation]
605  {The 180 \unit{Degrees} rotated fishing port (de Vispoort).}
606  {\rotate[rotation=180]{\externalfigure[ma-cb-15][width=10cm]}}
607\stopbuffer
608
609\typebuffer
610
611You can see in \in{figure}[fig:rotation] that it is not always clear what you get
612when you rotate.
613
614\getbuffer
615
616We can set up rotating with:
617
618\shortsetup{setuprotate}
619
620In the example above you could also rotate image and caption by:
621
622\startbuffer
623\placefigure
624  [180][fig:rotation]
625  {The 180 \unit{Degrees} rotated fishing port (de Vispoort).}
626  {\externalfigure[ma-cb-15][width=10cm]}
627\stopbuffer
628
629\typebuffer
630
631\stopsection
632
633\startsection[title=Scaling text]
634
635\index{scaling}
636
637\Command{\tex{scale}}
638\Command{\tex{setupscale}}
639
640For some obscure reasons you may want to scale text. You can scale text and other
641objects with:
642
643\shortsetup{scale}
644
645\startbuffer
646After 1810 the Dedemsvaart brought some prosperity to Hasselt. All
647ships went through the canals of Hasselt and the \scale[factor=10]{shops} on both
648sides of the canals \scale[factor=10]{prospered}.
649\stopbuffer
650
651\typebuffer
652
653Which will result in:
654
655\getbuffer
656
657\stopsection
658
659\startsection[title=Space]
660
661\index{space}
662\index{tilde}
663\index{non-breakable space}
664
665\Command{\tex{space}}
666\Command{\tex{fixedspaces}}
667
668The command \type{\space} will produce a space. In \CONTEXT\ the
669\type{~} (tilde) is a non-breakable space.
670
671\startbuffer
672The Ridderstraat in Hasselt is about 160~m long and 5 to 6~m wide
673with houses on both sides of the street.
674\stopbuffer
675
676\typebuffer
677
678Tildes can also be used to align numbers in a row. The command
679\type{\fixedspaces} will give the tilde the fixed width of a number.
680
681\startbuffer
682\fixedspaces
683
684\bTABLE[frame=off]
685\bTR \bTD Ridderstraat  \eTD \bTD 160 m \eTD \eTR
686\bTR \bTD Prinsengracht \eTD \bTD 240 m \eTD \eTR
687\bTR \bTD Kalverstraat  \eTD \bTD ~60 m \eTD \eTR
688\bTR \bTD Meestersteeg  \eTD \bTD ~45 m \eTD \eTR
689\eTABLE
690\stopbuffer
691
692\typebuffer
693
694\stopsection
695
696\startsection[title=Carriage return]
697
698\index{carriage return}
699
700\Command{\tex{crlf}}
701\Command{\tex{startlines}}
702
703A new line can be enforced with:
704
705\shortsetup{crlf}
706
707As a \CONTEXT\ user you should use this command only as a last resort.
708
709When a number of lines should be followed by a {\em carriage return and line feed}
710you can use:
711
712\shortsetup{startlines}
713
714\starttyping
715\startlines
716.
717.
718.
719\stoplines
720\stoptyping
721
722\startbuffer
723On a wooden panel in the town hall of Hasselt you can read:
724
725\startlines
726Heimelijcken haet
727eigen baet
728jongen raet
729Door diese drie wilt verstaen
730is het Roomsche Rijck vergaen.
731\stoplines
732
733This little rhyme contains a warning for the magistrates of
734Hasselt: don't allow personal benefits or feelings to
735influence your wisdom in decision making.
736\stopbuffer
737
738\typebuffer
739
740This will become:
741
742\getbuffer
743
744In a few commands new lines are generated by \type{\\}. For example if you type
745\type{\inmargin{in the\\margin}} then the text will be divided over two lines.
746
747\stopsection
748
749\startsection[title=Hyphenation]
750
751\index{hyphenation}
752\index{language}
753
754\Command{\tex{mainlanguage}}
755\Command{\tex{language}}
756\Command{\tex{nl}}
757\Command{\tex{en}}
758
759When writing multi-lingual texts you have to be aware of the fact that
760hyphenation may differ from one language to another.
761
762To activate a language you type:
763
764\shortsetup{mainlanguage}
765
766Between the brackets you fill in
767\type{af},
768\type{ca},
769\type{cs},
770\type{cs},
771\type{da},
772\type{de},
773\type{en},
774\type{fi},
775\type{fr},
776\type{it},
777\type{la},
778\type{nl},
779\type{nb},
780\type{nn},
781\type{pl},
782\type{pt},
783\type{es},
784\type{sv} and
785\type{tr} for
786afrikaans,
787catalan,
788czech,
789slovak,
790danish,
791german,
792english,
793finnish,
794french,
795italian,
796latin,
797dutch,
798bokmal,
799nnynorsk,
800polish,
801portuguese,
802spanish,
803swedish and
804turkish respectively.
805
806To change from one language to another you can use:
807
808\starttyping
809\language[nl] \language[en] \language[de] \language[fr] \language[sp] ...
810\stoptyping
811
812or the shorthand versions:
813
814\starttyping
815\nl  \en  \de  \fr  \sp ...
816\stoptyping
817
818An example:
819
820\startbuffer
821If you want to know more about Hasselt, the best book to read is
822probably \quote{\nl Uit de geschiedenis van Hasselt} by
823F.~Peereboom.
824\stopbuffer
825
826\typebuffer
827
828\getbuffer
829
830If a word is wrongly hyphenated you can define the hyphenation points yourself.
831This is done in the set up area of your input file:
832
833\startbuffer
834\hyphenation{his-to-ry}
835\stopbuffer
836
837\typebuffer
838
839Note that the language setting is also responsible for the way quotes are placed
840around quotes and quotations (see \in{section}[quotations]).
841
842In some languages (like Dutch) compound words are used that are connected with a
843hyphen. The separate words have to be hyphenated correctly. In order to do that
844you can use \type{||}.
845
846\startbuffer
847If your looking for an English||speaking person in Hasselt you should
848go to the Tourist Information Office. There you may expect to find
849full|| and part||time employees who are fluent in German, English,
850French and of course Dutch.
851\stopbuffer
852
853\typebuffer
854
855This will become:
856
857\getbuffer
858
859The double \type{||} takes care of the hyphen and the correct hyphenation of the
860separate words. Also note the suspended compounds.
861
862\stopsection
863
864\startsection[title=Charts]
865
866\index{chart}
867
868\Command{\tex{FLOWchart}}
869
870To enable you to draw flow diagrams \CONTEXT\ contains the core module
871\type{chart}. A simple organogram may look like this:
872
873\startbuffer
874\setupFLOWcharts
875  [width=9\bodyfontsize,
876   height=2\bodyfontsize,
877   dx=1\bodyfontsize,
878   dy=1\bodyfontsize]
879
880\setupFLOWlines
881  [arrow=no]
882
883\startFLOWchart[organogram]
884  \startFLOWcell
885    \shape    {action}
886    \name     {01}
887    \location {2,1}
888    \text     {Zwartewaterland}
889    \connect  [bt]{02}
890    \connect  [bt]{03}
891    \connect  [bt]{04}
892  \stopFLOWcell
893  \startFLOWcell
894    \shape    {action}
895    \name     {02}
896    \location {1,2}
897    \text     {Hasselt}
898  \stopFLOWcell
899  \startFLOWcell
900    \shape    {action}
901    \name     {03}
902    \location {2,2}
903    \text     {Zwartsluis}
904  \stopFLOWcell
905  \startFLOWcell
906    \shape    {action}
907    \name     {04}
908    \location {3,2}
909    \text     {Genemuiden}
910  \stopFLOWcell
911\stopFLOWchart
912\stopbuffer
913
914\midaligned{\getbuffer\FLOWchart[organogram]}
915
916This diagram is defined with the commands below:
917
918\typebuffer
919
920It is of good practice to define your setups and flow diagrams in separate
921definition files (environments).
922
923\startbuffer
924\FLOWchart[organogram]
925\stopbuffer
926
927The flowchart can then be invoked by:
928
929\typebuffer
930
931\stopsection
932
933\startsection[title=Comment in input file]
934
935\index{comment}
936\index[percent]{\% in input file}
937
938All text between \type{\start...\stoptext} will be processed while running
939\CONTEXT. Sometimes however you may have text fragments you don't want to be
940processed or you want to comment on your \CONTEXT\ commands.
941
942If you preceed your text with the percentage sign \type{%}
943it will not be processed.
944
945\startbuffer
946% In very big documents you can use the command \input for
947% different files.
948%
949% For example:
950%
951% \input hass01.tex  % chapter 1 on Hasselt
952% \input hass02.tex  % chapter 2 on Hasselt
953% \input hass03.tex  % chapter 3 on Hasselt
954\stopbuffer
955
956\typebuffer
957
958When you delete the \type{%} before \type{\input} the three files will be
959processed. The comment describing the contents of the files will not be
960processed.
961
962\stopsection
963
964\startsection[title=Notes]
965
966\index{note}
967
968\Command{\tex{startcomment}}
969
970If you want your comment in the input file visible as a 'note' in the PDF file
971you can use:
972
973\shortsetup{startcomment}
974
975\startbuffer
976\startcomment
977    The image of the Vispoort should be in color.
978\stopcomment
979\stopbuffer
980
981\typebuffer
982
983The command will produce a sticky note in the PDF.
984
985The note is only visible when interactivity is set with \type{\setupinteraction}
986and the comment with \type{\setupcomment}.
987
988\stopsection
989
990\startsection[title=Hiding text]
991
992\index{hiding text}
993
994\Command{\tex{starthiding}}
995
996Text can be hidden with:
997
998\shortsetup{starthiding}
999
1000The text between \type{\start ... \stophiding} will not be processed.
1001
1002\stopsection
1003
1004\startsection[title=Input of another {\tt tex} file]
1005
1006\index{input other \TEX--files}
1007
1008\Command{\tex{input}}
1009
1010In a number of situations you may want to insert other \TEX\ files in your input
1011file. For example, sometimes it is more efficient to specify \CONTEXT\ sources in
1012more than one file in order to be able to partially process your files.
1013
1014Another file (with the name \type{another.tex}) can be inserted by:
1015
1016\starttyping
1017\input another.tex
1018\stoptyping
1019
1020The extension is optional so this will work too:
1021
1022\starttyping
1023\input another
1024\stoptyping
1025
1026The command \type{\input} is a \TEX\ command.
1027
1028For a more systematic approach in maintaining your documents \CONTEXT\ supports a
1029project structure with commands like \type{\start...\stopenvironment} and
1030\type{\start...\stopproduct}. Please refer to the magazine
1031\goto {\em Project structure} [ url(thisway:proj-struc) ]
1032for more information.
1033
1034\stopsection
1035
1036\startsection[title=XML (eXtended Markup Language)]
1037
1038\index{xml}
1039\index{mathml}
1040\index{openmath}
1041
1042Normally you code your document with \CONTEXT\ commands so you can tell \CONTEXT\
1043what to do with the coded text elements.
1044
1045A more rigid way to code your content is \XML\ (eXtended Markup Language) which enables
1046you to have more control over your content (scripting, xslt, validation). A simple
1047\XML\ coded document could look like this:
1048
1049\startbuffer
1050<?xml version='1.0' standalone='yes?>
1051
1052<document>
1053  <section>
1054    <title>Hasselt in winter</title>
1055    <content>
1056      <p>In winter scating is a very popular sport in Hasselt.
1057         All over Hasselt the frozen canals offer children a great
1058         play ground.</p>
1059      <p>...</p>
1060    </content>
1061  </section>
1062</document>
1063\stopbuffer
1064
1065\typebuffer
1066
1067\CONTEXT\ is able to deal with \XML\ directly without underlying XML2TEX
1068conversions. Please refer to the manual \goto {Dealing with XML} [ url
1069(manual:xml) ] for more information on how to process \XML\ documents.
1070
1071\CONTEXT\ also supports \MATHML\ (presentational and content markup) and
1072\OPENMATH\ with which math expressions can be coded in \XML\ documents.
1073
1074\stopsection
1075
1076\stopchapter
1077
1078\stopcomponent
1079
1080