Difference between revisions of "Installation"

From Wiki
Jump to navigation Jump to search
(Add a simpler way to install LMTX in MacOS, which does not require disabling SIP)
m (re-add Linux 32bit link)
 
(77 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__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]).
+
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 =
+
= Download =
 
   
 
   
 
<ul id="DownloadRework">
 
<ul id="DownloadRework">
Line 8: Line 8:
 
<li>
 
<li>
 
===  Windows ===
 
===  Windows ===
* [http://lmtx.pragma-ade.nl/install-lmtx/context-mswin.zip 32bits]
+
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-mswin.zip 32bits]
* [http://lmtx.pragma-ade.nl/install-lmtx/context-win64.zip 64bits]
+
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-win64.zip 64bits]
 +
* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-windows-arm64.zip 64bits]
 
</li>
 
</li>
  
 
<li>
 
<li>
 +
 
=== MacOS ===
 
=== MacOS ===
* [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip 64bits]
+
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-osx-64.zip 64bits]
 +
* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-osx-arm64.zip 64bits]
 
</li>
 
</li>
  
 
<li>
 
<li>
 +
 
=== GNU/Linux ===
 
=== GNU/Linux ===
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux.zip 32bits]
+
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-linux.zip 32bits]
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip 64bits]
+
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip 64bits]
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-armhf.zip 32bits]
+
* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-linux-aarch64.zip 64bits]
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-aarch64.zip 64bits]
+
* Musl [https://lmtx.pragma-ade.nl/install-lmtx/context-linuxmusl-64.zip 64bits]
 
</li>
 
</li>
  
  
 
<li>
 
<li>
 +
 
=== FreeBSD ===
 
=== FreeBSD ===
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32bits] *
+
* 14.0 [https://lmtx.pragma-ade.com/install-lmtx/context-freebsd-amd64.zip 64bits]
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.zip 64bits]
 
 
</li>
 
</li>
  
 
<li>
 
<li>
=== OpenBSD6.5 ===
+
 
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5.zip 32bits] *
+
=== OpenBSD ===
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5-amd64.zip 64bits]
+
* 7.4 [https://lmtx.pragma-ade.nl/install-lmtx/context-openbsd-amd64.zip 64bits]
 
</li>
 
</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>
 
</ul>
 
</li>
 
</li>
Line 50: Line 49:
 
</ul>
 
</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).
 
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).
  
= #2. Installation =
+
= 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.
 +
 
 +
== Unix ==
  
 +
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/context
+
# mkdir $HOME/context
# Go there and download the relevant zip for your plateform (see above)
+
# cd $HOME/context
# Unpack the zip, some files will appear
+
# wget https://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip
# Execute the install program, which will take care of downloading the distribution:
+
# unzip context-linux-64.zip
#* WINDOWS: <code>install.bat</code>
+
# sh install.sh
#* UNIX: <code>install.sh</code> (set the executable permissions)
 
#* MacOS: see '''Further installation instructions''' below before running <code>install.sh</code>
 
# 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 <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...)' >> ~/.cshrc</code>
 
  
= #3. First Run ! =
+
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:
  
* Download the tex input file [[Media:Hello-world.tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]]
+
* '''Bash''': <code>echo 'export PATH=...instructions...:$PATH'  >> ~/.bashrc</code>
* Run <code>context Hello-world.tex</code> in your shell
+
* '''Zsh''': <code>echo 'export PATH=...instructions...:$PATH'  >> ~/.zshenv</code>
* Check the pdf output <code>Hello-world.pdf</code>.
+
* '''Sh'''/'''Ksh''': <code>echo 'export PATH=...instructions...:$PATH'  >> ~/.profile</code>
 +
* '''Tcsh'''/'''csh''': <code>echo 'set path = ($path ...instructions...)' >> ~/.cshrc</code>
  
You can also follow our two steps tutorial:
+
For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable:
* [[First Document| Your 1st document]]
 
* and a more [[Detailed Example|Detailed example]]
 
  
 +
<code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code>
  
= #4. Easy update =
+
Then generate the cache with
 +
<code>mtxrun --generate</code>.
 +
== MacOS ==
  
For an update, just replay the install program: it also take care of updating the distribution incrementally:
+
The instructions for MacOS are the same as for Unix, but note that:
* WINDOWS: <code>install.bat</code>
 
* UNIX: <code>install.sh</code> (set the executable permissions)
 
  
= Official installation page =
+
* MacOS versions from Catalina (10.15) and newer use '''Zsh''' by default.
 +
* MacOS versions before Catalina use '''Bash''' by default.
  
The official page '''[http://www.pragma-ade.com/install.htm Installing CONTEXT LMTX ]''' is hosted by Pragma-Ade, which also provides
+
== Windows ==
* 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].
 
  
 +
Complete the following steps to set up ConTeXt on Windows:
  
= Further installation instructions =
+
# 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:
  
Recent versions of MacOS prevent <code>mtxrun</code> from running because it is not a signed executable. You have at least two options to bypass such restrictions:
+
* Windows: <code>install.bat</code>
 +
* Unix: <code>sh install.sh</code>
  
* execute <code>xattr -d com.apple.quarantine context-osx-64/bin/mtxrun</code>, or
+
= Running MkIV =
* (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:
+
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]]
 
* [[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]].
  
  
Line 112: Line 147:
 
{{Installation navbox}}
 
{{Installation navbox}}
  
 
+
[[Category:Basics]]
[[Category:Standalone]]
+
[[Category:Installation]]

Latest revision as of 19:14, 14 February 2024

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


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:

  1. Create a directory for ConTeXt.
  2. Download the platform-specific archive file into the ConTeXt directory.
  3. Unpack the archive.
  4. Execute the install program, which downloads the distribution.
  5. Update the PATH environment variable.
  6. Generate cache
  7. 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 the archive file download link as needed for your target platform. Open a new terminal then run the following commands:

  1. mkdir $HOME/context
  2. cd $HOME/context
  3. wget https://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip
  4. unzip context-linux-64.zip
  5. sh install.sh

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:

  • 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/context on a system running bash, then the following line would update the PATH environment variable:

echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc

Then generate the cache with mtxrun --generate.

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:

  1. Create a directory for ConTeXt, such as C:\context.
  2. Download the architecture-specific version into the ConTeXt directory.
  3. Extract the archive.
  4. Run: install.bat
  5. Run: setpath.bat

Installation is complete.

First Run

This section describes how to run ConTeXt to transform your first TeX document into a PDF.

  1. Download the tex input file Hello-World.tex from our Detailed example.
  2. Run context Hello-world.tex in your terminal (or command prompt).
  3. Check the PDF output Hello-world.pdf.

Additional tutorials include:

See the Sample documents page for even more examples.

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 has all the files to run the previous version of ConTeXt.

  • Run context --luatex Hello-world.tex to use the luatex binary and MkIV.

Further installation instructions