__NOTOC__Since April 2019, there is a new major version of ConTeXt, named '''ConTeXt LMTX'''. It is a new implementation tuned for LuaMetaTeX TeX engine, the lean and mean successor of the LuaTeX TeX engine (see [https://tug.org/TUGboat/tb40-1/tb124hagen-lmtx.pdf article]).You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation). = #1. Download =
<ul classid="DownloadRework">
<li class="DownloadRework" style="text-align:left;">
=== Windows ===
<ul style="text-align:left;"><li>* X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-mswin.zip 3232bits]</li><li>* X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-win64.zip 6464bits]<* ARM [https:/li></ul>lmtx.pragma-ade.com/install-lmtx/context-windows-arm64.zip 64bits]
</li>
<li class="DownloadRework" style="text-align:left;"> === MacOS macOS ===<ul style="text-align:left;"><li>* X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-osx-64.zip 6464bits]<* ARM [https://lmtx.pragma-ade.com/li><install-lmtx/ul>context-osx-arm64.zip 64bits]
</li>
<li class="DownloadRework" style="text-align:left;">
=== GNU/Linux ===
<ul style="text-align:left;"><small><li>* X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-linux.zip 3232bits] | * X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-linux-64.zip 6464bits]</li><li>* ARM [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-linux-armhfaarch64.zip 3264bits] | * Musl [httphttps://lmtx.pragma-ade.nl/install-lmtx/context-linuxlinuxmusl-aarch6464.zip 6464bits]</li></small></ul>
</li>
<li class="DownloadRework" style="text-align:left;"> === Free BSD =FreeBSD ==<ul style="text-align:left;"><li>[http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd* 14.zip 32] (untested)</li><li>0 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-freebsd-amd64.zip 6464bits]</li></ul>
</li>
<li class="DownloadRework" style="text-align:left;"> === OpenBSD6.5 OpenBSD ===<ul style="text-align:left;"><li>[http://lmtx* 7.pragma-ade.nl/install-lmtx/context-openbsd6.5.zip 32] (untested)</li><li>4 [httphttps://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5openbsd-amd64.zip 6464bits]</li></ul>
</li>
<li class="DownloadRework" style="text-align:left;">
=== OpenBSD6.6 ===
<ul style="text-align:left;">
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6.zip 32] (untested)</li>
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6-amd64.zip 64]</li>
</ul>
</li>
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation). = Installation = The general steps to install ConTeXt LMTX are as follows: # Create a directory for ConTeXt.# Download the platform-specific archive file into the ConTeXt directory.# Unpack the archive.# Execute the install program, which downloads the distribution.# Update the PATH environment variable.# Generate cache#2Optionally, delete the archive file. Installation =
See the next sections for instructions specific to various platforms.
# Create a directory for, e.g. data== GNU/contextLinux == # Go there The steps in this section show how to download and install ConTeXt for a 64-bit Linux system. Change the archive file download the relevant zip link as needed for your plateform (see aside)target platform. Open a new terminal then run the following commands: # Unpack the zip, some files will appear<code>mkdir $HOME/context</code> and <code>cd $HOME/context</code># Execute the <code>wget https://lmtx.pragma-ade.com/install program, which will take care of downloading the distribution:-lmtx/context-linux-64.zip</code>#* WINDOWS: <code>installunzip context-linux-64.batzip</code>#* UNIX: <code>sh install.sh</code> (set the executable permissions)# Add ConTeXt to your system 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:#* WINDOWS<kbd>'''Bash: run '''</kbd> <code>setpathecho 'export PATH=...instructions...:$PATH' >> ~/.batbashrc</code>#* UNIX: use the PATH instructions provided at the end of <codekbd>install.sh'''Zsh: '''</codekbd> with:::: Bash shell <code>echo 'export PATH=...thepathinstructionsinstructions...:$PATH' >> ~/.bashrczshenv</code>::: #* <kbd>'''Sh/Ksh shell : '''</kbd> <code>echo 'export PATH=...thepathinstructionsinstructions...:$PATH' >> ~/.profile</code>::: #* <kbd>'''Tcsh/csh shell :'''</kbd> <code>echo 'set path = ($path ...thepathinstructionsinstructions...)' >> ~/.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</licode> == macOS == The instructions for MacOS are the same as for Unix, but note that: * MacOS versions from Catalina (10.15) and newer use '''Zsh''' by default.* 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. = Check the installation = Make sure that ConTeXt is installed on your system. To check that, go to the command prompt and type context --version You should get an output as follows: 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/context.mkxl mtx-context | current version: 2024.04.01 08:59 = Upgrade = Re-run the install program to upgrade, which will update the distribution incrementally: * Windows: <code>install.bat</code>* GNU/Linux or macOS: <code>sh install.sh</code> = First document = == Creation of a first ConTeXt file == Open a [[Text Editors|text editor]], type the following content, and save the file as <code>doc01.tex</code>:
<li styletexcode>\setuppapersize[A6]\starttext\startsection[title="height: stretch; padding: 10px; background-color: #f6f6f6; "{Testing ConTeXt}]This is my first ConTeXt document.\stopsection\stoptext</texcode>
= #3. First Run with = Compilation of the ConTeXt ! file to PDF file ==
* Download Go to the tex input file [[Mediacommand-line and type:Hello-world.tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]]* Run <code>context Hello-world.tex</code> in your shell* Check the pdf output <code>Hello-world.pdf</code>.
You can also follow our two steps tutorial:* [[First Document| Your 1st document]]* and a more [[Detailed Example|Detailed example]]<pre>context doc01</pre>
= #4ConTeXt will then process your document, display some logging information on the console, and generate a <tt>doc01.pdf</tt> output file. Easy update =
Just replay the install program, it also take care of updating the distribution:* WINDOWS: <codepre>install.bat</codenowiki>* UNIXresolvers | formats | executing runner 'run luametatex format': /home/myuser/context/tex/texmf-linux-64/bin/luametatex --jobname="./doc01.tex" --socket --shell-escape --fmt=/home/myuser/context/tex/texmf-cache/luametatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luametatex/cont-en.fmt --lua=/home/myuser/context/tex/texmf-cache/luametatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luametatex/cont-en.lui --c:currentrun=1 --c:fulljobname="./doc01.tex" --c: <code>installinput="./doc01.sh<tex" --c:kindofrun=1 --c:maxnofruns=9 --c:texmfbinpath="/home/myuser/context/tex/texmf-linux-64/codebin"system > (set the executable permissions)<system > ConTeXt ver: 2024.04.01 08:59 LMTX fmt: 2024.4.13 int: english/li>english</ulsystem >
…
= Official installation page =mkiv lua stats > used engine: luametatex version: 2.11.02, functionality level: 20240311, format id: 700, compiler: gccmkiv lua stats > tex properties: 807100 hash slots used of 2097152, 51019 control sequences, approximate memory usage: 42 MBmkiv lua stats > lua properties: engine: lua 5.5, used memory: 57 MB, ctx: 54 MB, max: 54 MB, symbol mask: utf (τεχ)mkiv lua stats > runtime: 0.617 seconds, 1 processed pages, 1 shipped pages, 1.620 pages/secondsystem | total runtime: 1.989 seconds of 2.052 seconds</nowiki></pre>
The official page '''[http://www.pragma-ade.com/install.htm Installing CONTEXT LMTX ]''' is hosted by Pragma-Ade, which also provides* a 2 pages '''[http://lmtx.pragma-ade.nl/install-lmtx/installation.pdf installation guide]''',* a 1 page [http://distribution.contextgarden.net/current/context/experimental/doc/context/documents/general/leaflets/leaflet-context.pdf leaflet for ConTeXt LMTX]* a 1 page [http://distribution.contextgarden.net/current/context/experimental/doc/context/documents/general/leaflets/leaflet-luametatex.pdf leaflet for LuaMetaTeX].== Viewing the generated PDF file ==
Open the generated <tt>doc01.pdf</tt> PDF file using a [http://en.wikipedia.org/wiki/List_of_PDF_software#Viewers PDF viewer]. It should look as follows:
<context force= Further installation instructions "yes">\setuppapersize[A6]\starttext\startsection[title={Testing ConTeXt}]This is my first ConTeXt document.\stopsection\stoptext</context>
* [[Installing ConTeXt LMTX on MacOS]]Note that the section has been numbered, the section number and the section title appear in a slightly larger fonts.
Your installation is now up and running: you can start working on the [[Tutorials]].
----= Additional instructions =
{{Installation navbox}}* [[Installing ConTeXt LMTX on MacOS]]* [[Modules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]]* 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>
[[Category:StandaloneBasics]][[Category:Installation]]