Changes

< [[Main Page]] | [[Second Step]] | [[Next StepsDetailed Example]] >

What ConTeXt is ConTeXt? What can I do with it? Let’s seea ''[http://en.wikipedia. Take your favourite [[text editor]org/wiki/Markup_language markup language]'' used to primarily create PDF files. To use ConTeXt, type in the following document and save it as create a text file (typically with a <code>hello.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.

<texcode>\starttextHello World\stoptext</texcode> It shows already a ConTeXt essential: everything's between <tt>\startsomething</tt> and <tt>\stopsomething</tt>.== First steps ==

I you don't have Make sure that ConTeXt [[install|is installed]] (yet)on your system. To check that, you can first try out go to the latest version using the web interface http://live.contextgarden.net.command line and type

If you already installed it, you can go to the shell<pre>context --version</command line and type inpre>

texexec mtx-context | ConTeXt Process Management 0.61mtx-pdf hellocontext |mtx-context | main context file: /opt/context-minimals/texmf-context/tex/context/base/context.texmkivmtx-context | current version: 2014.12.29 10:01

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 now save the file as <code>hello.tex</code>: <texcode>\starttext\startsection[title={Testing ConTeXt}] This is my {\em first} ConTeXt will startdocument.\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. It will give you some The material before <code>\starttext</code> (called ''preamble'') is used to change the style of the output on your terminal ; 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). 

<pre><nowiki>== Compile the ConTeXt file ==  TeXExec 5.4.3 - ConTeXt / PRAGMA ADE 1997Go to the command-2005line and type:

This is pdfeTeXConTeXt will then process your document, Version 3.141592-1.21a-2.2 (Web2C 7.5.4) (/opt/context/current/texmf/web2c/natural.tcx)entering extended mode(display some logging information on the console, and generate a <tt>hello.pdf</testtt> output file.tex

ConTeXt ver<pre><nowiki>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: 2005fulljobname=".08/hello.19 fmttex" --c: 2005input=".8/hello.19 inttex" --c: english kindofrun=1 "cont-yes.mkiv"This is LuaTeX, Version beta-0.74.0-2012122511 (rev 4541) mes: english\write18 enabled.(/opt/context-minimals/texmf-context/tex/context/base/cont-yes.mkiv

language ConTeXt ver: language en is active2013.01.27 21:24 MKIV fmt: 2013.1.28 int: english/english<protectionstate 0>...

Don’t be worried. This is == View the way it should look. Once texexec has finished, it will leave behind a generated PDF file called == Open the generated <tt>hello.pdf</tt>PDF file using a [http://en.wikipedia.org/wiki/List_of_PDF_software#Viewers PDF viewer]. Open it and you will see a It should look as follows: <context mode="Hello worldmkiv" >% 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 virtual A4 paper slightly larger fonts, and the emphasized word comes out in a page numberslanted font. == Modifying the output style == It is possible to change the style of the output by using appropriate ''setup'' commands in the preamble. For example, to make the section titles bold and to use italic (rather than slanted) font for emphasized words, use <context mode="mkiv" source="yes" text="which gives">\setuphead[section][style=\bfa]\setupbodyfontenvironment[default][em=italic] \starttext\startsection[title={Testing ConTeXt}] This is my {\em first} ConTeXt document.\stopsection\stoptext</context>