Difference between revisions of "Installation"
m (→GNU/Linux) |
m |
||
(36 intermediate revisions by 2 users not shown) | |||
Line 8: | Line 8: | ||
<li> | <li> | ||
=== Windows === | === Windows === | ||
− | * [http://lmtx.pragma-ade.nl/install-lmtx/context-mswin.zip 32bits] | + | * X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-mswin.zip 32bits] |
− | * [http://lmtx.pragma-ade.nl/install-lmtx/context-win64.zip 64bits] | + | * X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-win64.zip 64bits] |
− | * [http://lmtx.pragma-ade.nl/install-lmtx/context-windows-arm64.zip | + | * ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-windows-arm64.zip 64bits] |
</li> | </li> | ||
Line 16: | Line 16: | ||
=== MacOS === | === MacOS === | ||
− | * [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip 64bits] | + | * 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> | ||
<li> | <li> | ||
+ | |||
=== GNU/Linux === | === 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] | * X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip 64b] | ||
Line 30: | Line 32: | ||
=== FreeBSD === | === FreeBSD === | ||
− | * [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32bits] | + | * [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32bits] |
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.zip 64bits] | * [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.zip 64bits] | ||
</li> | </li> | ||
<li> | <li> | ||
− | === OpenBSD6. | + | |
− | * [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6. | + | === OpenBSD6.8 === |
− | * [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6. | + | * [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.8.zip 32bits] |
+ | * [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.8-amd64.zip 64bits] | ||
+ | </li> | ||
<li> | <li> | ||
− | === OpenBSD6. | + | |
− | * [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6. | + | === OpenBSD6.9 === |
− | * [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6. | + | * [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.9.zip 32bits] |
+ | * [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.9-amd64.zip 64bits] | ||
</li> | </li> | ||
</ul> | </ul> | ||
Line 52: | Line 57: | ||
</ul> | </ul> | ||
− | |||
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation). | You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation). | ||
Line 58: | Line 62: | ||
= Installation = | = 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: | |
− | * | + | * [[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 = | = Running MkIV = | ||
− | The new distribution | + | The new distribution has all the files to run the previous version of ConTeXt. |
− | * Run <code>context --luatex Hello-world.tex</code> | + | * Run <code>context --luatex Hello-world.tex</code> to use the `luatex` binary and [[MkIV]]. |
= Further installation instructions = | = Further installation instructions = |
Revision as of 12:25, 11 May 2021
Since April 2019, there is a new implementation of ConTeXt, named ConTeXt LMTX. It is tuned for LuaMetaTeX, the lean and mean successor of LuaTeX TeX engine (see article).
Download
-
Windows
-
MacOS
-
GNU/Linux
-
FreeBSD
-
OpenBSD6.8
-
OpenBSD6.9
You can 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:
echo 'export PATH=...instructions...:$PATH' >> ~/.bashrc
- Zsh:
echo 'export PATH=...instructions...:$PATH' >> ~/.zshenv
- Sh/Ksh:
echo 'export PATH=...instructions...:$PATH' >> ~/.profile
- Tcsh/csh:
echo 'set path = ($path ...instructions...)' >> ~/.cshrc
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:
echo 'export PATH=$HOME/bin/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc
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:
install.bat
- Run:
setpath.bat
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 Hello-World.tex from our Detailed example.
- Run
context Hello-world.tex
in your terminal (or command prompt). - Check the PDF output
Hello-world.pdf
.
Additional tutorials include:
See the Sample documents page for even more examples.
Upgrade
Re-run the install program to upgrade, which will update the distribution incrementally:
- Windows:
install.bat
- Unix:
sh install.sh
Running MkIV
The new distribution has all the files to run the previous version of ConTeXt.
- Run
context --luatex Hello-world.tex
to use theluatex
binary and MkIV.
Further installation instructions
- Installing ConTeXt LMTX on MacOS
- Installing Modules for ConTeXt LMTX
- The official page Installing CONTEXT LMTX is hosted by Pragma-Ade.
- Pragma-Ade also provides the CONTEXT MKIV distribution (MKIV version is LMTX predecessor) for which there is also detailed Installation instructions.
|