Open main menu
Wiki

Changes

Installation (view source)

Revision as of 19:23, 14 April 2024

3,291 bytes added ,  14 April
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:
 
# 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.
== 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>== GNU/Linux ==
<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:
# <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>#* Otherwise, use a fresh [[TeX Live]] installation<kbd>'''Sh/Ksh: '''</kbd> <code>echo 'export PATH=...instructions... :$PATH' The problem with this method is that you>> ~/.profile</code>#* <kbd>'''Tcsh/csh:'''</kbd> <code>echo 'set path = ($path ...instructions...)'ll probably have to redo the installation once >> ~/.cshrc</code>#* For example, if ConTeXt was downloaded into `$HOME/context` on a yearsystem running bash, when then the following line would update the new TeX Live DVD comes outPATH environment variable: <code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code>If you will use TeX Live, you have to delete # Then generate the distributioncache with <code>mtxrun --generate</code>.# <code>rm context-provided teTeX packages (if they exist)linux-64. zip</code>
* Alternatively, if you need to use just ConTeXt (e.g. not LaTeX), you can use the [[ConTeXt Minimals]] installation. See the directions that follow.== 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 Complete the following steps to set up ConTeXt on Debian]]* [[Ubuntu installation| install ConTeXt on Ubuntu]]* [[Debian TeXlive install| install TeXlive on Debian]]Windows:
=== Fedora ===# Create a directory for ConTeXt, such as <code>C:\context</code>.# Download the architecture-specific version into the ConTeXt directory.# Extract the archive.# Run: <code>install.bat</code># Run: <code>setpath.bat</code># Then generate the cache with the command <code>mtxrun --generate</code> in a command prompt.# Delete the file archive file context-*win*.zip.
Deatils 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.=== funtoo ==Check the installation =
If you are using [http://funtoo.org funtoo] there are ebuilds Make sure that will make an installation as easy as installing any other package from portage. Take a look at the [[ConTeXt Minimals Funtoo]] Howtois installed on your system. This might also work for [http://www.gentoo.org gentoo]To check that, but is untested right now.go to the command prompt and type
=== SUSE/openSUSE === context --version
OpenSUSE (starting from 10.3beta3) comes with TeX Live and offers also XeTeX. 10.3b3 contains ConTeXt 2007.01.12.You should get an output as follows:
OpenSUSE 10 mtx-context | ConTeXt Process Management 1.2 (released December 2006) uses teTeX 306 mtx-context | mtx-context | main context file: /home/myuser/context/tex/texmf-context/tex/context/base/mkiv/context.0 and contains the 2005.01.31 mkiv mtx-context | current version of ConTeXt that is standard in teTeX 3: 2024.004. The package is <tt>te_cont</tt>. 01 08:59[http mtx-context | main context file:/home/download.opensuse.orgmyuser/context/distributiontex/10.2texmf-context/repotex/osscontext/susebase/i586mkxl/context.mkxl mtx-context |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 current version of ConTeXt: 2024. As with Suse 10 (see next paragraph), you'll also need the <tt>te_mpost</tt> and <tt>ruby</tt> packages04.01 08:59
For older distributions see also: [http://home.salamander.com/~wmcclain/context-help.html#old-installation]= Upgrade =
Re-run the install program to upgrade, which will update the distribution incrementally:
== MAC OSX ==* Windows: <code>install.bat</code>* [[Mac Installation]]GNU/Linux or macOS: <code>sh install.sh</code>
=First document = Unix ==* [[OpenBSD installation|OpenBSD]]
== 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>
Use [[ConTeXt Minimals]]Note that the section has been numbered, if you want up to date ConTeXtthe 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 [[Windows Installation]]* [[Simple Windows InstallationTutorials]].
=Additional instructions = Installation from source == * [[TeX-live | TeX-live installation]]: Specific installation instructions using the TeX-live source distribution.* [[Installation hints]]
* [[Installing ConTeXt LMTX on MacOS]]
* [[Modules#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>
== 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)]
[[Category:Basics]]
[[Category:Installation]]
Garulfoo
1,047

edits

Retrieved from "https://wiki.contextgarden.net/Special:MobileDiff/12534...34679"