Difference between revisions of "Installation"

From Wiki
Jump to navigation Jump to search
m
(30 intermediate revisions by 8 users not shown)
Line 1: Line 1:
= Look before you leap =
+
< [[Installation hints]] | [[TeX Distributions]] >
 +
 
 +
 
 +
{{Installation navbox}}
 +
 
 +
{{note | The officially recommended way of installing ConTeXt on all platforms is using [[ConTeXt Standalone|ConTeXt Suite]]}}
  
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,
 
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).
+
= Look before you leap =
* 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:
+
Most [[TeX Distributions]] include an installation of ConTeXt already.
 +
To see if it's installed on your system run
 +
context --version
  
* Do you want a distribution package, or do you want your own local TeX installation.  
+
If it is not installed, there are two important considerations.
  
Depending on your OS and the answers to the above questions, you should choose what to install.  
+
* 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.
  
{{note | The officially recommened way of installing ConTeXt on all platforms is using [[ConTeXt Minimals]]}}
+
If you are on a Linux system, there is also a third consideration:
  
= Linux Installation =
+
* Do you want a '''distribution package''', or do you want your own '''local TeX''' installation.
  
== Distribution based TeX Installation with Stable ConTeXt ==  
+
= Installation =
 +
select your operating system
  
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
+
== Unix (linux/bsd/...) ==
* [[Debian_installation|Debian]]
+
In decreasing order of simplicity, here are a few options:
* [[Ubuntu_installation|Ubuntu]]
 
* [[Linux Installation|other distributions]].
 
  
== Distribution based TeX Installation with Bleeding Edge ConTeXt ==
+
* (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]].
 +
* 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).
  
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
+
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!
  
* [[ ConTeXt Minimals ]]
+
FreeBSD also still contains teTeX in its ports distribution (with many dependencies). These packages can be deleted as follows:
 +
  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.
  
== Local TeX distribution with  Stable ConTeXt ==
+
* 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.
  
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
+
=== Debian / (K)Ubuntu ===
 +
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]]
  
* [[TeX-live | TeX-live installation]]
+
=== Fedora ===
* [[Running Mark IV]] in TeXLive 2008
 
  
== Local ConTeXt distribution with Stable ConTeXt ==
+
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.
  
If you only want a ConTeXt distribution (and no LaTeX based stuff), there are two options:
+
=== funtoo ===
  
* [[TeX-live]] and choose only ConTeXt packages
+
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.
* [[ConTeXt Minimals]]
 
  
== Local ConTeXt distribution with Bleeding Edge ConTeXt ==
+
=== openSUSE ===
  
* [[ConTeXt Minimals]]
+
OpenSUSE (starting from 10.3beta3) comes with TeX Live and offers also XeTeX. 10.3b3 contains ConTeXt 2007.01.12.
  
 +
You can [http://software.opensuse.org/search?q=context search for OpenSUSE packages online]
 +
In OpenSUSE 11.3 there are two packages available.
 +
* texlive-context-2010-33.1.noarch.rpm
 +
* texlive-context-2009-26.1.noarch.rpm
  
= Mac Installation =  
+
=== freeBSD ===
  
 +
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.
  
* [[Mac Installation|Mac]]
+
[[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).
  
= Windows Installation =
+
=== OpenBSD ===
  
== TeX Distributions with Stable ConTeXt ==
+
* [[OpenBSD installation|OpenBSD]]
  
There are two main TeX distributions for Windows
+
== Mac OS X ==
 +
* [[Mac Installation]]
  
 +
== Windows ==
 +
There are two main TeX distributions for Windows wich contain a stable context
 
* [[MikTeX]] (currently '''ConTeXt support is broken''')
 
* [[MikTeX]] (currently '''ConTeXt support is broken''')
* [[TeX-live]] (provides stable ConTeXt)
+
* [[TeX Live]] (provides stable ConTeXt)
  
== Bleeding Edge ConTeXt ==
+
Use [[ConTeXt Standalone|ConTeXt Suite]], if you want up to date ConTeXt.
  
If you want up to date ConTeXt, you have to use
+
* [[Windows Installation]] ''(if you are also using LaTeX or have a favourite editor)''
 +
* [[Windows Installation: ConTeXt Suite with SciTe]] ''(the "for dummies" version for those who haven't done any TeXing before)''
  
* [[ConTeXt Minimals]]
+
== Installation from source ==
 
+
* [[TeX Live | TeX Live installation]]: Specific installation instructions using the TeX Live source distribution.
Also see [[Windows Installation]] for details on configuring text editors and other hints. If you are new to the TeX world and don't know anything about editors or don't have a favourite editor, you may prefer [[Simple Windows Installation]].
+
* [[Installation hints]]
  
= Open BSD installation =
 
  
* [[OpenBSD installation|OpenBSD]]
+
== external manuals on installation ==
 +
* [http://www.pragma-ade.com/general/manuals/minstall.pdf How to install context (outdated 2001)]
  
= From source =
+
{{Getting started navbox}}
** [[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]]
 
  
 
[[Category:Installation]]
 
[[Category:Installation]]

Revision as of 04:55, 22 May 2015

< Installation hints | TeX Distributions >



NOTE: The officially recommended way of installing ConTeXt on all platforms is using ConTeXt Suite


Look before you leap

Most TeX Distributions include an installation of ConTeXt already. To see if it's installed on your system run

context --version

If it is not installed, there are two important considerations.

  • 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:

  • Do you want a distribution package, or do you want your own local TeX installation.

Installation

select your operating system

Unix (linux/bsd/...)

In decreasing order of simplicity, here are a few options:

  • (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.
  • 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:

  rpm --qa | grep tetex
  rpm --erase <package-names>

rpm's dependencies will tell you what other TeX-related packages are installed but don't have 'tetex' in their names!

FreeBSD also still contains teTeX in its ports distribution (with many dependencies). These packages can be deleted as follows:

  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.

Debian / (K)Ubuntu

Debian_TeXlive_install (Debian/linux and Debian/kfreebsd)

Fedora

Detils for Fedora version 11, 12 and 13 are at 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.

funtoo

If you are using 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 gentoo, but is untested right now.

openSUSE

OpenSUSE (starting from 10.3beta3) comes with TeX Live and offers also XeTeX. 10.3b3 contains ConTeXt 2007.01.12.

You can search for OpenSUSE packages online In OpenSUSE 11.3 there are two packages available.

  • texlive-context-2010-33.1.noarch.rpm
  • texlive-context-2009-26.1.noarch.rpm

freeBSD

FreeBSD still relies on teTeX in the ports collection. Alternately, TeXlive is now available as a branch extension, see [1] and [2], until migration to the main ports branch is completed.

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).

OpenBSD

Mac OS X

Windows

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 Suite, if you want up to date ConTeXt.

Installation from source


external manuals on installation

Template:Getting started navbox