Difference between revisions of "Installation"

From Wiki
Jump to navigation Jump to search
Line 61: Line 61:
 
= Installation =
 
= Installation =
  
Complete the following steps to install ConTeXt LMTX:
+
The general steps to install ConTeXt LMTX are as follows:
  
# Create a directory for ConTeXt (e.g., bin/context).
+
# Create a directory for ConTeXt.
# Download the platform-specific archive file---see above---into the ConTeXt directory directory.
+
# Download the platform-specific archive file into the ConTeXt directory.
#* For example, on a 64-bit Linux platform, you may use the following steps:
 
#*# <code>cd bin/context</code>
 
#*# <code>wget http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip</code>
 
 
# Unpack the archive.
 
# Unpack the archive.
#* UNIX/MAC: <code>unzip context-linux-64.zip</code>
 
 
# Execute the install program, which downloads the distribution.
 
# Execute the install program, which downloads the distribution.
#* WINDOWS: <code>install.bat</code>
+
# Update the PATH environment variable.
#* UNIX/MAC: <code>sh install.sh</code>
+
# Optionally, delete the archive file.
# Add the ConTeXt directory to the system PATH environment variable.
+
 
#* WINDOWS:  
+
See the next sections for instructions specific to various platforms.
#** run <code>setpath.bat</code>
+
 
#* UNIX: use the PATH instructions provided at the end of <code>install.sh</code> with:
+
== Unix ==
#** Bash shell <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.bashrc</code>
+
 
#** Zsh shell <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.zshenv</code>
+
The following steps download and install ConTeXt for a 64-bit Linux system. Change archive file download link as needed for your target platform:
#** Sh/Ksh shell <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.profile</code>
+
 
#** Tcsh/csh shell <code>echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc</code>
+
# mkdir $HOME/bin/context
#* MAC:
+
# cd $HOME/bin/context
#** Same as for UNIX. MacOS Catalina (10.15) defaults to `Zsh`, earlier versions defaulted to `Bash`
+
# 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''': <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.bashrc</code>
 +
* '''Zsh''': <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.zshenv</code>
 +
* '''Sh'''/'''Ksh''': <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.profile</code>
 +
* '''Tcsh'''/'''csh''': <code>echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc</code>
 +
 
 +
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:
 +
 
 +
<code>echo 'export PATH=$HOME/bin/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</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 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 directory.
 +
# Extract the archive.
 +
# Run: <code>install.bat</code>
 +
# Run: <code>setpath.bat</code>
 
# Optionally, delete the archive file.
 
# Optionally, delete the archive file.
  

Revision as of 20:18, 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


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. Optionally, delete the archive file.

See the next sections for instructions specific to various platforms.

Unix

The following steps download and install ConTeXt for a 64-bit Linux system. Change archive file download link as needed for your target platform:

  1. mkdir $HOME/bin/context
  2. cd $HOME/bin/context
  3. wget http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip
  4. unzip context-linux-64.zip
  5. 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=...thepathinstructions...:$PATH' >> ~/.bashrc
  • Zsh: echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.zshenv
  • Sh/Ksh: echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.profile
  • Tcsh/csh: echo 'set path = ($path ...thepathinstructions...)' >> ~/.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:

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

Installation is complete.

First Run !

You can also follow our two steps tutorial:

Moreover, a page is used to centralized Sample documents.

Easy update

For an update, just replay the install program: it also take care of updating 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 the luatex binary and MkIV.

Further installation instructions