Difference between revisions of "Revision and translations of “ConTeXt, an excursion”"

From Wiki
Jump to navigation Jump to search
m (→‎Special characters: Some suggestions)
Line 22: Line 22:
  
 
== Special characters ==
 
== 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 ==
 
== Defining a document ==
 
== Headers ==
 
== Headers ==

Revision as of 23:46, 13 October 2006

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.

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?
  • In the source \type{\starttext} should be changed to \tex{starttext}. Same thing for \type{\stoptext}
  • 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

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