Difference between revisions of "Installation"

From Wiki
Jump to navigation Jump to search
(Details about Linux based installation // Can others add details about other OSes)
m
(33 intermediate revisions by 9 users not shown)
Line 1: Line 1:
 +
< [[Installation hints]] | [[TeX Distributions]] >
 +
 +
 +
{{Installation navbox}}
 +
 +
{{note | The officially recommended way of installing ConTeXt on all platforms is using [[ConTeXt Standalone|ConTeXt Suite]]}}
 +
 +
 
= Look before you leap =
 
= Look before you leap =
  
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,  
+
Most [[TeX Distributions]] include an installation of ConTeXt already.
there are two important considerations while considering ConTeXt installation.
+
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 '''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.
+
* 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:
 
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.  
+
* Do you want a '''distribution package''', or do you want your own '''local TeX''' installation.
 +
 
 +
= Installation =
 +
select your operating system
  
Depending on your OS and the answers to the above questions, you should choose what to install.
+
== Unix (linux/bsd/...) ==
 +
In decreasing order of simplicity, here are a few options:
  
{{note | The officially recommened way of installing ConTeXt on all platforms is using [[ConTeXt Minimals]]}}
+
* (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).
  
= Linux Installation =
+
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!
  
== Distribution based TeX Installation with Stable ConTeXt ==
+
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.
  
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
+
* 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_installation|Debian]]
 
* [[Ubuntu_installation|Ubuntu]]
 
* [[Linux Installation|other distributions]].
 
  
== Distribution based TeX Installation with Bleeding Edge ConTeXt ==  
+
=== 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]]
  
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
+
=== Fedora ===
  
* [[ ConTeXt Minimals ]]
+
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.
  
== Local TeX distribution with  Stable ConTeXt ==
+
=== funtoo ===
  
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
+
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.
  
* [[TeX-live | TeX-live installation]]
+
=== openSUSE ===
* [[Running Mark IV]] in TeXLive 2008
 
  
== Local ConTeXt distribution with Stable ConTeXt ==
+
OpenSUSE (starting from 10.3beta3) comes with TeX Live and offers also XeTeX. 10.3b3 contains ConTeXt 2007.01.12.
  
If you only want a ConTeXt distribution (and no LaTeX based stuff), there are two options:
+
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
  
* [[TeX-live]] and choose only ConTeXt packages
+
=== freeBSD ===
* [[ConTeXt Minimals]]
 
  
== Local ConTeXt distribution with Bleeding Edge ConTeXt ==
+
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.
  
* [[ConTeXt Minimals]]
+
[[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 ===
 +
 +
* [[OpenBSD installation|OpenBSD]]
  
= Mac Installation =
+
== 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''')
 +
* [[TeX Live]] (provides stable ConTeXt)
  
* [[Mac Installation|Mac]]
+
Use [[ConTeXt Standalone|ConTeXt Suite]], if you want up to date ConTeXt.
  
= Windows Installation =
+
* [[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)''
  
* [[Windows Installation|Windows]]
+
== Installation from source ==
 +
* [[TeX Live | TeX Live installation]]: Specific installation instructions using the TeX Live source distribution.
 +
* [[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