Difference between revisions of "Installation"

From Wiki
Jump to navigation Jump to search
m (re-add Linux 32bit link)
(135 intermediate revisions by 17 users not shown)
Line 1: Line 1:
−
< [[Installation hints]] | [[TeX Distributions]] >
+
__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]).
  
 +
= Download =
 +
 +
<ul id="DownloadRework">
  
−
{{note | The officially recommened way of installing ConTeXt on all platforms is using [[ConTeXt Minimals]]}}
+
<li>
 +
===  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>
  
 +
<li>
  
−
= Look before you leap =
+
=== 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>
  
−
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,
+
<li>
−
there are two important considerations while considering ConTeXt installation.
 
  
−
* Do you want a ConTeXt distribution or do you want a TeX distribution (plain TeX, LaTeX, ConTeXt, and lots of other goodies).  
+
=== GNU/Linux ===
−
* Do you want a stable version of ConTeXt, or do you want the bleeding edge version. Remember that ConTeXt gets updated frequently.
+
* 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>
  
−
If you are on a Linux system, there is also a third consideration:
 
  
−
* Do you want a distribution package, or do you want your own local TeX installation.
+
<li>
  
−
Depending on your OS and the answers to the above questions, you should choose what to install.  
+
=== FreeBSD ===
 +
* 14.0 [https://lmtx.pragma-ade.com/install-lmtx/context-freebsd-amd64.zip 64bits]
 +
</li>
 +
 
 +
<li>
 +
 
 +
=== OpenBSD ===
 +
* 7.4 [https://lmtx.pragma-ade.nl/install-lmtx/context-openbsd-amd64.zip 64bits]
 +
</li>
 +
</ul>
 +
</li>
 +
 
 +
</ul>
 +
 
 +
</li>
 +
</ul>
 +
 
 +
 
 +
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).
  
 
= Installation =
 
= Installation =
−
select your operating system (alphabetical order)
 
  
 +
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:
 +
 +
# 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:
  
−
== Linux ==
+
* '''Bash''': <code>echo 'export PATH=...instructions...:$PATH'  >> ~/.bashrc</code>
−
In decreasing order of simplicity, here are a few options:
+
* '''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>
  
−
* (simplest) If you distribution supports [[TeX Live]] packages, use them. Debian, Ubuntu, openSUSE, Gentoo, Fedora, Arch and Mandriva (if not too old) do so.  See [[Debian installation]] or [[Ubuntu 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:
−
* If you are running an rpm-based distribution (RedHat, Fedora, Mandrake, Mandriva etc.), then you can most easily uninstall them like so:
 
−
  rpm --qa | grep tetex
 
−
  rpm --erase <package-names>
 
  
−
<code>rpm</code>'s dependencies will tell you what other TeX-related packages are installed but don't have 'tetex' in their names!
+
<code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code>
  
−
* Otherwise, use a fresh [[TeX Live]] installation.  The problem with this method is that you'll probably have to redo the installation once a year, when the new TeX Live DVD comes out.
+
Then generate the cache with  
−
If you will use TeX Live, you have to delete the distribution-provided teTeX packages (if they exist).  
+
<code>mtxrun --generate</code>.
 +
== MacOS ==
  
−
* Alternatively, if you need to use just ConTeXt (e.g. not LaTeX), you can use the [[ConTeXt Minimals]] installation. See the directions that follow.
+
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:
  
−
=== Debian / (K)Ubuntu ===
+
# Create a directory for ConTeXt, such as `C:\context`.
−
Debian_TeXlive_install
+
# Download the architecture-specific version into the ConTeXt directory.
−
* [[Debian installation| install ConTeXt on Debian]]
+
# Extract the archive.
−
* [[Ubuntu installation| install ConTeXt on Ubuntu]]
+
# Run: <code>install.bat</code>
−
* [[Debian TeXlive install| install TeXlive on Debian]]
+
# Run: <code>setpath.bat</code>
  
−
=== Fedora ===
+
Installation is complete.
  
−
Deatils for [http://fedoraproject.org Fedora] version 11, 12 and 13 are at [http://fedoraproject.org/wiki/Features/TeXLive Fedora Project Wiki TeX Live page] maintained by Jindrich Novy. The repository provides a snapshot of TeX Live 2010 tlpretest, and it includes very new ConTeXt packages and requires absolutely no manual configuration to get working Mk II and Mk IV. Highly recommended.
+
= First Run =
−
=== funtoo ===
 
  
−
If you are using [http://funtoo.org funtoo] there are ebuilds that will make an installation as easy as installing any other package from portage. Take a look at the [[ConTeXt Minimals Funtoo]] Howto. This might also work for [http://www.gentoo.org gentoo], but is untested right now.
+
This section describes how to run ConTeXt to transform your first TeX document into a PDF.
  
−
=== SUSE/openSUSE ===
+
# 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>.
  
−
OpenSUSE (starting from 10.3beta3) comes with TeX Live and offers also XeTeX. 10.3b3 contains ConTeXt 2007.01.12.
+
Additional tutorials include:
  
−
OpenSUSE 10.2 (released December 2006) uses teTeX 3.0 and contains the 2005.01.31 version of ConTeXt that is standard in teTeX 3.0.  The package is <tt>te_cont</tt>. 
+
* [[First Document| Your first document]]
−
[http://download.opensuse.org/distribution/10.2/repo/oss/suse/i586/|Here]
+
* [[Detailed Example|Detailed example]]
−
is an RPM repository where you can find it, but you should be able to install it using automated tools.  Then you'll want to upgrade to a more recent version of ConTeXt.  As with Suse 10 (see next paragraph), you'll also need the <tt>te_mpost</tt> and <tt>ruby</tt> packages.
 
  
−
For older distributions see also: [http://home.salamander.com/~wmcclain/context-help.html#old-installation]
+
See the [[Sample documents]] page for even more examples.
  
 +
= Upgrade =
  
−
== MAC OSX ==
+
Re-run the install program to upgrade, which will update the distribution incrementally:
−
* [[Mac Installation]]
 
  
−
== Unix ==
+
* Windows: <code>install.bat</code>
−
* [[OpenBSD installation|OpenBSD]]
+
* Unix: <code>sh install.sh</code>
  
−
== Windows ==
+
= Running MkIV =
−
There are two main TeX distributions for Windows wich contain a stable context
 
−
* [[MikTeX]] (currently '''ConTeXt support is broken''')
 
−
* [[TeX-live]] (provides stable ConTeXt)
 
  
−
Use [[ConTeXt Minimals]], if you want up to date ConTeXt.
+
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]].
  
−
* [[Windows Installation]]
+
= Further installation instructions =
−
* [[Simple Windows Installation]]
 
  
−
== Installation from source ==
+
* [[Installing ConTeXt LMTX on MacOS]]
−
* [[TeX-live | TeX-live installation]]: Specific installation instructions using the TeX-live source distribution.
+
* [[Modules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]]
−
* [[Installation hints]]
+
* 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]].
  
  
−
== external manuals on installation ==
+
----
−
* [http://www.pragma-ade.com/general/manuals/minstall.pdf How to install context (2001)]
 
  
 +
{{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"