Difference between revisions of "Installation"

From Wiki
Jump to navigation Jump to search
({{Getting started navbox}})
m (re-add Linux 32bit link)
(114 intermediate revisions by 11 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 recommended way of installing ConTeXt on all platforms is using [[ConTeXt Standalone|ConTeXt Suite]]}}
+
<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.
+
<li>
−
To see if it's installed on your system run
 
−
context --version
 
  
−
If it is not installed, there are two important considerations.
+
=== 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>
  
−
* Do you want a '''ConTeXt distribution''' or do you want a '''TeX distribution''' (plain TeX, LaTeX, ConTeXt, and lots of other goodies).
 
−
* Do you want a '''stable''' version of ConTeXt, or do you want the '''bleeding edge''' version. Remember that ConTeXt gets updated frequently.
 
  
−
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.
+
=== 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
 
  
−
== Unix (linux/bsd/...) ==
+
The general steps to install ConTeXt LMTX are as follows:
−
In decreasing order of simplicity, here are a few options:
+
 
 +
# 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 ==
  
−
* (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]].
+
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:
−
* 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.
 
−
If you will use TeX Live, you have to delete the distribution-provided teTeX packages (if they exist).
 
  
−
If you are running an rpm-based distribution (RedHat, Fedora, Mandrake, Mandriva etc.), then you can most easily uninstall them like so:
+
# mkdir $HOME/context
−
  rpm --qa | grep tetex
+
# cd $HOME/context
−
  rpm --erase <package-names>
+
# wget https://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip
−
<code>rpm</code>'s dependencies will tell you what other TeX-related packages are installed but don't have 'tetex' in their names!
+
# unzip context-linux-64.zip
 +
# sh install.sh
  
−
FreeBSD also still contains teTeX in its ports distribution (with many dependencies). These packages can be deleted as follows:
+
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:
−
  pkg_info | grep tetex
 
−
  pkg_delete tetex\*
 
−
Note, however, that teTeX will again be pulled-in by other packages, for example if options installing formatted documentation are activated.
 
  
−
* Alternatively, if you need '''just ConTeXt and no LaTeX''', you can use the [[ConTeXt Standalone]] installation. The ConTeXt Standalone installation does not require the de-installation of other TeX distributions and can be used in parallel.
+
* '''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>
  
−
=== Debian / (K)Ubuntu ===
+
For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable:
−
Debian_TeXlive_install (Debian/linux and Debian/kfreebsd)
 
−
* [[Debian installation| install ConTeXt on Debian]]
 
−
* [[Ubuntu installation| install ConTeXt on Ubuntu]]
 
−
* [[Debian TeXlive install| install TeXlive on Debian]]
 
  
−
=== Fedora ===
+
<code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code>
  
−
Detils 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.
+
Then generate the cache with
 +
<code>mtxrun --generate</code>.
 +
== MacOS ==
  
−
=== funtoo ===
+
The instructions for MacOS are the same as for Unix, but note that:
  
−
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 Standalone Funtoo]] Howto. This might also work for [http://www.gentoo.org gentoo], but is untested right now.
+
* MacOS versions from Catalina (10.15) and newer use '''Zsh''' by default.
 +
* MacOS versions before Catalina use '''Bash''' by default.
  
−
=== openSUSE ===
+
== Windows ==
  
−
OpenSUSE (starting from 10.3beta3) comes with TeX Live and offers also XeTeX. 10.3b3 contains ConTeXt 2007.01.12.
+
Complete the following steps to set up ConTeXt on Windows:
  
−
You can [http://software.opensuse.org/search?q=context search for OpenSUSE packages online]
+
# Create a directory for ConTeXt, such as `C:\context`.
−
In OpenSUSE 11.3 there are two packages available.  
+
# Download the architecture-specific version into the ConTeXt directory.
−
* texlive-context-2010-33.1.noarch.rpm
+
# Extract the archive.
−
* texlive-context-2009-26.1.noarch.rpm
+
# Run: <code>install.bat</code>
 +
# Run: <code>setpath.bat</code>
  
−
=== freeBSD ===
+
Installation is complete.
  
−
FreeBSD still relies on teTeX in the ports collection. Alternately, TeXlive is now available as a branch extension, see [http://code.google.com/p/freebsd-texlive/wiki/Installing] and [http://romain.blogreen.org/blog/2011/08/texlive-2011-on-freebsd/], until migration to the main ports branch is completed.
+
= First Run =
  
−
[[TeX Live]] as a standalone installation will run "out of the box" on all recent versions of freeBSD (7, 8, 9) and extended support is available for earlier versions; The [[ConTeXt Standalone]] installation is compiled for the latest stable release (currently 8.2).
+
This section describes how to run ConTeXt to transform your first TeX document into a PDF.
  
−
=== OpenBSD ===
+
# 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 =
  
−
* [[OpenBSD installation|OpenBSD]]
+
Re-run the install program to upgrade, which will update the distribution incrementally:
  
−
== Mac OS X ==
+
* Windows: <code>install.bat</code>
−
* [[Mac Installation]]
+
* 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 Standalone|ConTeXt Suite]], 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]] ''(if you are also using LaTeX or have a favourite editor)''
+
= Further installation instructions =
−
* [[Windows Installation: ConTeXt Suite with SciTe]] ''(the "for dummies" version for those who haven't done any TeXing before)''
 
  
−
== 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 (outdated 2001)]
 
  
 
{{Installation navbox}}
 
{{Installation navbox}}
  
−
{{Getting started 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"