Difference between revisions of "Installation"

From Wiki
Jump to navigation Jump to search
m (→‎Look before you leap: Phrasing changes)
(Switch "ConTextLMTX" content to "Installation". Previous "Installation" content is now in "InstallationPreviousMethods")
Line 1: Line 1:
< [[Installation hints]] | [[TeX Distributions]] >
+
__NOTOC__
 +
Since April 2019, there is a new major version of ConTeXt, named '''ConTeXt LMTX'''.
  
 +
It is a new implementation tuned for LuaMetaTeX TeX engine, the lean and mean successor of the LuaTeX TeX engine (see [https://tug.org/TUGboat/tb40-1/tb124hagen-lmtx.pdf article]).
  
{{Installation navbox}}
 
  
{{note | The officially recommended way of installing ConTeXt on all platforms is using [[ConTeXt Standalone|ConTeXt Suite]]}}
+
<ul style="display: grid;grid-template-columns: repeat(auto-fit, minmax(25em, 1fr)); grid-gap:3rem; justify-content: space-between;list-style: none;padding: 0px;margin: 0px; ">
 +
<li style="height: stretch; padding: 10px; background-color: #f6f6f6; ">
 +
=== #1- Download ===
 +
 +
<ul class="DownloadRework">
  
 +
<li class="DownloadRework" style="text-align:left;">
 +
===&nbsp;⯆ GNU/Linux ===
 +
<ul style="text-align:left;">
 +
<li>X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux.zip 32b] | [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip 64b]</li>
 +
<li>ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-armhf.zip 32b] | [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-aarch64.zip 64b]</li>
 +
</ul>
 +
</li>
  
= Look before you leap =
+
<li class="DownloadRework" style="text-align:left;">
 +
===&nbsp;⯆ Windows ===
 +
<ul style="text-align:left;">
 +
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-mswin.zip 32b]</li>
 +
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-win64.zip 64b]</li>
 +
</ul>
 +
</li>
  
Most [[TeX Distributions]] include an installation of ConTeXt already.
+
<li class="DownloadRework" style="text-align:left;">
To see if it's installed on your system run
+
===&nbsp;⯆ MacOS ===
context --version
+
<ul style="text-align:left;">
 +
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip 64b]</li>
 +
</ul>
 +
</li>
  
If it is not installed, there are two important considerations.
+
<li class="DownloadRework" style="text-align:left;">
 +
===&nbsp;⯆ Free BSD ===
 +
<ul style="text-align:left;">
 +
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32b] (untested)</li>
 +
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.zip 64b]</li>
 +
</ul>
 +
</li>
  
* Do you want a '''ConTeXt distribution''' or do you want a '''TeX distribution''' (plain TeX, LaTeX, ConTeXt, and lots of other goodies)?
+
<li class="DownloadRework" style="text-align:left;">
* Do you want a '''stable''' version of ConTeXt, or do you want the '''beta''' or '''bleeding edge''' versions? Remember that ConTeXt gets updated frequently.
+
===&nbsp;⯆ OpenBSD6.5 ===
 +
<ul style="text-align:left;">
 +
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5.zip 32b] (untested)</li>
 +
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5-amd64.zip 64b]</li>
 +
</ul>
 +
</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 class="DownloadRework" style="text-align:left;">
 +
===&nbsp;⯆ OpenBSD6.6 ===
 +
<ul style="text-align:left;">
 +
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6.zip 32b] (untested)</li>
 +
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6-amd64.zip 64b]</li>
 +
</ul>
 +
</li>
 +
</ul>
  
= Installation =
+
</li>
select your operating system
+
</ul>
  
== 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:
+
<ul style="display: grid;grid-template-columns: repeat(auto-fit, minmax(25em, 1fr)); grid-gap:3rem; justify-content: space-between;list-style: none;padding: 0px;margin: 0px; ">
  rpm --qa | grep tetex
+
<li style="height: stretch; padding: 10px; background-color: #f6f6f6; ">
  rpm --erase <package-names>
+
=== #2- Installation ===
<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 aside)
 +
# Unpack the zip, some files will appear
 +
# Execute the install program, which will take care of downloading the distribution:
 +
#* WINDOWS: <code>install.bat</code>
 +
#* UNIX: <code>install.sh</code> (set the executable permissions)
 +
# 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>
 +
</li>
  
=== Debian / (K)Ubuntu ===
+
<li style="height: stretch; padding: 10px; background-color: #f6f6f6; ">
Debian_TeXlive_install (Debian/linux and Debian/kfreebsd)
+
=== #3- First Run with ConTeXt ! ===
* [[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-Update ? ===
  
=== openSUSE ===
+
Just replay the install program, it also take care of updating the distribution:
 +
* WINDOWS: <code>install.bat</code>
 +
* UNIX: <code>install.sh</code> (set the executable permissions)
 +
</li>
 +
</ul>
  
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]
+
=== Official installation page ===
In OpenSUSE 11.3 there are two packages available.
 
* texlive-context-2010-33.1.noarch.rpm
 
* texlive-context-2009-26.1.noarch.rpm
 
  
=== freeBSD ===
+
The official page '''[http://www.pragma-ade.com/install.htm Installing CONTEXT LMTX ]''' is hosted by Pragma-Ade, which also provides
 +
* a 2 pages '''[http://lmtx.pragma-ade.nl/install-lmtx/installation.pdf installation guide]''',
 +
* a 1 page [http://distribution.contextgarden.net/current/context/experimental/doc/context/documents/general/leaflets/leaflet-context.pdf leaflet for ConTeXt LMTX]
 +
* a 1 page [http://distribution.contextgarden.net/current/context/experimental/doc/context/documents/general/leaflets/leaflet-luametatex.pdf leaflet for LuaMetaTeX].
  
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.
 
  
[[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).
+
=== Further installation instructions ===
  
=== OpenBSD ===
+
* [[Installing ConTeXt LMTX on MacOS]]
  
* [[OpenBSD installation|OpenBSD]]
 
  
== Mac OS X ==
+
----
* [[Mac Installation]]
 
  
== Windows ==
+
{{Installation navbox}}
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.
 
 
 
* [[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)]
 
  
{{Getting started navbox}}
 
  
[[Category:Installation]]
+
[[Category:Standalone]]

Revision as of 11:28, 28 May 2020

Since April 2019, there is a new major version of ConTeXt, named ConTeXt LMTX.

It is a new implementation tuned for LuaMetaTeX TeX engine, the lean and mean successor of the LuaTeX TeX engine (see article).


  • #1- Download


  • #2- Installation

    1. Create a directory for, e.g. data/context
    2. Go there and download the relevant zip for your plateform (see aside)
    3. Unpack the zip, some files will appear
    4. Execute the install program, which will take care of downloading the distribution:
      • WINDOWS: install.bat
      • UNIX: install.sh (set the executable permissions)
    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 with ConTeXt !

    You can also follow our two steps tutorial:


    #4-Update ?

    Just replay the install program, it also take care of updating the distribution:

    • 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