765
edits
Changes
no edit summary
= 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 [https://lmtx.pragma-ade.com/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 [https://lmtx.pragma-ade.com/install-lmtx/context-osx-arm64.zip 64bits]
</li>
<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 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-linux-armhfaarch64.zip 32b64bits]|* Musl [httphttps://lmtx.pragma-ade.nl/install-lmtx/context-linuxlinuxmusl-aarch6464.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>
</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:
# Create a directory for, e.g. data<code>mkdir $HOME/context# Go there </code> and download the relevant zip for your plateform (see above)# Unpack the zip, some files will appear# Execute the install program, which will take care of downloading the distribution:#* WINDOWS: <code>install.batcd $HOME/context</code>#* MAC: #** If MacOS Catalina (10.15+), first allow mtxrun as unsigned executable with:#*: <code>xattr wget https://lmtx.pragma-d ade.com.apple.quarantine /install-lmtx/context-osxlinux-64/bin/mtxrun.zip</code>#** execute <code>sh installunzip context-linux-64.shzip</code>#* UNIX: <code>sh install.sh</code># 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</code>
= First Run ! = macOS ==
* MacOS versions from Catalina (10.15) and newer use '''Zsh''' by default.* MacOS versions before Catalina use '''Bash''' by default.* You can also follow our two steps tutorialmight need to de-quarantine the binaries (and sometimes every created PDF):* [[First Document| Your 1st document]]* <code>sudo xattr -r -d com.apple.quarantine bin/mtxrun</code>* and a more [[Detailed Example|Detailed example]]* <code>sudo xattr -r -d com.apple.quarantine tex/texmf-osx-64/bin/*</code>
= Further Check the installation instructions =
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>:
<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 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 | 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: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/english
system >
…
mkiv lua stats > used engine: luametatex version: 2.11.02, functionality level: 20240311, format id: 700, compiler: gcc
mkiv lua stats > tex properties: 807100 hash slots used of 2097152, 51019 control sequences, approximate memory usage: 42 MB
mkiv 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/second
system | 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[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 [[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-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]ADE.* 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>
[[Category:Basics]]
[[Category:Installation]]