|
|
(3 intermediate revisions by 3 users not shown) |
Line 1: |
Line 1: |
− | < [[First Document]] | [[Detailed Example]] | [[Basics]] >
| |
− |
| |
− |
| |
− | 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: 22020.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>:
| |
− |
| |
− | <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.
| |
− |
| |
| == Modifying the output style == | | == Modifying the output style == |
| | | |