First Document

< Main Page | Second Step | Next Steps >

TODO: mention MKII and IV and both texexec and context already at this step (See: To-Do List)

This page describes the fundamentals of using ConTeXt. It includes hands-on examples, and the instructions assume that you have ConTeXt installed. If you don't want to install it yet, you can try it on the web.

Start by typing the following into a text editor and saving it as hello.tex:

\starttext
Hello World
\stoptext

Then go to the command-line and type:

context hello.tex

ConTeXt will then process your document. It will output some information, such as follows—this output does not indicate an error:

mtx-context     | run 1: luatex --fmt="/opt/context-minimals/texmf-cache/luatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luatex/cont-en" --jobname="hello" --lua="/opt/context-minimals/texmf-cache/luatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luatex/cont-en.lui" --no-parse-first-line --c:currentrun=1 --c:fulljobname="./hello.tex" --c:input="./hello.tex" --c:kindofrun=1 "cont-yes.mkiv"
This is LuaTeX, Version beta-0.74.0-2012122511 (rev 4541) 
 \write18 enabled.
(/opt/context-minimals/texmf-context/tex/context/base/cont-yes.mkiv

ConTeXt  ver: 2013.01.27 21:24 MKIV  fmt: 2013.1.28  int: english/english

system          > cont-new.mkiv loaded
(/opt/context-minimals/texmf-context/tex/context/base/cont-new.mkiv
system          > beware: some patches loaded from cont-new.mkiv
)
system          > files > jobname: hello, input: hello, result: hello
fonts           > latin modern fonts are not preloaded
languages       > language en is active
(hello.tex{/opt/context-minimals/texmf-fonts/fonts/map/pdftex/context/mkiv-base.map}
fonts           > preloading latin modern fonts (second stage)
fonts           > typescripts > unknown: library 'loc'
{/opt/context-minimals/texmf-fonts/fonts/map/dvips/lm/lm-math.map}{/opt/context-minimals/texmf-fonts/fonts/map/dvips/lm/lm-rm.map}
fonts           > fallback modern rm 12pt is loaded
backend         > xmp > using file '/opt/context-minimals/texmf-context/tex/context/base/lpdf-pdx.xml'
pages           > flushing realpage 1, userpage 1
 ) )</opt/context-minimals/texmf-fonts/fonts/opentype/public/lm/lmroman12-regular.otf>
mkiv lua stats  > used config file          - selfautoparent:/texmf/web2c/texmfcnf.lua
mkiv lua stats  > used cache path           - /home/adityam/texmf-cache/luatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e
mkiv lua stats  > resource resolver         - loadtime 0.098 seconds, 1 scans with scantime 0.083 seconds, 21 shared scans, 13 found files, scanned paths: /home/adityam/texmf
mkiv lua stats  > stored bytecode data      - 318 modules (0.150 sec), 68 tables (0.000 sec), 386 chunks (0.150 sec)
mkiv lua stats  > cleaned up reserved nodes - 41 nodes, 9 lists of 441
mkiv lua stats  > node memory usage         - 2 glue, 2 penalty, 9 attribute, 28 glue_spec, 3 attribute_list
mkiv lua stats  > node list callback tasks  - 6 unique task lists, 5 instances (re)created, 39 calls
mkiv lua stats  > used backend              - pdf (backend for directly generating pdf output)
mkiv lua stats  > loaded patterns           - en::2
mkiv lua stats  > jobdata time              - 0.001 seconds saving, 0.000 seconds loading
mkiv lua stats  > callbacks                 - 135 direct, 178 indirect, 313 total
mkiv lua stats  > randomizer                - resumed with value 0.13015339995276
mkiv lua stats  > lxml preparation time     - 0.000 seconds, 0 nodes, 15 lpath calls, 0 cached calls
mkiv lua stats  > result saved in file      - hello.pdf, compresslevel 3, objectcompreslevel 3
mkiv lua stats  > loaded fonts              - 2 files: lmroman12-regular.otf latinmodernmath-regular.otf
mkiv lua stats  > fonts load time           - 0.069 seconds 
mkiv lua stats  > luatex banner             - this is luatex, version beta-0.74.0-2012122511  (tex live 2013/dev)(rev 4541)
mkiv lua stats  > control sequences         - 36422 of 65536 + 100000
mkiv lua stats  > current memory usage      - 23 MB (ctx: 23 MB)
mkiv lua stats  > runtime                   - 0.316 seconds, 1 processed pages, 1 shipped pages, 3.165 pages/second

system          | total runtime: 0.468

Once context has finished, it will leave behind a file called hello.pdf. Open it and you will see a "Hello world" document.

→ Second Step