Difference between revisions of "Installation"

From Wiki
Jump to navigation Jump to search
m
(12 intermediate revisions by one other user not shown)
Line 38: Line 38:
 
<li>
 
<li>
  
=== OpenBSD6.7 ===
+
=== OpenBSD6.8 ===
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.7.zip 32bits]
+
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.8.zip 32bits]
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.7-amd64.zip 64bits]
+
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.8-amd64.zip 64bits]
 +
</li>
  
 
<li>
 
<li>
  
=== OpenBSD6.8 ===
+
=== OpenBSD6.9 ===
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.8.zip 32bits]
+
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.9.zip 32bits]
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.8-amd64.zip 64bits]
+
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.9-amd64.zip 64bits]
 
</li>
 
</li>
 
</ul>
 
</ul>
Line 74: Line 75:
 
== Unix ==
 
== 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:
+
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:
  
 
# mkdir $HOME/bin/context
 
# mkdir $HOME/bin/context
Line 82: Line 83:
 
# sh install.sh
 
# 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:
+
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''': <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.bashrc</code>
+
* '''Bash''': <code>echo 'export PATH=...instructions...:$PATH'  >> ~/.bashrc</code>
* '''Zsh''': <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.zshenv</code>
+
* '''Zsh''': <code>echo 'export PATH=...instructions...:$PATH'  >> ~/.zshenv</code>
* '''Sh'''/'''Ksh''': <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.profile</code>
+
* '''Sh'''/'''Ksh''': <code>echo 'export PATH=...instructions...:$PATH'  >> ~/.profile</code>
* '''Tcsh'''/'''csh''': <code>echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc</code>
+
* '''Tcsh'''/'''csh''': <code>echo 'set path = ($path ...instructions...)' >> ~/.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:
 
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:
Line 93: Line 94:
 
<code>echo 'export PATH=$HOME/bin/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code>
 
<code>echo 'export PATH=$HOME/bin/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code>
  
=== MacOS ===
+
== MacOS ==
  
 
The instructions for MacOS are the same as for Unix, but note that:
 
The instructions for MacOS are the same as for Unix, but note that:
Line 102: Line 103:
 
== Windows ==
 
== Windows ==
  
Complete the following instructions to set up ConTeXt on Windows:
+
Complete the following steps to set up ConTeXt on Windows:
  
 
# Create a directory for ConTeXt, such as `C:\context`.
 
# Create a directory for ConTeXt, such as `C:\context`.
# Download the architecture-specific version into the ConTeXt directory directory.
+
# Download the architecture-specific version into the ConTeXt directory.
 
# Extract the archive.
 
# Extract the archive.
 
# Run: <code>install.bat</code>
 
# Run: <code>install.bat</code>
 
# Run: <code>setpath.bat</code>
 
# Run: <code>setpath.bat</code>
# Optionally, delete the archive file.
 
  
 
Installation is complete.
 
Installation is complete.
  
= First Run ! =
+
= 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:
  
* Download the tex input file [[Media:Hello-world.tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]]
+
* [[First Document| Your first document]]
* Run <code>context Hello-world.tex</code> in your shell
+
* [[Detailed Example|Detailed example]]
* Check the pdf output <code>Hello-world.pdf</code>.
 
  
You can also follow our two steps tutorial:
+
See the [[Sample documents]] page for even more examples.
* [[First Document| Your 1st document]]
 
* and a more [[Detailed Example|Detailed example]]
 
  
Moreover, a page is used to centralized [[Sample documents]].
+
= Upgrade =
  
= Easy update =
+
Re-run the install program to upgrade, which will update the distribution incrementally:
  
For an update, just replay the install program: it also take care of updating the distribution incrementally:
+
* Windows: <code>install.bat</code>
* WINDOWS: <code>install.bat</code>
+
* Unix: <code>sh install.sh</code>
* UNIX: <code>sh install.sh</code>
 
  
 
= Running MkIV =
 
= Running MkIV =
  
The new distribution still has all the files to run the previous version of ConTeXt.  
+
The new distribution has all the files to run the previous version of ConTeXt.  
* Run <code>context --luatex Hello-world.tex</code> in your shell to revert back to the `luatex` binary and [[MkIV]].
+
* Run <code>context --luatex Hello-world.tex</code> to use the `luatex` binary and [[MkIV]].
  
 
= Further installation instructions =
 
= Further installation instructions =

Revision as of 12:25, 11 May 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 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/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 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/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 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