Difference between revisions of "Installation"
Lifepillar (talk | contribs) (Add a simpler way to install LMTX in MacOS, which does not require disabling SIP) |
m |
||
Line 62: | Line 62: | ||
# Execute the install program, which will take care of downloading the distribution: | # Execute the install program, which will take care of downloading the distribution: | ||
#* WINDOWS: <code>install.bat</code> | #* WINDOWS: <code>install.bat</code> | ||
− | #* | + | #* MAC: |
− | #* | + | #** If MacOS Catalina (10.15+), first allow mtxrun as unsigned executable with <code>xattr -d com.apple.quarantine context-osx-64/bin/mtxrun</code> |
+ | #** execute <code>sh install.sh</code> | ||
+ | #* UNIX: <code>sh install.sh</code> | ||
# Add ConTeXt to your system PATH : | # Add ConTeXt to your system PATH : | ||
#* WINDOWS: run <code>setpath.bat</code> | #* WINDOWS: run <code>setpath.bat</code> |
Revision as of 13:50, 30 May 2020
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).
#1. Download
-
Windows
-
MacOS
-
GNU/Linux
-
FreeBSD
-
OpenBSD6.5
-
OpenBSD6.6
*untested configuration.
You can read the licence (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).
#2. Installation
- Create a directory for, e.g. data/context
- Go there 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:
install.bat
- MAC:
- If MacOS Catalina (10.15+), first allow mtxrun as unsigned executable with
xattr -d com.apple.quarantine context-osx-64/bin/mtxrun
- execute
sh install.sh
- If MacOS Catalina (10.15+), first allow mtxrun as unsigned executable with
- UNIX:
sh install.sh
- WINDOWS:
- Add ConTeXt to your system PATH :
- WINDOWS: run
setpath.bat
- UNIX: use the PATH instructions provided at the end of
install.sh
with:- Bash shell
echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.bashrc
- Sh/Ksh shell
echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.profile
- Tcsh/csh shell
echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc
- Bash shell
- WINDOWS: run
#3. 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
#4. Easy update
For an update, just replay the install program: it also take care of updating the distribution incrementally:
- WINDOWS:
install.bat
- UNIX:
install.sh
(set the executable permissions)
Official installation page
The official page Installing CONTEXT LMTX is hosted by Pragma-Ade, which also provides
- a 2 pages installation guide,
- a 1 page leaflet for ConTeXt LMTX
- a 1 page leaflet for LuaMetaTeX.
Further installation instructions
Recent versions of MacOS prevent mtxrun
from running because it is not a signed executable. You have at least two options to bypass such restrictions:
- execute
xattr -d com.apple.quarantine context-osx-64/bin/mtxrun
, or - (not recommended) go to System Preferences > Security & Privacy > Privacy tab > Developer Tools, and allow Terminal to run software that does not meet the system's security policy.
The following page describes another, more involved, procedure that achieves the same result:
|