Difference between revisions of "Installation"

From Wiki
Jump to navigation Jump to search
m
(document context --luatex)
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
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]).
+
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]).
  
= #1. Download =
+
= Download =
 
   
 
   
 
<ul id="DownloadRework">
 
<ul id="DownloadRework">
Line 29: Line 29:
 
* [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>
 
=== OpenBSD6.5 ===
 
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5.zip 32bits] *
 
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.5-amd64.zip 64bits]
 
 
</li>
 
</li>
  
Line 41: Line 35:
 
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6.zip 32bits] *
 
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6.zip 32bits] *
 
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6-amd64.zip 64bits]
 
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd6.6-amd64.zip 64bits]
 +
 +
<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 53: Line 53:
 
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).
  
= #2. Installation =
+
= Installation =
  
  
Line 61: Line 61:
 
# 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>
#* MAC:
+
#* UNIX/MAC: <code>sh install.sh</code>
#** If MacOS Catalina (10.15+), 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 :
 
# 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>
 +
#** Zsh shell <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.zshenv</code>
 
#** Sh/Ksh shell <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.profile</code>
 
#** Sh/Ksh shell <code>echo 'export PATH=...thepathinstructions...:$PATH'  >> ~/.profile</code>
 
#** Tcsh/csh shell <code>echo 'set path = ($path ...thepathinstructions...)' >> ~/.cshrc</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`
  
= #3. First Run ! =
+
= First Run ! =
  
 
* 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 82: Line 83:
 
* and a more [[Detailed Example|Detailed example]]
 
* and a more [[Detailed Example|Detailed example]]
  
 +
Moreover, a page is used to centralized [[Sample documents]].
  
= #4. Easy update =
+
= Easy update =
  
 
For an update, just replay the install program: it also take care of updating the distribution incrementally:
 
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>
  
= Official installation page =
+
= Running MkIV =
  
The official page '''[http://www.pragma-ade.com/install.htm Installing CONTEXT LMTX ]''' is hosted by Pragma-Ade, which also provides
+
The new distribution still has all the files to run the previous version of ConTeXt.  
* a 2 pages '''[http://lmtx.pragma-ade.nl/install-lmtx/installation.pdf installation guide]''',
+
* Run <code>context --luatex Hello-world.tex</code> in your shell to revert back to the `luatex` binary and [[MkIV]].
* 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 106: 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