237
edits
Changes
Jump to navigation
Jump to search
ConTeXt is a ''[http://en.wikipedia.org/wiki/Markup_language markup language]'' used to primarily create PDF files. To use ConTeXt, create a text file (typically with a <code>.tex</code> extension) with ConTeXt markup and ''compile'' the file by running the command <code>context filename</code>. This creates a PDF file. This page explains how to create your very first ConTeXt document.
== First steps ==
Make sure that ConTeXt is installed on your system. To check that, go to the command line and type
<pre>context --version</pre>
You should get an output as follows:
<pre>
mtx-context | ConTeXt Process Management 1.03
mtx-context |
mtx-context | main context file: /opt/context-minimals/texmf-context/tex/context/base/mkiv/context.mkiv
mtx-context | current version: 2020.01.30 14:13
</pre>
If ConTeXt is not installed on your system, check the [[Installation|installation]] page for installation instructions.
Follow the steps below to create a simple document using ConTeXt:
== Create a ConTeXt file ==
Open a [[Text Editors|text editor]], type the following content, and save the file as <code>hello.tex</code> or <code>hello.mkxl</code>:
<texcode>\starttext
\startsection[title={Testing ConTeXt}]
This is my {\em first} ConTeXt document.
\stopsection
\stoptext</texcode>
Words starting with a backslash (such as <code>\starttext</code>) are called '''command sequence''' or '''macros'''. The macros
<texcode>\starttext
....
\stoptext</texcode>
mark the content to be typeset. The material before <code>\starttext</code> (called ''preamble'') is used to change the style of the output; any material after <code>\stoptext</code> is ignored.
The macros
<texcode>\startsection[title={...}]
...
\stopsection</texcode>
mark the title and the content of a section.
The macro <code>{\em ...}</code> is a [[Font Switching| font switch]] that emphasizes the content (by showing it in slanted font).
== Compile the ConTeXt file ==
Go to the command-line and type:
<pre>context hello</pre>
ConTeXt will then process your document, display some logging information on the console, and generate a <tt>hello.pdf</tt> output file.
<pre><nowiki>
mtx-context | run 1: luatex --fmt="/home/adityam/.cache/context-minimals/luatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luatex/cont-en" --jobname="hello" --lua="/home/adityam/.cache/context-minimals/luatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luatex/cont-en.lui" --c:currentrun=1 --c:fulljobname="./hello.tex" --c:input="./hello.tex" --c:kindofrun=1 --c:maxnofruns=9 --c:texmfbinpath="/opt/context-minimals/texmf-linux-64/bin" "cont-yes.mkiv"
This is LuaTeX, Version 1.10.1 (TeX Live 2019)
system commands enabled.
open source > level 1, order 1, name '/opt/context-minimals/texmf-context/tex/context/base/mkiv/cont-yes.mkiv'
system >
system > ConTeXt ver: 2019.07.24 11:17 MKIV beta fmt: 2019.8.17 int: english/english
...
...
mkiv lua stats > lua properties: engine: lua 5.3, used memory: 94 MB, ctx: 93 MB, max: unknown MB), hash chars: min(64,40), symbol mask: utf (τεχ)
mkiv lua stats > runtime: 0.833 seconds, 1 processed pages, 1 shipped pages, 1.200 pages/second
system | total runtime: 4.485 seconds
</nowiki></pre>
== View the generated PDF file ==
Open the generated <tt>hello.pdf</tt> PDF file using a [http://en.wikipedia.org/wiki/List_of_PDF_software#Viewers PDF viewer]. It should look as follows:
<context mode="mkiv">
% Draw a white frame so that the page is not truncated.
% But it does not seem to work :(
\setupbackgrounds[text][frame=on]
\starttext
\startsection[title={Testing ConTeXt}]
This is my {\em first} ConTeXt document.
\stopsection
\stoptext
</context>
Note that the section has been numbered, the section number and the section title appear in a slightly larger fonts, and the emphasized word comes out in a slanted font.
no edit summary
== Modifying the output style ==
