<li>
=== MacOS macOS ===
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-osx-64.zip 64bits]
* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-osx-arm64.zip 64bits]
See the next sections for instructions specific to various platforms.
== Unix GNU/Linux ==
The steps in this section show how to download and install ConTeXt for a 64-bit Linux system. Change the archive file download link as needed for your target platform. Open a new terminal then run the following commands:
# <code>mkdir $HOME/context# </code> and <code>cd $HOME/context</code># <code>wget https://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip</code># <code>unzip context-linux-64.zip</code># <code>sh install.sh</code># Update the PATH environment variable by using the path instructions displayed when the install program finishes. The instructions will vary depending on the type of shell being used:#* <kbd>'''Bash: '''</kbd> <code>echo 'export PATH=...instructions...:$PATH' >> ~/.bashrc</code>#* <kbd>'''Zsh: '''</kbd> <code>echo 'export PATH=...instructions...:$PATH' >> ~/.zshenv</code>#* <kbd>'''Sh/Ksh: '''</kbd> <code>echo 'export PATH=...instructions...:$PATH' >> ~/.profile</code>#* <kbd>'''Tcsh/csh:'''</kbd> <code>echo 'set path = ($path ...instructions...)' >> ~/.cshrc</code>#* For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable: <code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code># Then generate the cache with <code>mtxrun --generate</code>.# <code>rm context-linux-64.zip</code>
Update the PATH environment variable by using the path instructions displayed when the install program finishes. The instructions will vary depending on the type of shell being used: * '''Bash''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.bashrc</code>* '''Zsh''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.zshenv</code>* '''Sh'''/'''Ksh''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.profile</code>* '''Tcsh'''/'''csh''': <code>echo 'set path = ($path ...instructions...)' >> ~/.cshrc</code> For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable: <code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code> Then generate the cache with <code>mtxrun --generate</code>.== MacOS macOS ==
The instructions for MacOS are the same as for Unix, but note that:
* MacOS versions before Catalina use '''Bash''' by default.
* You might need to de-quarantine the binaries (and sometimes every created PDF):
** <code>sudo xattr -r -d com.apple.quarantine bin/mtxrun</code> ** <code>sudo xattr -r -d com.apple.quarantine tex/texmf-osx-64/bin/*</code>
== Windows ==
Complete the following steps to set up ConTeXt on Windows:
# Create a directory for ConTeXt, such as `<code>C:\context`</code>.
# Download the architecture-specific version into the ConTeXt directory.
# Extract the archive.
# Run: <code>install.bat</code>
# Run: <code>setpath.bat</code>
# Then generate the cache with the command <code>mtxrun --generate</code> in a command prompt.
# Delete the file archive file context-*win*.zip.
Installation is complete.= Check the installation =
Make sure that ConTeXt is installed on your system. To check that, go to the command prompt and type
= First document = context --version
Make sure that ConTeXt is installed on your system. To check that, go to the command line and typeYou should get an output as follows:
<pre> mtx-context | ConTeXt Process Management 1.06 mtx-context | mtx-context | main context file: /home/myuser/context/tex/texmf-context/tex/context/base/mkiv/context.mkiv mtx-context | current version<: 2024.04.01 08:59 mtx-context | main context file: /home/myuser/context/tex/texmf-context/tex/context/base/mkxl/pre>context.mkxl mtx-context | current version: 2024.04.01 08:59
You should get an output as follows:<pre>mtx-context | ConTeXt Process Management 1.03mtx-context |= Upgrade =mtx-context | main context file: /opt/context-minimals/texmf-context/tex/context/base/mkiv/context.mkivmtxRe-context | current versionrun the install program to upgrade, which will update the distribution incrementally: 2020.01.30 14:13</pre>
If ConTeXt is not installed on your system, check the [[Installation|installation]] page for installation instructions* Windows: <code>install.bat</code>* GNU/Linux or macOS: <code>sh install.sh</code>
Follow the steps below to create a simple = First document using ConTeXt:=
== Create Creation of a first ConTeXt file ==
Open a [[Text Editors|text editor]], type the following content, and save the file as <code>hellodoc01.tex</code> or <code>hello.mkxl</code>:
<texcode>\setuppapersize[A6]\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 = Compilation 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 to PDF file ==
Go to the command-line and type:
<pre>context hellodoc01</pre>
ConTeXt will then process your document, display some logging information on the console, and generate a <tt>hellodoc01.pdf</tt> output file.
<pre><nowiki>
mtx-context resolvers | formats | executing runner 'run 1luametatex format': luatex /home/myuser/context/tex/texmf-linux-64/bin/luametatex --jobname="./doc01.tex" --socket --shell-escape --fmt="/home/adityammyuser/.cachecontext/tex/contexttexmf-minimalscache/luatexluametatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luatexluametatex/cont-en" --jobname="hello" .fmt --lua="/home/adityammyuser/context/.cachetex/contexttexmf-minimalscache/luatexluametatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luatexluametatex/cont-en.lui" --c:currentrun=1 --c:fulljobname="./hellodoc01.tex" --c:input="./hellodoc01.tex" --c:kindofrun=1 --c:maxnofruns=9 --c:texmfbinpath="/opthome/myuser/context-minimals/tex/texmf-linux-64/bin" "cont-yessystem > system > ConTeXt ver: 2024.04.01 08:59 LMTX fmt: 2024.4.mkiv"13 int: english/englishsystem >
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 lua stats > system > ConTeXt verused engine: luametatex version: 20192.0711.24 1102, functionality level: 20240311, format id: 700, compiler:17 MKIV beta gccmkiv lua stats fmt> tex properties: 2019.8.17 int807100 hash slots used of 2097152, 51019 control sequences, approximate memory usage: english/english......42 MBmkiv lua stats > lua properties: engine: lua 5.35, used memory: 94 57 MB, ctx: 93 54 MB, max: unknown 54 MB), hash chars: min(64,40), symbol mask: utf (τεχ)mkiv lua stats > runtime: 0.833 617 seconds, 1 processed pages, 1 shipped pages, 1.200 620 pages/secondsystem | total runtime: 41.989 seconds of 2.485 052 seconds
</nowiki></pre>
== View Viewing the generated PDF file ==
Open the generated <tt>hellodoc01.pdf</tt> PDF file using a [http://en.wikipedia.org/wiki/List_of_PDF_software#Viewers PDF viewer]. It should look as follows:
<context modeforce="mkivyes">% Draw a white frame so that the page is not truncated. % But it does not seem to work :( \setupbackgrounds[text]setuppapersize[frame=onA6]
\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. == Running MkIV ==
The new distribution has all the files to run the previous version of ConTeXt.* Run <code>context --luatex Hello-world.tex</code> to use Your installation is now up and running: you can start working on the `luatex` binary and [[MkIVTutorials]].
= Upgrade = Re-run the install program to upgrade, which will update the distribution incrementally: * Windows: <code>install.bat</code>* Unix: <code>sh install.sh</code> = Further installation Additional instructions =
* [[Installing ConTeXt LMTX on MacOS]]
* The official page '''[http://www.pragma-ade.nl/install.htm Installing ConTeXt LMTX ]''' is hosted by Pragma ADE.
* Pragma ADE also provides the '''[http://www.pragma-ade.nl/download-1.htm ConTeXt MkIV distribution]''' (version MkIV is the predecessor of LMTX) for which there are also [[ConTeXt_Standalone|detailed installation instructions]].
* Compilation with ConTeXt MkIV (old LuaTeX-based version): The new distribution has all the files to run the previous version of ConTeXt.
** <code>context --luatex doc01</code>
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.
----
{{Installation navbox}}
[[Category:Basics]]
[[Category:Installation]]