gardener, Interface administrators, Administrators
1,546
edits
Changes
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 ==# 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 cacheIn decreasing order of simplicity# Optionally, here are a few options:delete the archive file.
* (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 etcthe next sections for instructions specific to various platforms.), 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!== Unix ==
* Otherwise, use a fresh [[TeX Live]] installation. The problem with steps in this method is that you'll probably have section show how to redo download and install ConTeXt for a 64-bit Linux system. Change the installation once archive file download link as needed for your target platform. Open a year, when the new TeX Live DVD comes out.If you will use TeX Live, you have to delete terminal then run the distribution-provided teTeX packages (if they exist). following commands:
* Alternatively, if you need to use just ConTeXt (e# mkdir $HOME/context# cd $HOME/context# wget https://lmtx.gpragma-ade. not LaTeX), you can use the [[ConTeXt Minimals]] installationcom/install-lmtx/context-linux-64. See the directions that followzip# unzip context-linux-64.zip# sh install.sh
Deatils The instructions for MacOS are the same as for [http://fedoraproject.org Fedora] version 11Unix, 12 and 13 are at [httpbut note that://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.=== funtoo ===
If you are using [http://funtoo.org funtoo] there are ebuilds that will make an installation as easy as installing any other package * MacOS versions from portage. Take a look at the [[ConTeXt Minimals Funtoo]] Howto. This might also work for [http://wwwCatalina (10.gentoo15) and newer use '''Zsh''' by default.org gentoo], but is untested right now* MacOS versions before Catalina use '''Bash''' by default.
OpenSUSE (starting from 10.3beta3) comes with TeX Live and offers also XeTeX. 10.3b3 contains Complete the following steps to set up ConTeXt 2007.01.12.on Windows:
OpenSUSE 10# Create a directory for ConTeXt, such as `C:\context`.2 (released December 2006) uses teTeX 3.0 and contains # Download the 2005.01.31 architecture-specific version of into the ConTeXt that is standard in teTeX 3directory.0# Extract the archive. The package is # Run: <ttcode>te_continstall.bat</ttcode>. [http# Run://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 <ttcode>te_mpostsetpath.bat</ttcode> and <tt>ruby</tt> packages.
For older distributions see also: [http://homeInstallation is complete.salamander.com/~wmcclain/context-help.html#old-installation]
== MAC OSX ==* [[Mac Installation]]This section describes how to run ConTeXt to transform your first TeX document into a PDF.
== Windows ==There are two main TeX distributions for Windows wich contain a stable context* [[Installing ConTeXt LMTX on MacOS]]* [[MikTeXModules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]] (currently * The official page '''[http://www.pragma-ade.nl/install.htm Installing ConTeXt support is brokenLMTX ]''')is hosted by Pragma ADE.* Pragma ADE also provides the '''[[TeXhttp://www.pragma-ade.nl/download-live]1.htm ConTeXt MkIV distribution] ''' (provides stable ConTeXtversion MkIV is the predecessor of LMTX)for which there are also [[ConTeXt_Standalone|detailed installation instructions]].
Use [[ConTeXt Minimals]], if you want up to date ConTeXt.
* [[Windows Installation]]* [[Simple Windows Installation]]----
== {{Installation from source == * [[TeX-live | TeX-live installation]]: Specific installation instructions using the TeX-live source distribution.* [[Installation hints]]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:
Update the PATH environment variable by using the path instructions displayed when the install program finishes. The instructions will vary depending on the type of shell being used:
* '''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=== Debian $HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</ (K)Ubuntu ===Debian_TeXlive_install* [[Debian installation| install ConTeXt on Debian]]* [[Ubuntu installation| install ConTeXt on Ubuntu]]* [[Debian TeXlive install| install TeXlive on Debian]]code>
Then generate the cache with <code>mtxrun --generate</code>.=== Fedora =MacOS ==
=== SUSE/openSUSE =Windows ==
= First Run =
# 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 terminal (or command prompt).# Check the PDF output <code>Hello-world.pdf</code>. Additional tutorials include: * [[First Document| Your first document]]* [[Detailed Example|Detailed 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 = The new distribution has all the files to run the previous version of ConTeXt. * Run <code>context --luatex Hello-world.tex</code> to use the `luatex` binary and [[OpenBSD installation|OpenBSDMkIV]]. = Further installation instructions =
[[Category:Basics]]
[[Category:Installation]]