gardener, Interface administrators, Administrators
3,893
edits
Changes
Jump to navigation
Jump to search
m
<nowiki>*</nowiki>untested configuration.
# Create a directory for, e.g. data/context# Go there and download the relevant zip for your plateform (see above)# Unpack the zip, some files will appear# Execute the install program, which will take care of downloading the distribution:#* WINDOWS: <code>install.bat</code>#* MAC: #** If MacOS Catalina (10.15+), [[First Document| Your first allow mtxrun as unsigned executable with:#*: <code>xattr -d com.apple.quarantine context-osx-64/bin/mtxrun</code>#** execute <code>sh install.sh</code>#* UNIX: <code>sh install.sh</code># Add ConTeXt to your system PATH :#* WINDOWS: #** run <code>setpath.bat</code>#* MAC:document]]#** Bash shell (pre-catalina) <code>echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.bashrc</code>#** Zsh shell (Catalina) <code>echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.zshenv</code>#* UNIX: use the PATH instructions provided at the end of <code>install.sh</code> with:#** Bash shell <code>echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.bashrc</code>#** Zsh shell <code>echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.zshenv</code>#** Sh/Ksh shell <code>echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.profile</code>#** Tcsh/csh shell <code>echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc</code>[[Detailed Example|Detailed example]]
= First Run ! =See the [[Sample documents]] page for even more examples.
* 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 shell* Check the pdf output <code>Hello-world.pdf</code>.= Upgrade =
You can also follow our two steps tutorialRe-run the install program to upgrade, which will update the distribution incrementally:* [[First Document| Your 1st document]]* and a more [[Detailed Example|Detailed example]]
Moreover, a page is used to centralized [[Sample documents]]* Windows: <code>install.bat</code>* Unix: <code>sh install.sh</code>
For an update, just replay The new distribution has all the files to run the install program: it also take care previous version of updating the distribution incrementally:ConTeXt. * WINDOWS: Run <code>installcontext --luatex Hello-world.battex</code>* UNIX: <code>sh installto use the `luatex` binary and [[MkIV]].sh</code>
no edit summary
<li>
=== Windows ===
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-mswin.zip 32bits]* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-win64.zip 64bits]* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-windows-arm64.zip 64bits]
</li>
<li>
=== MacOS ===
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip 64bits]* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-arm64.zip 64bits]
</li>
<li>
=== GNU/Linux ===
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip 64b]
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-armhf.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-linux-aarch64.zip 64b]
* Musl [http://lmtx.pragma-ade.nl/install-lmtx/context-linuxmusl.zip 64b]
</li>
=== FreeBSD ===
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32bits] *
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.zip 64bits]
</li>
<li>
=== OpenBSD6.6 8 ===* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.68.zip 32bits] ** [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.68-amd64.zip 64bits]</li>
<li>
=== OpenBSD6.7 9 ===* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.79.zip 32bits] ** [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.79-amd64.zip 64bits]
</li>
</ul>
</ul>
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).
= 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.
# Optionally, delete the archive file.
See the next sections for instructions specific to various platforms.
== Unix ==
The steps in this section show how to download and install ConTeXt for a 64-bit Linux system. Change the archive file download link as needed for your target platform. Open a new terminal then run the following commands:
# mkdir $HOME/bin/context
# cd $HOME/bin/context
# wget http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip
# unzip context-linux-64.zip
# sh install.sh
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/bin/context` on a system running bash, then the following line would update the PATH environment variable:
<code>echo 'export PATH=$HOME/bin/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</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.
== Windows ==
Complete the following steps to set up ConTeXt on Windows:
# Create a directory for ConTeXt, such as `C:\context`.
# Download the architecture-specific version into the ConTeXt directory.
# Extract the archive.
# Run: <code>install.bat</code>
# Run: <code>setpath.bat</code>
Installation is complete.
= First Run =
This section describes how to run ConTeXt to transform your first TeX document into a PDF.
# 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:
= Easy update Running MkIV =
= Further installation instructions =
* [[Installing ConTeXt LMTX on MacOS]]
* [[Modules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]]
* The official page '''[http://www.pragma-ade.com/install.htm Installing CONTEXT LMTX ]''' is hosted by Pragma-Ade, which also provides** a 2 pages '''[http://lmtx.pragma-ade.nl/install-lmtx/installation.pdf installation guide]''',** a 1 page [http://distribution.contextgarden.net/current/context/experimental/doc/context/documents/general/leaflets/leaflet-context.pdf leaflet for ConTeXt LMTX]** a 1 page [http://distribution.contextgarden.net/current/context/experimental/doc/context/documents/general/leaflets/leaflet-luametatex.pdf leaflet for LuaMetaTeX].
* Pragma-Ade also provides the '''[http://www.pragma-ade.com/download-1.htm CONTEXT MKIV distribution]''' (MKIV version is LMTX predecessor) for which there is also [[ConTeXt_Standalone|detailed Installation instructions]].
