Changes

Most = Download = <ul id="DownloadRework"> <li>=== Windows ===* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-mswin.zip 32bits]* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-win64.zip 64bits]* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-windows-arm64.zip 64bits]</li> <li> === 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]</li> <li> === GNU/Linux ===* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-linux.zip 32bits]* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip 64bits]* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-linux-aarch64.zip 64bits]* Musl [https://lmtx.pragma-ade.nl/install-lmtx/context-linuxmusl-64.zip 64bits]</li>  <li> === FreeBSD ===* 14.0 [TeX Distributionshttps://lmtx.pragma-ade.com/install-lmtx/context-freebsd-amd64.zip 64bits]</li> <li> === OpenBSD ===* 7.4 [https://lmtx.pragma-ade.nl/install-lmtx/context-openbsd-amd64.zip 64bits] include an installation </li></ul></li> </ul> </li></ul>  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# 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>#* <kbd>'''Tcsh/csh:'''</kbd> <code>echo 'set path = ($path ...instructions...)' >> ~/.cshrc</code>#* For example, if ConTeXt already 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 -- try running 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>** <ttcode>texexec 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 versioninto the ConTeXt directory.# Extract the archive.# Run: <code>install.bat</ttcode># Run: <code>setpath.bat</code># Then generate the cache with the command <code>mtxrun --generate</code> to see if it's 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 upgrade check that, go to a 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 with : 2024.04.01 08:59 = Upgrade = Re-run the install program to upgrade, which will update the latest features and bugfixesdistribution incrementally: * By operating systemWindows:<code>install.bat</code>** GNU/Linuxor macOS: <code>sh install.sh</code> = First document = == Creation of a first ConTeXt file == *** Open a [[Debian_installationText Editors|Debiantext editor]], type the following content, and save the file as <code>doc01.tex</code>: <texcode>*** \setuppapersize[A6]\starttext\startsection[Ubuntu_installationtitle={Testing ConTeXt}]This is my first ConTeXt document.\stopsection\stoptext</texcode> == Compilation of the ConTeXt file to PDF file == Go to the command-line and type: <pre>context doc01</pre> ConTeXt will then process your document, display some logging information on the console, and generate a <tt>doc01.pdf</tt> output file. <pre><nowiki>resolvers |Ubuntuformats | 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:input="./doc01.tex" --c:kindofrun=1 --c:maxnofruns=9 --c:texmfbinpath="/home/myuser/context/tex/texmf-linux-64/bin"system > system > ConTeXt ver: 2024.04.01 08:59 LMTX fmt: 2024.4.13 int: english/englishsystem >  … 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> == 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="yes">\setuppapersize[A6]*** \starttext\startsection[[Linux Installation|other distributions]title={Testing ConTeXt}]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.** Your installation is now up and running: you can start working on the [[Mac Installation|MacTutorials]]. = Additional instructions = ** [[Windows Installation|WindowsInstalling ConTeXt LMTX on MacOS]]** [[OpenBSD installationModules#ConTeXt_LMTX|OpenBSDInstalling Modules for ConTeXt LMTX]]* From sourceThe 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 [[teTeX 3.0 ConTeXt_Standalone|detailed installationinstructions]].* Compilation with ConTeXt MkIV (old LuaTeX-based version): Specific installation instructions using The new distribution has all the files to run the teTeX 3.0 source distributionprevious version of ConTeXt.** <code>context --luatex doc01</code>  [[TeX-live | TeX-live installationCategory:Basics]]: Specific installation instructions using the TeX-live source distribution.* [[Category:Installation hints]]