Difference between revisions of "Installation"

From Wiki
Jump to navigation Jump to search
(document context --luatex)
(45 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
Since April 2019, there is a new major version of ConTeXt, named '''ConTeXt LMTX'''.
+
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 [https://tug.org/TUGboat/tb40-1/tb124hagen-lmtx.pdf article]).
  
It is a new implementation tuned for LuaMetaTeX TeX engine, the lean and mean successor of the LuaTeX TeX engine (see [https://tug.org/TUGboat/tb40-1/tb124hagen-lmtx.pdf article]).
+
= Download =
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).
 
 
 
= #1. Download =
 
 
   
 
   
<ul class="DownloadRework">
+
<ul id="DownloadRework">
  
<li class="DownloadRework" style="text-align:left;">
+
<li>
 
===  Windows ===
 
===  Windows ===
<ul style="text-align:left;">
+
* [http://lmtx.pragma-ade.nl/install-lmtx/context-mswin.zip 32bits]
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-mswin.zip 32]</li>
+
* [http://lmtx.pragma-ade.nl/install-lmtx/context-win64.zip 64bits]
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-win64.zip 64]</li>
 
</ul>
 
 
</li>
 
</li>
  
<li class="DownloadRework" style="text-align:left;">
+
<li>
 
=== MacOS ===
 
=== MacOS ===
<ul style="text-align:left;">
+
* [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip 64bits]
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip 64]</li>
 
</ul>
 
 
</li>
 
</li>
  
<li class="DownloadRework" style="text-align:left;">
+
<li>
 
=== GNU/Linux ===
 
=== GNU/Linux ===
<ul style="text-align:left;">
+
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip 64b]
<small><li>X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux.zip 32] | [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip 64]</li>
+
* 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]
<li>ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-armhf.zip 32] | [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-aarch64.zip 64]</li></small>
 
</ul>
 
 
</li>
 
</li>
  
  
<li class="DownloadRework" style="text-align:left;">
+
<li>
=== Free BSD ===
 
<ul style="text-align:left;">
 
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32] (untested)</li>
 
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.zip 64]</li>
 
</ul>
 
</li>
 
  
<li class="DownloadRework" style="text-align:left;">
+
=== FreeBSD ===
=== OpenBSD6.5 ===
+
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32bits] *
<ul style="text-align:left;">
+
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.zip 64bits]
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5.zip 32] (untested)</li>
 
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5-amd64.zip 64]</li>
 
</ul>
 
 
</li>
 
</li>
  
<li class="DownloadRework" style="text-align:left;">
+
<li>
 
=== OpenBSD6.6 ===
 
=== OpenBSD6.6 ===
<ul style="text-align:left;">
+
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6.zip 32bits] *
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6.zip 32] (untested)</li>
+
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6-amd64.zip 64bits]
<li>[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6-amd64.zip 64]</li>
+
 
 +
<li>
 +
=== OpenBSD6.7 ===
 +
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.7.zip 32bits] *
 +
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.7-amd64.zip 64bits]
 +
</li>
 
</ul>
 
</ul>
 
</li>
 
</li>
Line 62: Line 49:
 
</ul>
 
</ul>
  
 +
<nowiki>*</nowiki>untested configuration.
  
= #2. Installation =
+
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).
 +
 
 +
= Installation =
  
  
 
# Create a directory for, e.g. data/context
 
# Create a directory for, e.g. data/context
# Go there and download the relevant zip for your plateform (see aside)
+
# Go there and download the relevant zip for your plateform (see above)
 
# Unpack the zip, some files will appear
 
# Unpack the zip, some files will appear
 
# Execute the install program, which will take care of downloading the distribution:
 
# Execute the install program, which will take care of downloading the distribution:
 
#* WINDOWS: <code>install.bat</code>
 
#* WINDOWS: <code>install.bat</code>
#* UNIX: <code>install.sh</code> (set the executable permissions)
+
#* UNIX/MAC: <code>sh install.sh</code>
 
# Add ConTeXt to your system PATH :
 
# Add ConTeXt to your system PATH :
#* WINDOWS: run <code>setpath.bat</code>
+
#* WINDOWS:  
 +
#** run <code>setpath.bat</code>
 
#* UNIX: use the PATH instructions provided at the end of <code>install.sh</code> with:
 
#* 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>
+
#** Bash shell <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.bashrc</code>
::: Sh/Ksh shell <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.profile</code>
+
#** Zsh shell <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.zshenv</code>
::: Tcsh/csh shell <code>echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc</code>
+
#** Sh/Ksh shell <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.profile</code>
 +
#** Tcsh/csh shell <code>echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc</code>
 +
#* MAC:
 +
#** Same as for UNIX. MacOS Catalina (10.15) defaults to `Zsh`, earlier versions defaulted to `Bash`
  
 
+
= First Run ! =
= #3. First Run with ConTeXt ! =
 
  
 
* Download the tex input file [[Media:Hello-world.tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]]
 
* Download the tex input file [[Media:Hello-world.tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]]
Line 90: Line 83:
 
* and a more [[Detailed Example|Detailed example]]
 
* and a more [[Detailed Example|Detailed example]]
  
= #4. Easy update =
+
Moreover, a page is used to centralized [[Sample documents]].
  
Just replay the install program, it also take care of updating the distribution:
+
= Easy update =
 +
 
 +
For an update, just replay the install program: it also take care of updating the distribution incrementally:
 
* WINDOWS: <code>install.bat</code>
 
* WINDOWS: <code>install.bat</code>
* UNIX: <code>install.sh</code> (set the executable permissions)
+
* UNIX: <code>sh install.sh</code>
  
 +
= Running MkIV =
  
= Official installation page =
+
The new distribution still has all the files to run the previous version of ConTeXt.  
 
+
* Run <code>context --luatex Hello-world.tex</code> in your shell to revert back to the `luatex` binary and [[MkIV]].
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].
 
  
 +
= Further installation instructions =
  
= Further installation instructions =
 
  
 
* [[Installing ConTeXt LMTX on MacOS]]
 
* [[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.
 +
* 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]].
  
  
Line 114: Line 109:
 
{{Installation navbox}}
 
{{Installation navbox}}
  
 
+
[[Category:Basics]]
[[Category:Standalone]]
+
[[Category:Installation]]

Revision as of 09:54, 7 July 2020

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

*untested configuration.

You can read the licence (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).

Installation

  1. Create a directory for, e.g. data/context
  2. Go there and download the relevant zip for your plateform (see above)
  3. Unpack the zip, some files will appear
  4. Execute the install program, which will take care of downloading the distribution:
    • WINDOWS: install.bat
    • UNIX/MAC: sh install.sh
  5. Add ConTeXt to your system PATH :
    • WINDOWS:
      • run setpath.bat
    • UNIX: use the PATH instructions provided at the end of install.sh with:
      • Bash shell echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.bashrc
      • Zsh shell echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.zshenv
      • Sh/Ksh shell echo 'export PATH=...thepathinstructions...:$PATH' >> ~/.profile
      • Tcsh/csh shell echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc
    • MAC:
      • Same as for UNIX. MacOS Catalina (10.15) defaults to Zsh, earlier versions defaulted to Bash

First Run !

You can also follow our two steps tutorial:

Moreover, a page is used to centralized Sample documents.

Easy update

For an update, just replay the install program: it also take care of updating the distribution incrementally:

  • WINDOWS: install.bat
  • UNIX: sh install.sh

Running MkIV

The new distribution still has all the files to run the previous version of ConTeXt.

  • Run context --luatex Hello-world.tex in your shell to revert back to the luatex binary and MkIV.

Further installation instructions