Open main menu

Revision and translations of “ConTeXt, an excursion”

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

Page headers and footers

  • \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