Changes

__NOTOC__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]

 === MacOS macOS ===* 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.# Update the PATH environment variable.# Generate cache# Optionally, delete the archive file. See the next sections for instructions specific to various platforms. == 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>#2* <kbd>'''Tcsh/csh:'''</kbd> <code>echo 'set path = ($path ...instructions. Installation ..)' >> ~/.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> == 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

# Create a directory for, e.g. data/context# Go there and download the relevant zip for your plateform (see above)# Unpack the zip, some files will appear# Execute Re-run the install programto upgrade, which will take care of downloading update the distributionincrementally:#* WINDOWS: <code>install.bat</code>#* UNIX: <code>install.sh</code> (set the executable permissions)#* MacOS: see '''Further installation instructions''' below before running <code>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>

= #3* Windows: <code>install. First Run ! =bat</code>* GNU/Linux or macOS: <code>sh install.sh</code>

You can also follow our two steps tutorial:== Creation of a first ConTeXt file ==* [[First Document| Your 1st document]] * and Open a more [[Detailed ExampleText Editors|Detailed exampletext editor]], type the following content, and save the file as <code>doc01.tex</code>:

= #4. Easy update = Compilation of the ConTeXt file to PDF file ==

For an update, just replay Go to the install programcommand-line and type: it also take care of updating the distribution incrementally:* WINDOWS: <code>install.bat</code>* UNIX: <code>install.sh</code> (set the executable permissions)

The official page '''[http://www.pragma-ade.com/install.htm Installing CONTEXT LMTX ]''' is hosted by Pragma-AdeConTeXt will then process your document, which also provides* a 2 pages '''[http://lmtx.pragma-ade.nl/install-lmtx/installation.pdf installation guide]'''display some logging information on the console,* and generate a 1 page [http://distribution.contextgarden.net/current/context/experimental/doc/context/documents/general/leaflets/leaflet-context<tt>doc01.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]tt> output file.

Recent versions 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 MacOS prevent 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<code/nowiki>mtxrun</codepre> from running because it is not a signed executable. You have at least two options to bypass such restrictions:

* execute <code>xattr -d com.apple.quarantine context-osx-64/bin/mtxrun</code>, or* (not recommended) go to System Preferences > Security & Privacy > Privacy tab > Developer Tools, and allow Terminal to run software that does not meet == Viewing the system's security policy.generated PDF file ==

The following page describes another, more involved, procedure that achieves Open the same resultgenerated <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="yes">\setuppapersize[A6]\starttext\startsection[Installing title={Testing ConTeXt LMTX on MacOS]}]This is my 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.

[[Category:StandaloneBasics]][[Category:Installation]]