Difference between revisions of "Installation"
m (→Windows) |
m (→Easy update) |
||
Line 125: | Line 125: | ||
Moreover, a page is used to centralized [[Sample documents]]. | Moreover, a page is used to centralized [[Sample documents]]. | ||
− | = | + | = 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 = | = Running MkIV = |
Revision as of 20:23, 6 March 2021
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 article).
Download
-
Windows
-
MacOS
-
GNU/Linux
-
FreeBSD
-
OpenBSD6.7
-
OpenBSD6.8
You can 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.
- Optionally, delete the archive file.
See the next sections for instructions specific to various platforms.
Unix
The steps in this section show how to download and install ConTeXt for a 64-bit Linux system. Change archive file download link as needed for your target platform. Open a new terminal then run the following commands:
- mkdir $HOME/bin/context
- cd $HOME/bin/context
- wget http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip
- unzip context-linux-64.zip
- sh install.sh
Update the PATH environment variable by using the instructions displayed by the install program. The instructions will vary depending on the type of shell being used:
- Bash:
echo 'export PATH=...instructions...:$PATH' >> ~/.bashrc
- Zsh:
echo 'export PATH=...instructions...:$PATH' >> ~/.zshenv
- Sh/Ksh:
echo 'export PATH=...instructions...:$PATH' >> ~/.profile
- Tcsh/csh:
echo 'set path = ($path ...instructions...)' >> ~/.cshrc
For example, if ConTeXt was downloaded into $HOME/bin/context
on a system running bash, then the following line would update the PATH environment variable:
echo 'export PATH=$HOME/bin/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc
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 instructions 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:
install.bat
- Run:
setpath.bat
- Optionally, delete the archive file.
Installation is complete.
First Run !
- Download the tex input file Hello-World.tex from our Detailed example
- Run
context Hello-world.tex
in your shell - Check the pdf output
Hello-world.pdf
.
You can also follow our two steps tutorial:
- Your 1st document
- and a more Detailed example
Moreover, a page is used to centralized Sample documents.
Upgrade
Re-run the install program to upgrade, which will update the distribution incrementally:
- Windows:
install.bat
- Unix:
sh install.sh
Running MkIV
The new distribution still has all the files to run the previous version of ConTeXt.
- Run
context --luatex Hello-world.tex
in your shell to revert back to theluatex
binary and MkIV.
Further installation instructions
- Installing ConTeXt LMTX on MacOS
- Installing Modules for ConTeXt LMTX
- The official page Installing CONTEXT LMTX is hosted by Pragma-Ade.
- Pragma-Ade also provides the CONTEXT MKIV distribution (MKIV version is LMTX predecessor) for which there is also detailed Installation instructions.
|