Open main menu

Changes

no edit summary
__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]).
 
= Download =
<li>
=== Windows ===
* 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 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-windows-arm64.zip 64bits]
</li>
<li>
=== MacOS macOS ===* X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-osx-64.zip 64bits]* ARM [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-osx-arm64.zip 64bits]
</li>
=== GNU/Linux ===
* X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-linux.zip 32b32bits]|* X86 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-linux-64.zip 64b64bits]* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-armhf.zip 32b]|[httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-linux-aarch64.zip 64b64bits]* Musl [httphttps://lmtx.pragma-ade.nl/install-lmtx/context-linuxmusl-64.zip 64b64bits]
</li>
=== FreeBSD ===
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd14.zip 32bits]* 0 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-freebsd-amd64.zip 64bits]
</li>
<li>
=== OpenBSD6.7 OpenBSD ===* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.7.zip 32bits]* 4 [httphttps://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.7-amd64.zip 64bits] <li> === OpenBSD6.8 ===* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.8.zip 32bits]* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.8openbsd-amd64.zip 64bits]
</li>
</ul>
= Installation =
The general steps to install ConTeXt LMTX are as follows: # Create a download directory (efor ConTeXt.g., downloads/context)# Download the relevant platform-specific archive for your platform file into the download ConTeXt directory (see above).# Unpack the archive, some files will appear.# Execute the install program, which will take care of downloading 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: #* WINDOWS: <code>install.batmkdir $HOME/context</code> and <code>cd $HOME/context</code>#* UNIX/MAC: <code>sh wget https://lmtx.pragma-ade.com/install-lmtx/context-linux-64.shzip</code># Add ConTeXt to your system PATH:#* WINDOWS: #** run <code>setpathunzip context-linux-64.batzip</code>#* UNIX: use the PATH instructions provided at the end of <code>sh install.sh</code> with# 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 shell : '''</kbd> <code>echo 'export PATH=...thepathinstructionsinstructions...:$PATH' >> ~/.bashrc</code>#** <kbd>'''Zsh shell : '''</kbd> <code>echo 'export PATH=...thepathinstructionsinstructions...:$PATH' >> ~/.zshenv</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>#* MACFor 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>#** Same 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. Unix, but note that: * MacOS versions from Catalina (10.15) defaults and newer use '''Zsh''' by default.* MacOS versions before Catalina use '''Bash''' by default.* You might need to `Zsh`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, earlier versions defaulted and save the file as <code>doc01.tex</code>: <texcode>\setuppapersize[A6]\starttext\startsection[title={Testing ConTeXt}]This is my first ConTeXt document.\stopsection\stoptext</texcode> == Compilation of the ConTeXt file to PDF file == Go to `Bash`the command-line and type: <pre>context doc01</pre>
= First Run ! =ConTeXt will then process your document, display some logging information on the console, and generate a <tt>doc01.pdf</tt> output file.
* Download the <pre><nowiki>resolvers | formats | executing runner 'run luametatex format': /home/myuser/context/tex input file [[Media:Hello/texmf-linux-64/bin/luametatex --worldjobname="./doc01.tex|Hello" --socket --shell-escape --fmt=/home/myuser/context/tex/texmf-cache/luametatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luametatex/cont-Worlden.fmt --lua=/home/myuser/context/tex]] from our [[Detailed_Example|Detailed example]]* Run <code>/texmf-cache/luametatex-cache/context Hello/5fe67e0bfe781ce0dde776fb1556f32e/formats/luametatex/cont-en.lui --c:currentrun=1 --worldc:fulljobname="./doc01.tex<" --c:input="./doc01.tex" --c:kindofrun=1 --c:maxnofruns=9 --c:texmfbinpath="/home/myuser/context/tex/texmf-linux-64/codebin"system > in your shell* Check the pdf output <codesystem >Hello-worldConTeXt ver: 2024.04.01 08:59 LMTX fmt: 2024.4.pdf<13 int: english/codeenglishsystem >.
You can also follow our two steps tutorial:* [[First Document| Your 1st document]]* and a more [[Detailed Example|Detailed example]]
Moreovermkiv lua stats > used engine: luametatex version: 2.11.02, functionality level: 20240311, format id: 700, a page is compiler: gccmkiv lua stats > tex properties: 807100 hash slots used to centralized [[Sample documents]]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>
= Easy update = Viewing the generated PDF file ==
For an update, just replay Open the install program: it also take care of updating the distribution incrementally:* WINDOWS: generated <codett>installdoc01.batpdf</codett>* UNIXPDF file using a [http: <code>sh install//en.wikipedia.sh<org/wiki/code>List_of_PDF_software#Viewers PDF viewer]. It should look as follows:
<context force= Running MkIV "yes">\setuppapersize[A6]\starttext\startsection[title={Testing ConTeXt}]This is my first ConTeXt document.\stopsection\stoptext</context>
The new distribution still Note that the section has all been numbered, the files to run section number and the previous version of ConTeXt. * Run <code>context --luatex Hello-world.tex</code> section title appear in your shell to revert back to the `luatex` binary and [[MkIV]]a slightly larger fonts.
= Further Your installation instructions =is now up and running: you can start working on the [[Tutorials]].
= Additional instructions =
* [[Installing ConTeXt LMTX on MacOS]]
* [[Modules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]]
* The official page '''[http://www.pragma-ade.comnl/install.htm Installing CONTEXT ConTeXt LMTX ]''' is hosted by Pragma-AdeADE.* Pragma-Ade ADE also provides the '''[http://www.pragma-ade.comnl/download-1.htm CONTEXT MKIV ConTeXt MkIV distribution]''' (MKIV version MkIV is the predecessor of LMTX predecessor) for which there is are also [[ConTeXt_Standalone|detailed Installation 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>
{{Installation navbox}}
[[Category:Basics]]
[[Category:Installation]]
765

edits