847
edits
Changes
Jump to navigation
Jump to search
__NOTOC__= Download =Since April 2019, there is a new major version of ConTeXt, named '''ConTeXt LMTX'''. <ul id="DownloadRework">
It is a new implementation tuned for LuaMetaTeX TeX engine, the lean and mean successor of the LuaTeX TeX engine (see <li>=== Windows ===* X86 [https://tuglmtx.pragma-ade.com/install-lmtx/context-mswin.orgzip 32bits]* X86 [https:/TUGboat/tb40lmtx.pragma-1ade.com/tb124hageninstall-lmtx/context-win64.pdf articlezip 64bits])* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-windows-arm64.zip 64bits]</li>
<ul style="display== macOS ===* X86 [https: grid;grid//lmtx.pragma-templateade.com/install-columns: repeat(autolmtx/context-fit, minmax(20em, 1fr)); gridosx-gap64.zip 64bits]* ARM [https:3rem; justify//lmtx.pragma-content: spaceade.com/install-lmtx/context-between;listosx-style: none;padding: 0px;margin: 0px; ">arm64.zip 64bits]</li style="height: stretch; padding: 10px; background-color: #f6f6f6; ">
=== #1- Download === <ul class="DownloadRework"li>
<li class="DownloadRework" style="text-align:left;">=== ⯆ GNU/Linux ===<ul style="text-align:left;"><li>* 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]</li><li>* 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></ul>
<li class="DownloadRework" style="text-align:left;">
=== ⯆ Free BSD ===
<ul style="text-align:left;">
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32b] (untested)</li>
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.zip 64b]</li>
<li class="DownloadRework" style="text-align:left;">
=== ⯆ OpenBSD6.5 ===
<ul style="text-align:left;">
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5.zip 32b] (untested)</li>
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5-amd64.zip 64b]</li>
</li>
<li class="DownloadRework" style="text-align:left;">
=== ⯆ OpenBSD6.6 ===
<ul style="text-align:left;">
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6.zip 32b] (untested)</li>
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6-amd64.zip 64b]</li>
</ul>
</li>
</ul>
# Create == Creation of a directory for, e.g. data/contextfirst ConTeXt file ==# Go there and download the relevant zip for your plateform (see aside) # Unpack the zipOpen a [[Text Editors|text editor]], some files will appear# Execute type the install programfollowing content, which will take care of downloading and save the distribution:#* WINDOWS: <code>install.bat</code>#* UNIX: <code>install.sh</code> (set the executable permissions)# 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 file as <code>echo 'export PATH=doc01...thepathinstructions...:$PATH' >> ~/.bashrctex</code>::: Sh/Ksh shell <code>echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.profile</code>::: Tcsh/csh shell <code>echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc</code></li>
* Download == Compilation of the tex input ConTeXt file [[Media:Hello-world.tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]]* Run <code>context Hello-world.tex</code> in your shell* Check the pdf output <code>Hello-world.pdf</code>.to PDF file ==
You can also follow our two steps tutorialGo to the command-line and type:* [[First Document| Your 1st document]]* and a more [[Detailed Example|Detailed example]]
=== #4-Update ? ===ConTeXt will then process your document, display some logging information on the console, and generate a <tt>doc01.pdf</tt> output file.
Just replay the install program, it also take care of updating the distribution:* WINDOWS: <codepre>install.bat</codenowiki>* UNIXresolvers | 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: <code>installinput="./doc01.sh<tex" --c:kindofrun=1 --c:maxnofruns=9 --c:texmfbinpath="/home/myuser/context/tex/texmf-linux-64/codebin"system > (set the executable permissions)<system > ConTeXt ver: 2024.04.01 08:59 LMTX fmt: 2024.4.13 int: english/li>english</ulsystem >
=== Official installation page ===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>
The official page '''[http://www.pragma-ade.com/install.htm Installing 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].== Viewing the generated PDF file ==
* [[Installing ConTeXt LMTX on MacOS]]Note that the section has been numbered, the section number and the section title appear in a slightly larger fonts.
----= Additional instructions =
{{Installation navbox}}* [[Installing ConTeXt LMTX on MacOS]]* [[Modules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]]* The 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 [[ConTeXt_Standalone|detailed 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>
no edit summary
<li>
</li>
<li class="DownloadRework" style="text-align:left;"> === ⯆ Windows FreeBSD ===<ul style="text-align:left;"><li>* 14.0 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-mswin.zip 32b]</li><li>[http://lmtx.pragmafreebsd-ade.nl/install-lmtx/context-win64amd64.zip 64b64bits]</li></ul>
</li>
<li class="DownloadRework" style="text-align:left;"> === ⯆ MacOS OpenBSD ===<ul style="text-align:left;"><li>* 7.4 [httphttps://lmtx.pragma-ade.nl/install-lmtx/context-osxopenbsd-64amd64.zip 64b64bits]</li></ul>
</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 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
= Upgrade =
Re-run the install program to upgrade, which will update the distribution incrementally:
* Windows: <ul style="displaycode>install.bat</code>* GNU/Linux or macOS: grid;grid-template-columns: repeat(auto-fit, minmax(25em, 1fr)); grid-gap:3rem; justify-content: space-between;list-style: none;padding: 0px;margin: 0px; "<code>sh install.sh<li style="height: stretch; padding: 10px; background-color: #f6f6f6; "/code>=== #2- Installation ===
= First document =
<li style="height: stretch; padding: 10px; background-color: #f6f6f6; "texcode>\setuppapersize[A6]\starttext\startsection[title=== #3- First Run with {Testing ConTeXt}]This is my first ConTeXt ! ===document.\stopsection\stoptext</texcode>
<pre>context doc01</pre>
…
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== Further installation instructions ==={Testing ConTeXt}]This is my first ConTeXt document.\stopsection\stoptext</context>
Your installation is now up and running: you can start working on the [[Tutorials]].
[[Category:StandaloneBasics]][[Category:Installation]]
