Open main menu

Changes

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>
{{note | The officially recommened way of installing ConTeXt on all platforms is using [[ConTeXt Minimals]]}}<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>
= 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.pragma-ade.nl/install- try running <tt>texexec lmtx/context-linuxmusl-version64.zip 64bits]</ttli> to see if it's installed on your system. If it is not installed, there are two important considerations while considering ConTeXt installation.
* 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.
If you are on a Linux system, there is also a third consideration:<li>
=== FreeBSD ===* Do you want a distribution package, or do you want your own local TeX installation14. 0 [https://lmtx.pragma-ade.com/install-lmtx/context-freebsd-amd64.zip 64bits]</li>
Depending on your OS and <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 answers to the above questionslicence]] (Creative Commons GNU GPL for program code, you should choose what to installand Creative Commons Attribution ShareAlike for documentation).
= Installation =
select your operating system (alphabetical order)
The general steps to install ConTeXt LMTX are as follows:
== 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<== GNU/code>'s dependencies will tell you what other TeX-related packages are installed but don't have 'tetex' in their names!Linux ==
* 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:
# <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:#* Alternatively, if you need to use just ConTeXt <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=...instructions...:$PATH' >> ~/.profile</code>#* <kbd>'''Tcsh/csh:'''</kbd> <code>echo 'set path = (e$path ...instructions..g. not LaTeX)' >> ~/.cshrc</code>#* For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, you can use then the following line would update the [[ConTeXt Minimals]] installationPATH environment variable: <code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/. See bashrc</code># Then generate the directions that followcache with <code>mtxrun --generate</code>.# <code>rm context-linux-64.zip</code>
== macOS ==
The instructions for MacOS are the same as for Unix, but note that:
* 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>
==Windows = Debian / (K)Ubuntu ===Debian_TeXlive_install* [[Debian installation| install ConTeXt on Debian]]* [[Ubuntu installation| install ConTeXt on Ubuntu]]* [[Debian TeXlive install| install TeXlive on Debian]]
=== Fedora ===Complete the following steps to set up ConTeXt on Windows:
Deatils # Create a directory for [httpConTeXt, such as <code>C:\context<//fedoraprojectcode>.org Fedora] # Download the architecture-specific version 11, 12 and 13 are at [httpinto the ConTeXt directory.# Extract the archive.# Run:<code>install.bat<//fedoraprojectcode># Run: <code>setpath.orgbat</wikicode># Then generate the cache with the command <code>mtxrun --generate</Features/TeXLive Fedora Project Wiki TeX Live page] maintained by Jindrich Novycode> in a command prompt. 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# Delete the file archive file context-*win*. Highly recommendedzip.=== funtoo ===
If you are using [http://funtoo.org funtoo] there are ebuilds that will make an = Check the 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.=
=== SUSE/openSUSE ===Make sure that ConTeXt is installed on your system. To check that, go to the command prompt and type
OpenSUSE (starting from 10.3beta3) comes with TeX Live and offers also XeTeX. 10.3b3 contains ConTeXt 2007.01.12. context --version
OpenSUSE 10.2 (released December 2006) uses teTeX 3.0 and contains the 2005.01.31 version of ConTeXt that is standard in teTeX 3.0. The package is <tt>te_cont</tt>. [httpYou should get an output as follows://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> packages.
For older distributions see also: [http mtx-context | ConTeXt Process Management 1.06 mtx-context | mtx-context | main context file:/home/myuser/context/tex/texmf-context/tex/context/base/mkiv/homecontext.mkiv mtx-context | current version: 2024.salamander04.com01 08:59 mtx-context | main context file: /home/~wmcclainmyuser/context/tex/texmf-helpcontext/tex/context/base/mkxl/context.html#oldmkxl mtx-installation]context | current version: 2024.04.01 08:59
= Upgrade =
== MAC OSX ==* [[Mac Installation]]Re-run the install program to upgrade, which will update the distribution incrementally:
== Unix ==* Windows: <code>install.bat</code>* [[OpenBSD installation|OpenBSD]]GNU/Linux or macOS: <code>sh install.sh</code>
=First document = Windows  == Creation of a first ConTeXt file ==There are two main TeX distributions for Windows wich contain Open a stable context* [[MikTeXText Editors|text editor]] (currently ''', type the following content, and save the file as <code>doc01.tex</code>: <texcode>\setuppapersize[A6]\starttext\startsection[title={Testing ConTeXt support }]This is broken'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 >   mkiv 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/secondsystem | total runtime: 1.989 seconds of 2.052 seconds</nowiki></pre> == Viewing the generated PDF file == Open the generated <tt>doc01.pdf</tt> PDF file using a [http://en.wikipedia.org/wiki/List_of_PDF_software#Viewers PDF viewer]. It should look as follows: <context force="yes">\setuppapersize[TeX-liveA6]\starttext\startsection[title={Testing ConTeXt}] (provides stable This is my first ConTeXt)document.\stopsection\stoptext</context> Note that the section has been numbered, the section number and the section title appear in a slightly larger fonts. Your installation is now up and running: you can start working on the [[Tutorials]].
Use [[ConTeXt Minimals]], if you want up to date ConTeXt.= Additional instructions =
* [[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]].* 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>
== Installation from source ==
* [[TeX-live | TeX-live installation]]: Specific installation instructions using the TeX-live source distribution.
* [[Installation hints]]
[[Category:Basics]]
[[Category:Installation]]
1,031

edits