Difference between revisions of "Installation"

From Wiki
Jump to navigation Jump to search
m (re-add Linux 32bit link)
(145 intermediate revisions by 17 users not shown)
Line 1: Line 1:
−
= Look before you leap =
+
__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]).
  
−
Most [[TeX Distributions]] include an installation of ConTeXt already -- try running <tt>texexec --version</tt> to see if it's installed on your system. If it is not installed,
+
= Download =
−
there are two important considerations while considering ConTeXt installation.
+
 +
<ul id="DownloadRework">
  
−
* Do you want a ConTeXt distribution or do you want a TeX distribution (plain TeX, LaTeX, ConTeXt, and lots of other goodies).  
+
<li>
−
* Do you want a stable version of ConTeXt, or do you want the bleeding edge version. Remember that ConTeXt gets updated frequently.
+
===  Windows ===
 +
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-mswin.zip 32bits]
 +
* 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>
  
−
If you are on a Linux system, there is also a third consideration:
+
<li>
  
−
* Do you want a distribution package, or do you want your own local TeX installation.  
+
=== MacOS ===
 +
* 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>
  
−
Depending on your OS and the answers to the above questions, you should choose what to install.
+
<li>
  
−
{{note | The officially recommened way of installing ConTeXt on all platforms is using [[ConTeXt Minimals]]}}
+
=== GNU/Linux ===
 +
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-linux.zip 32bits]
 +
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip 64bits]
 +
* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-linux-aarch64.zip 64bits]
 +
* Musl [https://lmtx.pragma-ade.nl/install-lmtx/context-linuxmusl-64.zip 64bits]
 +
</li>
  
−
= Linux Installation =
 
  
−
== Distribution based TeX Installation with Stable ConTeXt ==
+
<li>
  
−
The Debian tex packages are based on [[TeX-live]] and are fairly up to date. Debian derivates like Ubuntu are usually close. Usually, you should be able to search for context in your package manager, and install it. For specific instructions see
+
=== FreeBSD ===
−
* [[Debian_installation|Debian]]
+
* 14.0 [https://lmtx.pragma-ade.com/install-lmtx/context-freebsd-amd64.zip 64bits]
−
* [[Ubuntu_installation|Ubuntu]]
+
</li>
−
* [[Linux Installation|other distributions]].
 
  
−
== Distribution based TeX Installation with Bleeding Edge ConTeXt ==
+
<li>
  
−
Distribution based TeX installations usually update ConTeXt one to four times a year. ConTeXt beta versions are usually released one to four times a week. So, ConTeXt is usually somewhat out of date in most distributions. For most uses, the previous stable version is OK, but if you want to use a new feature, you will have to get an up to date ConTeXt. It is possible to manually update a distribution based ConTeXt installation, but you really need to know you distributions packaging scheme, and the TeX installation structure to it correctly. So, manually updating a distrbution based ConTeXt installation is not recommended. Instead, you should use [[ConTeXt Minimals]]. They can be installed in parallel to the distribution based TeX installation and do not interfere with it. So you can use your distribution's TeX installation for plain TeX and LaTeX, and use the minimals for ConTeXt. For details see
+
=== OpenBSD ===
 +
* 7.4 [https://lmtx.pragma-ade.nl/install-lmtx/context-openbsd-amd64.zip 64bits]
 +
</li>
 +
</ul>
 +
</li>
  
−
* [[ ConTeXt Minimals ]]
+
</ul>
  
−
== Local TeX distribution with  Stable ConTeXt ==
+
</li>
 +
</ul>
  
−
If your distribution does not provide an up to date TeX installation, you can install [[TeX-live]] which provides comprehensive coverage of TeX engines (tex, pdftex, xetex, luatex), TeX macro packages (plain TeX, LaTeX, ConTeXt) and TeX fonts. For more details see
 
  
−
* [[TeX-live | TeX-live installation]]
+
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).
−
* [[Running Mark IV]] in TeXLive 2008
 
  
−
== Local ConTeXt distribution with Stable ConTeXt ==
+
= Installation =
  
−
If you only want a ConTeXt distribution (and no LaTeX based stuff), there are two options:
+
The general steps to install ConTeXt LMTX are as follows:
  
−
* [[TeX-live]] and choose only ConTeXt packages
+
# Create a directory for ConTeXt.
−
* [[ConTeXt Minimals]]
+
# 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.
  
−
== Local ConTeXt distribution with Bleeding Edge ConTeXt ==
+
See the next sections for instructions specific to various platforms.
  
−
* [[ConTeXt Minimals]]
+
== 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:
  
−
= Mac Installation =
+
# mkdir $HOME/context
 +
# cd $HOME/context
 +
# wget https://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip
 +
# unzip context-linux-64.zip
 +
# 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:
  
−
* [[Mac Installation|Mac]]
+
* '''Bash''': <code>echo 'export PATH=...instructions...:$PATH'  >> ~/.bashrc</code>
 +
* '''Zsh''': <code>echo 'export PATH=...instructions...:$PATH'  >> ~/.zshenv</code>
 +
* '''Sh'''/'''Ksh''': <code>echo 'export PATH=...instructions...:$PATH'  >> ~/.profile</code>
 +
* '''Tcsh'''/'''csh''': <code>echo 'set path = ($path ...instructions...)' >> ~/.cshrc</code>
  
−
= Windows Installation =
+
For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable:
  
−
== TeX Distributions with Stable ConTeXt ==
+
<code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code>
  
−
There are two main TeX distributions for Windows
+
Then generate the cache with
 +
<code>mtxrun --generate</code>.
 +
== MacOS ==
  
−
* [[MikTeX]] (currently '''ConTeXt support is broken''')
+
The instructions for MacOS are the same as for Unix, but note that:
−
* [[TeX-live]] (provides stable ConTeXt)
 
  
−
== Bleeding Edge ConTeXt ==
+
* MacOS versions from Catalina (10.15) and newer use '''Zsh''' by default.
 +
* MacOS versions before Catalina use '''Bash''' by default.
  
−
If you want up to date ConTeXt, you have to use
+
== Windows ==
  
−
* [[ConTeXt Minimals]]
+
Complete the following steps to set up ConTeXt on Windows:
  
−
Also see [[Windows Installation]] for details on configuring text editors and other hints.
+
# 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>
  
−
= Open BSD installation =
+
Installation is complete.
  
−
* [[OpenBSD installation|OpenBSD]]
+
= First Run =
  
−
= From source =
+
This section describes how to run ConTeXt to transform your first TeX document into a PDF.
−
** [[TeTeX 3.0 installation]]: Specific installation instructions using the teTeX 3.0 source distribution.
 
−
** [[TeX-live | TeX-live installation]]: Specific installation instructions using the TeX-live source distribution.
 
−
* [[Installation hints]]
 
  
 +
# 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:
 +
 +
* Windows: <code>install.bat</code>
 +
* Unix: <code>sh install.sh</code>
 +
 +
= Running MkIV =
 +
 +
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]]
 +
* [[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]].
 +
 +
 +
----
 +
 +
{{Installation navbox}}
 +
 +
[[Category:Basics]]
 
[[Category:Installation]]
 
[[Category:Installation]]

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


v · d · e
Installation
General
TeX distributions
Operating systems
Integrating editors with ConTeXt
Retrieved from "https://wiki.contextgarden.net/index.php?title=Installation&oldid=34337"