770
edits
Changes
Jump to navigation
Jump to search
{{note | The officially recommended way of installing ConTeXt on all platforms is using [[ConTeXt Standalone]]}}<li>
= Look before you leap =<li>
Most === GNU/Linux ===* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-linux.zip 32bits]* X86 [TeX Distributionshttps://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip 64bits]* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-linux-aarch64.zip 64bits] include an installation of ConTeXt already* Musl [https://lmtx.To see if it's installed on your system run pragma-ade.nl/install-lmtx/context -linuxmusl-version64.zip 64bits]</li>
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.<li>
If you are on a Linux system, there is also a third consideration=== FreeBSD ===* 14.0 [https://lmtx.pragma-ade.com/install-lmtx/context-freebsd-amd64.zip 64bits]</li>
select your operating system
== Unix (linux/bsd/...) ==In decreasing order of simplicity, here The general steps to install ConTeXt LMTX are a few optionsas follows:
* (simplest) If you distribution supports [[TeX Live]] packages, use them# Create a directory for ConTeXt. Debian, Ubuntu, openSUSE, Gentoo, Fedora, Arch and Mandriva (if not too old) do so# Download the platform-specific archive file into the ConTeXt directory. See [[Debian installation]] or [[Ubuntu installation]]# Unpack the archive.* Otherwise# Execute the install program, use a fresh [[TeX Live]] installationwhich downloads the distribution. The problem with this method is that you'll probably have to redo the installation once a year, when # Update the new TeX Live DVD comes outPATH environment variable.If you will use TeX Live# Generate cache# Optionally, you have to delete the distribution-provided teTeX packages (if they exist)archive file.
If you are running an rpm-based distribution (RedHat, Fedora, Mandrake, Mandriva etcSee the 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!
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. == GNU/Linux ==
* Alternatively, if you need '''just ConTeXt The steps in this section show how to download and no LaTeX''', you can use the [[install ConTeXt Standalone]] installationfor a 64-bit Linux system. The ConTeXt Standalone installation does not require Change the de-installation of other TeX distributions and can be used in parallelarchive file download link as needed for your target platform.Open a new terminal then run the following commands:
Detils 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 ===* MacOS versions from Catalina (10.15) and newer use '''Zsh''' by default.* MacOS versions before Catalina use '''Bash''' by default.* You might need to de-quarantine the binaries (and sometimes every created PDF):** <code>sudo xattr -r -d com.apple.quarantine bin/mtxrun</code>** <code>sudo xattr -r -d com.apple.quarantine tex/texmf-osx-64/bin/*</code>
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.== Windows ==
=== openSUSE ===Complete the following steps to set up ConTeXt on Windows:
OpenSUSE (starting from 10# Create a directory for ConTeXt, such as <code>C:\context</code>.# Download the architecture-specific version into the ConTeXt directory.3beta3) comes with TeX Live and offers also XeTeX# Extract the archive.# Run: <code>install. 10bat</code># Run: <code>setpath.3b3 contains ConTeXt 2007bat</code># Then generate the cache with the command <code>mtxrun --generate</code> in a command prompt.01# Delete the file archive file context-*win*.12zip.
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.rpmCheck the installation =
=== freeBSD ===Make sure that ConTeXt is installed on your system. To check that, go to the command prompt and type
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 context -texlive/wiki/Installing] and [http://romain.blogreen.org/blog/2011/08/texlive-2011-on-freebsd/], until migration to the main ports branch is completed.version
[[TeX Live]] You should get an output as a standalone installation will run on all recent versions of freeBSD (7, 8, 9); The [[ConTeXt Standalone]] installation is compiled for the latest stable release (currently 8.2).follows:
The ConTeXt Standalone distribution does not currently support OpenBSDmkiv lua stats > used engine: luametatex version: 2.11.02, functionality level: 20240311, format id: 700, compiler: gccmkiv lua stats > tex properties: 807100 hash slots used of 2097152, 51019 control sequences, approximate memory usage: 42 MBmkiv lua stats > lua properties: engine: lua 5.5, used memory: 57 MB, ctx: 54 MB, max: 54 MB, symbol mask: utf (τεχ)mkiv lua stats > runtime: 0.617 seconds, 1 processed pages, 1 shipped pages, 1.620 pages/second* [[OpenBSD installationsystem |OpenBSD]]total runtime: 1.989 seconds of 2.052 seconds</nowiki></pre>
== Windows ==There are two main TeX distributions for Windows wich contain Open the generated <tt>doc01.pdf</tt> PDF file using a stable context* [[MikTeX]] (currently '''ConTeXt support is broken''')* [[TeX Live]http://en.wikipedia.org/wiki/List_of_PDF_software#Viewers PDF viewer] (provides stable ConTeXt). It should look as follows:
Use <context force="yes">\setuppapersize[A6]\starttext\startsection[title={Testing ConTeXt Standalone]}], if you want up to date This is my first ConTeXtdocument.\stopsection\stoptext</context>
* [[Windows Installation]]* [[Simple Windows Installation]]Note that the section has been numbered, the section number and the section title appear in a slightly larger fonts.
== Installation from source == * [[TeX-live | TeX-live Your installation]]is now up and running: Specific installation instructions using you can start working on the TeX-live source distribution.* [[Installation hintsTutorials]].
== external manuals * [[Installing ConTeXt LMTX on installation ==MacOS]]* [[Modules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]]* The official page '''[http://www.pragma-ade.comnl/generalinstall.htm Installing ConTeXt LMTX ]''' is hosted by Pragma ADE.* Pragma ADE also provides the '''[http:/manuals/minstallwww.pragma-ade.pdf How to install context nl/download-1.htm ConTeXt MkIV distribution]''' (outdated 2001version MkIV is the predecessor of LMTX)for which there are also [[ConTeXt_Standalone|detailed installation instructions]].* Compilation with ConTeXt MkIV (old LuaTeX-based version): The new distribution has all the files to run the previous version of ConTeXt.** <code>context --luatex doc01</code>
no edit summary
= Download = < [[Installation hints]] | [[TeX Distributions]] ul id="DownloadRework">
<li>
=== Windows ===
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-mswin.zip 32bits]
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-win64.zip 64bits]
* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-windows-arm64.zip 64bits]
</li>
=== 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>
<li> === OpenBSD ===* Do you want a '''distribution package'''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 licence]] (Creative Commons GNU GPL for program code, or do you want your own '''local TeX''' installationand Creative Commons Attribution ShareAlike for documentation).
= Installation =
# <code>mkdir $HOME/context</code> and <code>cd $HOME/context</code># <code>wget https://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip</code># <code>unzip context-linux-64.zip</code># <code>sh install.sh</code># 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:#* <kbd>'''Bash: '''</kbd> <code>echo 'export PATH=...instructions...:$PATH' >> ~/.bashrc</code>#* <kbd>'''Zsh: '''</kbd> <code>echo 'export PATH=...instructions...:$PATH' >> ~/.zshenv</code>#* <kbd>'''Sh/Ksh: '''</kbd> <code>echo 'export PATH= Debian ...instructions...:$PATH' >> ~/ .profile</code>#* <kbd>'''Tcsh/csh:'''</kbd> <code>echo 'set path = (K$path ...instructions...)Ubuntu ===Debian_TeXlive_install (Debian' >> ~/linux and Debian.cshrc</kfreebsd)code>#* [[Debian installation| install For example, if ConTeXt was downloaded into `$HOME/context` on Debian]]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>* [[Ubuntu installation| install ConTeXt on Ubuntu]]# Then generate the cache with <code>mtxrun --generate</code>.* [[Debian TeXlive install| install TeXlive on Debian]]# <code>rm context-linux-64.zip</code>
=== Fedora =macOS ==
mtx-context | ConTeXt Process Management 1.06 mtx-context | mtx-context | main context file: /home/myuser/context/tex/texmf-context/tex/context/base/mkiv/context.mkiv mtx-context | current version: 2024.04.01 08:59 mtx-context | main context file: /home/myuser/context/tex/texmf-context/tex/context/base/mkxl/context.mkxl mtx-context | current version: 2024.04.01 08:59 =Upgrade = Re-run the install program to upgrade, which will update the distribution incrementally: * Windows: <code>install.bat</code>* GNU/Linux or macOS: <code>sh install.sh</code> = OpenBSD First document = ==Creation of a first ConTeXt file == Open a [[Text Editors|text editor]], type the following content, and save the file as <code>doc01.tex</code>: <texcode>\setuppapersize[A6]\starttext\startsection[title={Testing ConTeXt}]This is my first ConTeXt document.\stopsection\stoptext</texcode> == Compilation of the ConTeXt file to PDF file == Go to the command-line and type: <pre>context doc01</pre> ConTeXt will then process your document, display some logging information on the console, and generate a <tt>doc01.pdf</tt> output file. <pre><nowiki>resolvers | formats | executing runner 'run luametatex format': /home/myuser/context/tex/texmf-linux-64/bin/luametatex --jobname="./doc01.tex" --socket --shell-escape --fmt=/home/myuser/context/tex/texmf-cache/luametatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luametatex/cont-en.fmt --lua=/home/myuser/context/tex/texmf-cache/luametatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luametatex/cont-en.lui --c:currentrun=1 --c:fulljobname="./doc01.tex" --c:input="./doc01.tex" --c:kindofrun=1 --c:maxnofruns=9 --c:texmfbinpath="/home/myuser/context/tex/texmf-linux-64/bin"system > system > ConTeXt ver: 2024.04.01 08:59 LMTX fmt: 2024.4.13 int: english/englishsystem > …
== Mac OS X Viewing the generated PDF file ==* [[Mac Installation]]
= Additional instructions =
[[Category:Basics]]
[[Category:Installation]]
