gardener, Interface administrators, Administrators
1,544
edits
Changes
Jump to navigation
Jump to search
m
< __NOTOC__Since April 2019, there is a new implementation of ConTeXt, named '''ConTeXt [[Installation hintsLMTX]] | ['''. It is tuned for LuaMetaTeX, the lean and mean successor of LuaTeX TeX engine (see [TeX Distributions]https://tug.org/TUGboat/tb40-1/tb124hagen-lmtx.pdf article] >).
{{note | The officially recommened way of installing ConTeXt on all platforms is using <li>=== Windows ===* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-mswin.zip 32bits]* X86 [ConTeXt Minimalshttps://lmtx.pragma-ade.com/install-lmtx/context-win64.zip 64bits]* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-windows-arm64.zip 64bits]}}</li>
Most [[TeX Distributions]] include an installation of ConTeXt already -- try running <ttli>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.
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>
Depending on your OS and the answers to === 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 above questionslicence]] (Creative Commons GNU GPL for program code, you should choose what to installand Creative Commons Attribution ShareAlike for documentation).
select your operating system (alphabetical order)
== Linux ==In decreasing order of simplicity, here are a few options:See the next sections for instructions specific to various platforms.
* (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]].* 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>== Unix ==
<code>rpm</code>'s dependencies will tell you what other TeXThe steps in this section show how to download and install ConTeXt for a 64-related packages are installed but don't have 'tetex' in their names!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# mkdir $HOME/context# cd $HOME/context# wget https://lmtx. 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 outpragma-ade.com/install-lmtx/context-linux-64.zipIf you will use TeX Live, you have to delete the distribution# unzip context-provided teTeX packages (if they exist)linux-64.zip# sh install. sh
* Alternatively, if you need to use just ConTeXt (e.g. not LaTeX), you can use Update the PATH environment variable by using the path instructions displayed when the [[ConTeXt Minimals]] installationinstall program finishes. See The instructions will vary depending on the directions that follow.type of shell being used:
=== Fedora ===The instructions for MacOS are the same as for Unix, but note that:
Deatils for [http://fedoraproject* MacOS versions from Catalina (10.org Fedora] version 11, 12 15) and 13 are at [http://fedoraprojectnewer use '''Zsh''' by default.org/wiki/Features/TeXLive Fedora Project Wiki TeX Live page] maintained * MacOS versions before Catalina use '''Bash''' 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 recommendeddefault.=== 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 Minimals Funtoo]] Howto. This might also work for [http://www.gentoo.org gentoo], but is untested right now.== Windows ==
=== SUSE/openSUSE ===Complete the following steps to set up ConTeXt on Windows:
OpenSUSE (starting from 10# Create a directory for ConTeXt, such as `C:\context`.3beta3) comes with TeX Live and offers also XeTeX. 10# Download the architecture-specific version into the ConTeXt directory.3b3 contains ConTeXt 2007# Extract the archive.01# Run: <code>install.12bat</code># Run: <code>setpath.bat</code>
OpenSUSE 10.2 (released December 2006) uses teTeX 3.0 and contains the 2005.01.31 version of ConTeXt that Installation is standard in teTeX 3.0. The package is <tt>te_cont</tt>. [http://download.opensuse.org/distribution/10.2/repo/oss/suse/i586/|Here]is an RPM repository where you can find it, but you should be able to install it using automated tools. Then you'll want to upgrade to a more recent version of ConTeXt. As with Suse 10 (see next paragraph), you'll also need the <tt>te_mpost</tt> and <tt>ruby</tt> packagescomplete.
For older distributions see also: [http://home.salamander.com/~wmcclain/context-help.html#old-installation]= First Run =
== MAC OSX ==* # Download the tex input file [[Media:Hello-world.tex|Hello-World.tex]] from our [[Mac InstallationDetailed_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>.
== Unix ==Additional tutorials include: * [[First Document| Your first document]]* [[OpenBSD installationDetailed Example|OpenBSDDetailed example]] See the [[Sample documents]] page for even more examples. = Upgrade = Re-run the install program to upgrade, which will update the distribution incrementally: * Windows: <code>install.bat</code>* Unix: <code>sh install.sh</code> = Running MkIV =
== Windows ==There are two main TeX distributions for Windows wich contain a stable context* [[MikTeX]] (currently '''The new distribution has all the files to run the previous version of ConTeXt support is broken'''). * Run <code>context --luatex Hello-world.tex</code> to use the `luatex` binary and [[TeX-liveMkIV]] (provides stable ConTeXt).
Use [[ConTeXt Minimals]], if you want up to date ConTeXt.= Further installation instructions =
== 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 (2001)]* [http://watershade.net/wmcclain/context-help.html#install Bill's page (2003)]{{Installation navbox}}
re-add Linux 32bit link
= Download =
<ul id="DownloadRework">
<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>
=== GNU/Linux ===* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-linux.zip 32bits]* Do you want a ConTeXt distribution or do you want a TeX distribution (plain TeX, LaTeX, ConTeXt, and lots of other goodies)X86 [https://lmtx.pragma-ade. com/install-lmtx/context-linux-64.zip 64bits]* Do you want a stable version of ConTeXt, or do you want the bleeding edge versionARM [https://lmtx. Remember that ConTeXt gets updated frequentlypragma-ade.com/install-lmtx/context-linux-aarch64.zip 64bits]* Musl [https://lmtx.pragma-ade.nl/install-lmtx/context-linuxmusl-64.zip 64bits]</li>
= Installation =
The general steps to install ConTeXt LMTX are as follows:
# 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.
* '''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>
For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable:
<code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code>
Then generate the cache with <code>mtxrun --generate</code>.=== Debian / (K)Ubuntu =MacOS ==Debian_TeXlive_install* [[Debian installation| install ConTeXt on Debian]]* [[Ubuntu installation| install ConTeXt on Ubuntu]]* [[Debian TeXlive install| install TeXlive on Debian]]
This section describes how to run ConTeXt to transform your first TeX document into a PDF.
* [[Windows InstallationInstalling ConTeXt LMTX on MacOS]]* [[Simple Windows InstallationModules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]]* 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]].
----
[[Category:Basics]]
[[Category:Installation]]
