Changes

Since April 2019, there is a new implementation of ConTeXt, named '''ConTeXt [[LMTX]]'''. It is tuned for LuaMetaTeX, the lean and mean successor of LuaTeX TeX engine (see [https://tug.org/TUGboat/tb40-1/tb124hagen-lmtx.pdf article]).

= #1. Download =

* X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-mswin.zip 32bits]* X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-win64.zip 64bits]* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-windows-arm64.zip 64bits]

* X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-osx-64.zip 64bits]* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-osx-arm64.zip 64bits]

* X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-linux.zip 32bits]* X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-linux-64.zip 64bits]* ARM [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-linux-armhfaarch64.zip 32bits64bits]* ARM Musl [httphttps://lmtx.pragma-ade.nl/install-lmtx/context-linuxlinuxmusl-aarch6464.zip 64bits]

* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd14.zip 32bits] ** 0 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-freebsd-amd64.zip 64bits]

 === OpenBSD6.5 OpenBSD ===* [http://lmtx7.pragma-ade.nl/install-lmtx/context-openbsd6.5.zip 32bits] ** 4 [httphttps://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5openbsd-amd64.zip 64bits]

= 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.#2Update the PATH environment variable. Installation # Generate cache# Optionally, delete the archive file. See the next sections for instructions specific to various platforms. == Unix ==

# Create a directory for, e.g. datamkdir $HOME/context# Go there and download the relevant zip for your plateform (see above)cd $HOME/context# Unpack the zip, some files will appear# Execute the install program, which will take care of downloading the distributionwget https:#* WINDOWS: <code>install.bat</code>#* MAC: #** If MacOS Catalina (10/lmtx.15+), first allow mtxrun as unsigned executable with <code>xattr pragma-d ade.com.apple.quarantine /install-lmtx/context-osxlinux-64/bin/mtxrun</code>.zip#** execute <code>sh installunzip context-linux-64.sh</code>zip#* UNIX: <code>sh install.sh</code># Add ConTeXt to your system PATH :#* WINDOWS: run <code>setpath.bat</code>#* UNIX: use the PATH instructions provided at the end of <code>install.sh</code> with:#** Bash shell <code>echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.bashrc</code>#** Sh/Ksh shell <code>echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.profile</code>#** Tcsh/csh shell <code>echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc</code>

= #3Update the PATH environment variable by using the path instructions displayed when the install program finishes. First Run ! =The instructions will vary depending on the type of shell being used:

* Download the tex input file [[Media'''Bash''':Hello-world<code>echo 'export PATH=...instructions..tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]]:$PATH' >> ~/.bashrc</code>* Run '''Zsh''': <code>context Hello-worldecho 'export PATH=...instructions...tex:$PATH' >> ~/.zshenv</code> in your shell* Check the pdf output '''Sh'''/'''Ksh''': <code>Hello-worldecho 'export PATH=.pdf..instructions...:$PATH' >> ~/.profile</code>* '''Tcsh'''/'''csh''': <code>echo 'set path = ($path ...instructions...)' >> ~/.cshrc</code>

You can also follow our two steps tutorialFor example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable:* [[First Document| Your 1st document]]* and a more [[Detailed Example|Detailed example]]

Then generate the cache with <code>mtxrun --generate</code>.== MacOS = #4. Easy update =

For an updateThe instructions for MacOS are the same as for Unix, just replay the install program: it also take care of updating the distribution incrementallybut note that:* WINDOWS: <code>install.bat</code>* UNIX: <code>install.sh</code> (set the executable permissions)

# Create a directory for ConTeXt, such as `C:\context`.# Download the architecture-specific version into the ConTeXt directory.# Extract the archive.# Run: <code>install.bat</code># Run: <code>setpath.bat</code> Installation is complete. = Further installation instructions First Run = This section describes how to run ConTeXt to transform your first TeX document into a PDF. # Download the tex input file [[Media:Hello-world.tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]].# Run <code>context Hello-world.tex</code> in your terminal (or command prompt).# Check the PDF output <code>Hello-world.pdf</code>. Additional tutorials include: * [[First Document| Your first document]]* [[Detailed Example|Detailed example]] See the [[Sample documents]] page for even more examples. = Upgrade = Re-run the install program to upgrade, which will update the distribution incrementally:

Recent versions of MacOS prevent * Windows: <code>mtxruninstall.bat</code> from running because it is not a signed executable* Unix: <code>sh install. You have at least two options to bypass such restrictions:sh</code>

The following page describes another, more involved, procedure that achieves new distribution has all the same result:files to run the previous version of ConTeXt. * Run <code>context --luatex Hello-world.tex</code> to use the `luatex` binary and [[MkIV]]. = Further installation instructions =

[[Category:Basics]][[Category:StandaloneInstallation]]