At EuroTeX 2005 http://www.gutenberg.eu.org/eurotex2005/ several persons approached Hans Hagen to translate the manual ConTeXt, an excursion. This page lists the contents of the manual version 990527.
The purpose of this page is to comment which sections need to be updated, which ones need to be deleted, etc., before beginning the translation.
Contents
- 1 How to create a document
- 2 How to process a file / Run CONTEXT
- 3 Special characters
- 4 Defining a document
- 5 Headers
- 6 Itemize
- 7 Formulae
- 8 Legends
- 9 Units
- 10 Figures
- 11 Tables
- 12 Paragraph formatting
- 13 Columns
- 14 Footnotes
- 15 Definitions
- 16 Numbered definitions
- 17 Outlined text
- 18 Outlined paragraphs
- 19 Margin texts
- 20 Page breaking and page numbering
- 21 Page headers and footers
- 22 Table of contents (lists)
- 23 Registers
- 24 Synonyms
- 25 Refering to text elements
- 26 Color
- 27 Background text
- 28 Page backgrounds
- 29 Alignment
- 30 Interactive mode in electronic documents
- 31 Fonts and font switches
- 32 Composite characters
- 33 Page layout
- 34 Paragraph spacing
- 35 Setup commands
- 36 Defining commands / macros
- 37 Miscellaneous
- 38 Using modules
- 39 Appendix A User specifications
- 40 Appendix B Processing steps
- 41 Appendix C Auxilliary files
- 42 Appendix D Command definitions
- 43 Appendix E Command Index
- 44 Appendix F Subject Index
How to create a document
-
In the source,
\type{filename}should be changed to\filename{filename}. - The manual says that ConTeXt excepts plain ASCII input. This is not true (anymore) since you can input other encodings also. AFAIU, ASCII is just the first 128 characters, right?
- Page 4, change This can be done yet some other context command... to ....done by another context ....
- Change One can use texexec... to You can use .... (The previous sentence refers to the reader as you...)
- This perl script to ... this ruby script
How to process a file / Run CONTEXT
- Remove context filename . AFAIK, the script context is not distributed by any tex distribution.
- At tex prompt ? S to scroll future error messages,
R to run without stopping, Q to run quietly, 1 or ... or 9 to ignore the next 1 to 9 tokens of input.
- Futher more -> Furthermore
- Explain that the log file is called myfile.log
- The document does not explain how to get the dvi. Something must be said about the backend drivers for dvi also.
Special characters
- Table 3.2 is a bit confusing. These characters can be used in text mode also. The output of textmode looks different from the output of math mode
- Table 3.1 should also mention _ (underscore) and ^ (cadet).
- For all practical purposes in ConTeXt | (pipe) is also a special character.
Defining a document
-
In the source change
\type{command}to\tex{command} - $\cdots$ -> \unknown
Headers
- \setupsectionblock[...][..,..=..,..]
- \chapter[ref,..]{...}
- \section[ref,..]{...}
- \subsection[ref,..]{...}
- \title[ref,..]{...}
- \subject[ref,..]{...}
- \subsubject[ref,..]{...}
- \definehead[.1.][.2.]
- \setuphead[...][..,..=..,..]
- \setupheads[..,..=..,..]
Itemize
- \startitemize[..,...,..][..,..=..,..] ... \stopitemize
- \setupitemize[.1.][..,.2.,..][..,..=..,..]
Formulae
- \placeformula[ref,..]{.1.}$$.2.$$
- \startformula ... \stopformula
- \setupformulae[..,..=..,..]
Legends
- \startlegend[.1.]\leg.2.\\.3.\\.4.\\\leg ... \stoplegend
Units
Figures
- \placeblock[.1.][ref,..]{.2.}{.3.}
- \useexternalfigure[.1.][.2.][..,..=..,..]
- \startcombination[...] ... \stopcombination
- \startblocktext[.1.][ref]{.2.}{.3.} ... \stopblock
- \externalfigure[...][..,..=..,..]
- \setupfloats[..,..=..,..]
- \setupcaptions[..,..=..,..]
Tables
- \starttable[...] ... \stoptable
- \setuptables[..,..=..,..]
- \setupfloats[..,..=..,..]
- \setupcaptions[..,..=..,..]
Paragraph formatting
- \defineparagraphs[...][..,..=..,..]
- \setupparagraphs[.1.][.2.][..,..=..,..]
Columns
- \startcolumns[..,..=..,..] ... \stopcolumns
- \setupcolumns[..,..=..,..]
Footnotes
- \footnote[ref]{...}
- \note[ref]
- \setupfootnotes[..,..=..,..]
- It would be interesting to talk about columnsets (even if not detailing them) for users looking for powerful column features.
Definitions
- \definedescription[...][..,..=..,..]
- \setupdescriptions[..,...,..][..,..=..,..]
Numbered definitions
- \defineenumeration[..,.1.,..][.2.][..,..=..,..]
- \setupenumerations[..,...,..][..,..=..,..]
Outlined text
- \framed[..,..=..,..]{...}
- \setupframed[..,..=..,..]
Outlined paragraphs
- \startframedtext[...][..,..=..,..] ... \stopframedtext
- \setupframedtexts[..,..=..,..]
Margin texts
- \inmargin[.1.][ref]{.2.}
Page breaking and page numbering
- \page[..,...,..]
- \setuppagenumbering[..,..=..,..]
- \startpostponing ... \stoppostponing
- \setupfootertexts[.1.][.2.][.3.]
- \setupheadertexts[.1.][.2.][.3.]
- \setupheader[...][..,..=..,..]
- \setupfooter[...][..,..=..,..]
Table of contents (lists)
- \definecombinedlist[.1.][..,.2.,..][..,..=..,..]
- \setuplist[..,...,..][..,..=..,..]
- \setupcombinedlist[...][..,..=..,..]
- \placelist[..,...,..][..,..=..,..]
- \writetolist[.1.]{.2.}{.3.}
- \writebetweenlist[.1.]{.2.}
Registers
- \defineregister[.1.][.2.]
- \setupregister[.1.][.2.][..,..=..,..]
Synonyms
- \definesynonyms[.1.][.2.][.3.][.4.]
Refering to text elements
- \in{.1.}{.2.}[ref]
- \at{.1.}{.2.}[ref]
- \pagereference[ref]
- \textreference[ref]{...}
Color
- \setupcolors[..,..=..,..]
- \definecolor[...][..,..=..,..]
Background text
- \startbackground ... \stopbackground
- \setupbackground[..,..=..,..]
Page backgrounds
- \setupbackgrounds[.1.][..,.2.,..][..,..=..,..]
Alignment
- \setupalign[...]
- \startalignment ... \stopalignment[...]
Interactive mode in electronic documents
- \setupinteraction[..,..=..,..]
- \goto{.1.}{.2.}[ref,..]
- \useexternaldocument[.1.][.2.][.3.]
- \from[ref]
- \defineinteractionmenu[.1.][.2.][..,..=..,..]
- \setupinteractionmenu[..,...,..][..,..=..,..][..,{..[ref,..]},..]
Fonts and font switches
- \setupbodyfont[..,...,..]
- \switchtobodyfont[..,...,..]
- \definebodyfont[..,.1.,..][.2.][..,..=..,..]
- \em
- \starttyping ... \stoptyping
- \type{...}
- \setuptyping[...][..,..=..,..]
- \setuptype[..=..]
Composite characters
Page layout
- \setuplayout[..,..=..,..]
- \adaptlayout[21,38][height=+.5cm]
- \startlocal ... \stoplocal
Paragraph spacing
- \setupwhitespace[...]
- \startlinecorrection ... \stoplinecorrection
- \blank[..,...,..]
- \setupblank[...]
- \startpacked[...] ... \stoppacked
- \startunpacked ... \stopunpacked
- \godown[...]
- \setupindenting[..,...,..]
- \indenting[..,...,..]
- \noindenting
Setup commands
- \setupparagraphs[.1.][.2.][..,..=..,..]
Defining commands / macros
- \define[.1.]\command{.2.}
- \definestartstop[...][..,..=..,..]
Miscellaneous
- \definefloat[.1.][.2.]
- \setupfloat[...][..,..=..,..]
- \setupfloats[..,..=..,..]
- \setupcaption[...][..,..=..,..]
- \defineblock[...]
- \hideblocks[..,.1.,..][..,.2.,..]
- \useblocks[..,.1.,..][..,.2.,..]
- \keepblocks[..,.1.,..][..,.2.,..]
- \selectblocks[..,.1.,..][..,.2.,..][..=..]
- \startbuffer[...] ... \stopbuffer
- \setupbuffer[...][..,..=..,..]
- \starthiding ... \stophiding
- \hairline
- \thinrule
- \thinrules[..=..]
- \setupthinrules[..=..]
- \setupfillinrules[..,..=..,..]
- \setupfillinlines[..,..=..,..]
- \low{}
- \high{}
- \lohi{}{}
- \currentdate
- \position(.1.,.2.){.3.}
- \setuppositioning[..,..=..,..]
- \rotate[..,..=..,..]{...}
- \setuprotate[..,..=..,..]
- \crlf
- \startlines ... \stoplines
- \language[...]
Using modules
- \usemodule[..,...,..]
- \loadmapfile[gbk] \usemodule[chinese]
Appendix A User specifications
- \setupoutput[pdftex]
- \setupoutput[dvipsone,dviwindo]
Appendix B Processing steps
- texutil --references filename
- texutil --figures *.
- texutil --figures --epspage --epspdf
- texexec filename
Appendix C Auxilliary files
- myfile.tex
- myfile.tui
- myfile.tuo
- myfile.tub
- myfile.tmp
- texutil.tuf
- myfile.dvi
- myfile.ps
- myfile.pdf
Appendix D Command definitions
Appendix E Command Index
Appendix F Subject Index
Another page about Beginner's Manual