Changes

Jump to navigation Jump to search
2,683 bytes added ,  04:26, 22 May 2015
m
no edit summary
< [[Main Page]] | [[Second Step]] | [[Next StepsDetailed Example]] >
{{todo|mention MKII and IV and both texexec and context already at this step}}
This page describes the fundamentals of using ConTeXtis a ''[http://en.wikipedia. It includes hands-on examples, and the instructions assume that you have ConTeXt [[Installation hints|installedorg/wiki/Markup_language markup language]]. If you don't want ' used to install it yetprimarily create PDF files. To use ConTeXt, you can [http: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</livecode>.contextgardenThis creates a PDF file.net try it on the web]This page explains how to create your very first ConTeXt document.
Start by typing the following into a [[Text Editors|text editor]] and saving it as <code>hello.tex</code>:== First steps ==
<texcode>\starttextHello World\stoptext</texcode>Make sure that ConTeXt is installed on your system. To check that, go to the command line and type
Then go to the command<pre>context -line and type:-version</pre>
You should get an output as follows:
<pre>
texexec hellomtx-context | ConTeXt Process Management 0.61mtx-context |mtx-context | main context file: /opt/context-minimals/texmf-context/tex/context/base/context.mkivmtx-context | current version: 2014.12.29 10:01
</pre>
If ConTeXt will then process 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>: <texcode>\starttext\startsection[title={Testing ConTeXt}] This is my {\em first} ConTeXt document. It will output some information, \stopsection\stoptext</texcode> Words starting with a backslash (such as follows—this output does <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 ''notpreamble'' indicate an error) 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>
TeXExec mtx-context | processing document '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.tex'TeXExec | lui" --no ctx file foundTeXExec | tex processing method-parse-first-line --c: contextTeXExec | TeX run currentrun=1TeXExec | writing option file --c:fulljobname="./hello.topTeXExec | tex engine" --c: pdfetexTeXExec | input="./hello.tex format" --c: kindofrun=1 "cont-enTeXExec | progname: contextyes.mkiv"This is pdfeTeXkLuaTeX, Version 3.141592beta-10.3074.30-2.2 2012122511 (Web2c 7.5.5rev 4541)
\write18 enabled.
%&-line parsing enabled. (c:\/opt/context\usr\local\-minimals/texmf-context\/tex\texmf-local/web2ccontext/natural.tcx)entering extended mode(.base/hellocont-yes.texmkiv
ConTeXt ver: 20062013.0501.14 2327 21:57 24 MKIV fmt: 20062013.51.16 28 int: english /english......mkiv lua stats mes> current memory usage - 23 MB (ctx: english23 MB)mkiv lua stats > runtime - 0.316 seconds, 1 processed pages, 1 shipped pages, 3.165 pages/second
language system | total runtime: language en is active<protectionstate 0>...468
</nowiki></pre>
Once == View the generated PDF file == Open the generated <tt>texexechello.pdf</tt> has finished, it will leave behind PDF file using a file called [http://en.wikipedia.org/wiki/List_of_PDF_software#Viewers PDF viewer]. It should look as follows: <ttcontext mode="mkiv">hello% 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.pdf\stopsection\stoptext</ttcontextNote 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. == Modifying the output style == It is possible to change the style of the output by using appropriate ''setup'' commands in the preamble. Open it For example, to make the section titles bold and you will see a to use italic (rather than slanted) font for emphasized words, use <context mode="mkiv" source="yes" text="Hello worldwhich gives" >\setuphead[section][style=\bfa]\setupbodyfontenvironment[default][em=italic] \starttext\startsection[title={Testing ConTeXt}] This is my {\em first} ConTeXt document.\stopsection\stoptext</context>
&rarr; [[Second Step]]{{Getting started navbox}}

Navigation menu