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

From Wiki
Jump to navigation Jump to search
(Columnsets introduced)
m (→‎How to create a document: Removed an old comment)
(8 intermediate revisions by 3 users not shown)
Line 4: Line 4:
  
 
== How to create a document ==
 
== How to create a document ==
 +
 +
* In the source, <code>\type{filename}</code> should be changed to <code>\filename{filename}</code>.
 +
* 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 ==
 
== 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 ==
 
== 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 ==
 +
* In the source change <code>\type{command}</code> to <code>\tex{command}</code>
 +
* $\cdots$ -> \unknown
 +
 
== Headers ==
 
== Headers ==
 
* \setupsectionblock[...][..,..=..,..]  
 
* \setupsectionblock[...][..,..=..,..]  
Line 20: Line 42:
 
== Itemize ==
 
== Itemize ==
 
* \startitemize[..,...,..][..,..=..,..] ... \stopitemize  
 
* \startitemize[..,...,..][..,..=..,..] ... \stopitemize  
* \setupitemize[.1.][..,.2.,..][..,..=..,..]  
+
* \setupitemize[.1.][..,.2.,..][..,..=..,..]
 +
 
 
== Formulae ==
 
== Formulae ==
 
* \placeformula[ref,..]{.1.}$$.2.$$
 
* \placeformula[ref,..]{.1.}$$.2.$$
Line 176: Line 199:
 
== Using modules ==
 
== Using modules ==
 
* \usemodule[..,...,..]
 
* \usemodule[..,...,..]
 +
* \loadmapfile[gbk]  \usemodule[chinese]
 +
 
== Appendix A User specifications ==
 
== Appendix A User specifications ==
 
* \setupoutput[pdftex]  
 
* \setupoutput[pdftex]  

Revision as of 05:36, 9 May 2007

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