Changes

Jump to navigation Jump to search
m
re-add Linux 32bit link
__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 =
<ul classid="DownloadRework">
<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 ===
* 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]* ARM Musl [httphttps://lmtx.pragma-ade.nl/install-lmtx/context-linuxlinuxmusl-aarch6464.zip 64b64bits]
</li>
<li>
 === Free BSD FreeBSD ===* [http://lmtx14.pragma-ade.nl/install-lmtx/context-freebsd.zip 32bits] ** 0 [httphttps://lmtx.pragma-ade.nlcom/install-lmtx/context-freebsd-amd64.zip 64bits]
</li>
<li>
 === 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]
</li>
 
<li>
=== OpenBSD6.6 ===
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6.zip 32bits] *
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6-amd64.zip 64bits]
</ul>
</li>
</li>
</ul>
<nowiki>*</nowiki>untested configuration.
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).
= #2. Installation =
The general steps to install ConTeXt LMTX are as follows:
# Create a directory for, e.gConTeXt. data/context# Go there and download Download the relevant zip for your plateform (see above)platform-specific archive file into the ConTeXt directory.# Unpack the zip, some files will appeararchive.# Execute the install program, which will take care of downloading downloads the distribution:#* WINDOWS: <code>install.bat</code>#* UNIX: <code>install.sh</code> (set Update the executable permissions)# Add ConTeXt to your system PATH :environment variable.#* WINDOWS: run <code>setpath.bat</code>Generate cache#* UNIX: use Optionally, delete 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...)' >> ~/archive file.cshrc</code>
= #3See the next sections for instructions specific to various platforms. First Run ! =
* Download the tex input 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>.== Unix ==
You can also follow our two The steps tutorial:* [[First Document| Your 1st document]]* in this section show how to download and install ConTeXt for a more [[Detailed Example|Detailed example]]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:
# mkdir $HOME/context
# cd $HOME/context
# wget https://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip
# unzip context-linux-64.zip
# sh install.sh
= #4Update the PATH environment variable by using the path instructions displayed when the install program finishes. Easy update =The instructions will vary depending on the type of shell being used:
For an update, just replay the install program* '''Bash''': it also take care of updating the distribution incrementally<code>echo 'export PATH=...instructions...:$PATH' >> ~/.bashrc</code>* WINDOWS'''Zsh''': <code>installecho 'export PATH=...instructions...bat:$PATH' >> ~/.zshenv</code>* UNIX'''Sh'''/'''Ksh''': <code>installecho 'export PATH=...instructions...:$PATH' >> ~/.shprofile</code> * '''Tcsh'''/'''csh''': <code>echo 'set path = (set the executable permissions$path ...instructions...)' >> ~/.cshrc</code>
= Official installation page =For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable:
The official page <code>echo '''[http:export PATH=$HOME/context/www.pragma-ade.com/install.htm Installing CONTEXT LMTX ]''' is hosted by Pragma-Ade, which also provides* a 2 pages '''[http:/tex/lmtx.pragmatexmf-ade.nl/installlinux-lmtx64/installation.pdf installation guide]bin:$PATH''',* 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/docbashrc</context/documents/general/leaflets/leaflet-luametatex.pdf leaflet for LuaMetaTeX].code>
Then generate the cache with
<code>mtxrun --generate</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.
 
== Windows ==
 
Complete the following steps to set up ConTeXt on Windows:
 
# Create a directory for ConTeXt, such as `C:\context`.
# Download the architecture-specific version into the ConTeXt directory.
# Extract the archive.
# Run: <code>install.bat</code>
# Run: <code>setpath.bat</code>
 
Installation is complete.
 
= First Run =
 
This section describes how to run ConTeXt to transform your first TeX document into a PDF.
 
# Download the tex input file [[Media:Hello-world.tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]].
# Run <code>context Hello-world.tex</code> in your terminal (or command prompt).
# Check the PDF output <code>Hello-world.pdf</code>.
 
Additional tutorials include:
 
* [[First Document| Your first document]]
* [[Detailed Example|Detailed example]]
 
See the [[Sample documents]] page for even more examples.
 
= Upgrade =
 
Re-run the install program to upgrade, which will update the distribution incrementally:
 
* Windows: <code>install.bat</code>
* Unix: <code>sh install.sh</code>
 
= Running MkIV =
 
The new distribution has all the files to run the previous version of ConTeXt.
* Run <code>context --luatex Hello-world.tex</code> to use the `luatex` binary and [[MkIV]].
= Further installation instructions =
* [[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]].
{{Installation navbox}}
[[Category:Basics]][[Category:StandaloneInstallation]]

Navigation menu