Difference between revisions of "Installation"

From Wiki
Jump to navigation Jump to search
(TeX-live --> TeX Live)
(40 intermediate revisions by 5 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]).
  
 +
= #1. Download =
 +
 +
<ul id="DownloadRework">
  
{{note | The officially recommended way of installing ConTeXt on all platforms is using [[ConTeXt Standalone|ConTeXt Suite]]}}
+
<li>
 +
===  Windows ===
 +
* [http://lmtx.pragma-ade.nl/install-lmtx/context-mswin.zip 32bits]
 +
* [http://lmtx.pragma-ade.nl/install-lmtx/context-win64.zip 64bits]
 +
</li>
  
 +
<li>
 +
=== MacOS ===
 +
* [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip 64bits]
 +
</li>
  
= Look before you leap =
+
<li>
 +
=== GNU/Linux ===
 +
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux.zip 32bits]
 +
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip 64bits]
 +
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-armhf.zip 32bits]
 +
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-aarch64.zip 64bits]
 +
</li>
  
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.
+
<li>
 +
=== FreeBSD ===
 +
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32bits] *
 +
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.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).  
+
<li>
* Do you want a '''stable''' version of ConTeXt, or do you want the '''bleeding edge''' version. Remember that ConTeXt gets updated frequently.
+
=== OpenBSD6.5 ===
 +
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5.zip 32bits] *
 +
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5-amd64.zip 64bits]
 +
</li>
  
If you are on a Linux system, there is also a third consideration:
+
<li>
 +
=== OpenBSD6.6 ===
 +
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6.zip 32bits] *
 +
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6-amd64.zip 64bits]
 +
</ul>
 +
</li>
  
* Do you want a '''distribution package''', or do you want your own '''local TeX''' installation.
+
</ul>
  
= Installation =
+
</li>
select your operating system
+
</ul>
  
== Unix (linux/bsd/...) ==
+
<nowiki>*</nowiki>untested configuration.
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]].
+
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).
* 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:
+
= #2. Installation =
  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!
 
  
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.
+
# Create a directory for, e.g. data/context
 +
# Go there and download the relevant zip for your plateform (see above)
 +
# Unpack the zip, some files will appear
 +
# Execute the install program, which will take care of downloading the distribution:
 +
#* WINDOWS: <code>install.bat</code>
 +
#* MAC:
 +
#** If MacOS Catalina (10.15+), first allow mtxrun as unsigned executable with <code>xattr -d com.apple.quarantine context-osx-64/bin/mtxrun</code>
 +
#** execute <code>sh install.sh</code>
 +
#* UNIX: <code>sh install.sh</code>
 +
# Add ConTeXt to your system PATH :
 +
#* WINDOWS: run <code>setpath.bat</code>
 +
#* UNIX: use the PATH instructions provided at the end of <code>install.sh</code> with:
 +
#** Bash shell <code>echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.bashrc</code>
 +
#** Sh/Ksh shell <code>echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.profile</code>
 +
#** Tcsh/csh shell <code>echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc</code>
  
=== Debian / (K)Ubuntu ===
+
= #3. First Run ! =
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 ===
+
* 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 shell
 +
* Check the pdf output <code>Hello-world.pdf</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.
+
You can also follow our two steps tutorial:
 +
* [[First Document| Your 1st document]]
 +
* and a more [[Detailed Example|Detailed example]]
  
=== 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 Standalone Funtoo]] Howto. This might also work for [http://www.gentoo.org gentoo], but is untested right now.
+
= #4. Easy update =
  
=== openSUSE ===
+
For an update, just replay the install program: it also take care of updating the distribution incrementally:
 +
* WINDOWS: <code>install.bat</code>
 +
* UNIX: <code>install.sh</code> (set the executable permissions)
  
OpenSUSE (starting from 10.3beta3) comes with TeX Live and offers also XeTeX. 10.3b3 contains ConTeXt 2007.01.12.
+
= Official installation page =
  
You can [http://software.opensuse.org/search?q=context search for OpenSUSE packages online]
+
The official page '''[http://www.pragma-ade.com/install.htm Installing CONTEXT LMTX ]''' is hosted by Pragma-Ade, which also provides
In OpenSUSE 11.3 there are two packages available.  
+
* a 2 pages '''[http://lmtx.pragma-ade.nl/install-lmtx/installation.pdf installation guide]''',
* texlive-context-2010-33.1.noarch.rpm
+
* a 1 page [http://distribution.contextgarden.net/current/context/experimental/doc/context/documents/general/leaflets/leaflet-context.pdf leaflet for ConTeXt LMTX]
* texlive-context-2009-26.1.noarch.rpm
+
* a 1 page [http://distribution.contextgarden.net/current/context/experimental/doc/context/documents/general/leaflets/leaflet-luametatex.pdf leaflet for LuaMetaTeX].
  
=== 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.
+
= Further installation instructions =
  
[[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).
+
* [[Installing ConTeXt LMTX on MacOS]]
  
=== OpenBSD ===
 
  
* [[OpenBSD installation|OpenBSD]]
+
----
  
== Mac OS X ==
+
{{Installation navbox}}
* [[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)
 
  
Use [[ConTeXt Standalone|ConTeXt Suite]], if you want up to date ConTeXt.
+
[[Category:Standalone]]
 
 
* [[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)''
 
 
 
== Installation from source ==
 
* [[TeX Live | TeX Live installation]]: Specific installation instructions using the TeX Live source distribution.
 
* [[Installation hints]]
 
 
 
 
 
== external manuals on installation ==
 
* [http://www.pragma-ade.com/general/manuals/minstall.pdf How to install context (outdated 2001)]
 
 
 
 
 
[[Category:Installation]]
 

Revision as of 13:50, 30 May 2020

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

#1. Download

*untested configuration.

You can read the licence (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).

#2. Installation

  1. Create a directory for, e.g. data/context
  2. Go there and download the relevant zip for your plateform (see above)
  3. Unpack the zip, some files will appear
  4. Execute the install program, which will take care of downloading the distribution:
    • WINDOWS: install.bat
    • MAC:
      • If MacOS Catalina (10.15+), first allow mtxrun as unsigned executable with xattr -d com.apple.quarantine context-osx-64/bin/mtxrun
      • execute sh install.sh
    • UNIX: sh install.sh
  5. Add ConTeXt to your system PATH :
    • WINDOWS: run setpath.bat
    • UNIX: use the PATH instructions provided at the end of install.sh with:
      • Bash shell echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.bashrc
      • Sh/Ksh shell echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.profile
      • Tcsh/csh shell echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc

#3. First Run !

You can also follow our two steps tutorial:


#4. Easy update

For an update, just replay the install program: it also take care of updating the distribution incrementally:

  • WINDOWS: install.bat
  • UNIX: install.sh (set the executable permissions)

Official installation page

The official page Installing CONTEXT LMTX is hosted by Pragma-Ade, which also provides


Further installation instructions