Changes

Since April 2019, there is a new flavor of ConTeXtfew users have encountered difficulties in installing, named « LuaMetaTeX » meant and updating to integrate Lua, Metapost and TeXbeta releases of [[Installation|ConTeXt LMTX]] on macOS, below we describe an installation procedure for macOS. For other platforms the latter meaning ConTeXt.It is going to be self-contained and smaller than previous versions of ConTeXt mkiv and mkiiprocedures are more or less analogous.

Since a few users have encountered difficulties First download [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip context-osx-64.zip]. Put the unzipped folder {{code|context-osx-64/}} wherever you wish—for instance, in installing, and updating your home directory. Thus the path to, beta releases of LuaMetaTeX your future LMTX directory will be {{code|'''~/context-osx-64/'''}} (from now on MacOS, below this is what we describe an installtion procedure for MacOS. For other platforms the procedures are more or less analogousassume).

 == Installing on MacOS up to 10.14 == * '''Beware:''' As of December 2019, the following instructions work for MacOS up to version 10.14 but do not work for MacOS 10.15 Catalina, due to the Apple's System Integrity Protection (SIP). Please see the dedicated section for installing on MacOS 10.15 Catalina * First download http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip  * Put the unzipped folder « context-osx-64 « wherever you wish: for instance in your home directory. Thus the path to your future LuaMetaTeX directory will be (and below this is what we assume) ~/context-osx-64/ * Open a Terminal window ({{code|Terminal.app }} is found in {{code|/Applications/Utilities/}}). In the Terminal window type cd '''~/context-osx-64/''' * Then you should be able to execute the command

* It may happen After that MacOS , if everything goes smoothly, a complete functioning tree of LMTX, complete with dozens of manuals, will not allow be installed in {{code|'''~/context-osx-64/'''}}. Whenever you want to execute the above shell commandupdate your installation of LMTX, or the mtxrun script which it is called by install.sh. In enough to go to that case, you should open the System Préferences (from the Apple menu) and there choose Security directory in Terminal & Privacy, and go to the General pane. There you should be able to authorize run the shell installation script, which has been blocked, to be executed. After that you issue again the command:

* After that, if everything goes smoothly a complete functionning tree of LuaMetaTeX, complete with dozens of manuals, will be installed in == Running LMTX from the folder ~/context-osx-64/and whenever you want to update your installation of LuaMetaTeX, it is enough to go to the above directory in Terminal and do again sh install.sh==

* If you want to use LuaMetaTeX run LMTX from the Terminal interface in any directory, you should add the path of your installation to $PATH by adding this to your {{code|.bashrc}} (10.14 and earlier) or {{code|.zshenv}} (10.15) (or any other another configuration file, depending on your flavor of shell interface you are using) the line: export PATH=~/context-osx-64/tex/texmf-osx-64/bin:~/context-osx-64/bin$PATH:'''~/context-osx-64/'''tex/texmf-osx-64/bin:$PATH(if you have installed « context-osx-64 » elsewhere, please replace the segment « ~/context-osx-64 » with the path to that folder).

* A better choice is to use TeXShop [https''Reminder://pages.uoregon.edu/koch/texshop/obtaining.html]. Once TeXShop is if you have installed, go to ~/Library/TeXShop/Engineand there duplicate for instance the file « ConTeXt (LuaTeX).engine » (or any other of the files « .engine »). Name the duplicate LuaMetaTeX.engineand open it in TeXShop (or any text editor). Replace the content of the file « LuaMetaTeX.engine » with the following lines: #!/bin/bash export PATH=~/{{code|context-osx-64/tex/texmf-osx-64/bin:}} elsewhere, please replace the segment {{code|'''~/context-osx-64/bin:~/context-osx-64/tex/texmf-osx-64/bin ~/context-osx-64/tex/texmf-osx-64/bin/mtxrun --autogenerate --script context --directives="system.showerror" --autopdf "$1" --purgeallthen save and close '''}} in the above code with the filepath to that directory. ''

* If you want to use LuaMetaTeX as your default TeX typesetter in TeXShop, go to TeXShop -> Preferences, then under the tab « Typesetting » and the « Default Command » section choose the radio button « Command listed below « and below that type LuaMetaTeX * In principle, once the above your PATH has been addedmodified, typing in a Terminal window

you should get the path to context the ConTeXt binary and its version. If this is the case, then you can typeset a file named « {{code|myfile.tex » }} from the Terminal by typing:

* ---- It may happen that for some reasons reason not everything goes smoothly and & you cannot typeset any document. In that case, try typing in a Terminal window:

in order to see whether {{code|'''~/context-osx-64/'''tex/texmf-osx-64/bin/luametatex}} is present or not. * If not, the download has not been completeis incomplete.

* If {{code|luametatex }} is present, in the Terminal type:

(here {{code|20191206 }} is the date stamp of {{code|luametatex, of course }}; this will change during over time, of course). If not, there might be an issue with the files you have downloaded.

* If yesthere is no issue, in the folder {{code|'''~/context-osx-64/'''tex/}}, remove the folder « directory {{code|texmf-cache » and /}}, then in the Terminal run:

In After that, in principle, after that, the folder directory {{code|texmf-cache is /}} should be present again.

* If this is the case, in the Terminal window type:

If everything goes nicely, you should be able to see LuaMetaTeX functionningLMTX functioning.

== Installing on MacOS 10.15 Catlina Running LMTX from TeXShop ==

* First get your hands on a zip file of a complete tree of context-osx-64which works on MacOS 10.14 or previousAlternatively, from someone you knowcould use a TeX editor such as [https://pages.uoregon.edu/koch/texshop/obtaining. You can always contact the ConTeXt mailing list and ask this from someone (one day there might be a direct distribution of this zip file)html TeXShop]. If you have yourself access Once TeXShop is installed, go to a MacOS less than or equal to 10.14, you can follow the instructions above{{code|~/Library/TeXShop/Engine/}}, create a context-osx-64 treenew file named {{code|ConTeXt LMTX.engine}}, and then copy that tree on a USB memory stick and transfer open it to in your MacOS 10.15. In thi scase you should wipe preferred text editor, and add the following lines: #!/bin/bash export PATH=$PATH:'''~/context-osx-64/'''tex/texmf-cacheosx-64/binfolder in your copy destined to MacOS 10.15. * Disable the SIP (System Integrity Protection) following (for example) the instructions given here https: '''~/context-osx-64/www.macworld.co.uk'''tex/howtexmf-toosx-64/macbin/howmtxrun -turn-offautogenerate -mac-osscript context -x-directives="system-integrity-protection-rootless-3638975/Later, you can put back the SIP, once the installation of LuaMetaTeX is over. * In a Terminal window, reinstate the « Anywhere » option in Gatekeeper (which is visible in the Apple menu -> Préferences -> Security & Privacy) by doing sudo spctl --master-disableLater, you can put back the Gatekeeper default by saying sudo spctl --master-enableonce the installation of LuaMetaTeX is over. * Restart your Mac and put the folder « contextshowerror" -osx-64 « wherever you wish: for instance in your home directory. Thus the path to your future LuaMetaTeX directory will be (and below this is what we assume) ~/contextautopdf "$1" -osx-64/purgeall

* In a Terminal window export the PATH export PATH=~/context-osx-64/tex/texmf-osx-64/bin''Reminder:~/if you have installed {{code|context-osx-64/bin:}} elsewhere, please replace the segment {{code|'''~/context-osx-64/tex/texmf-osx-64/bin:$PATHYou can add this '''}} in the above code with the path to your .zshrc or .bashrc if you wish to use LuaMetaTeX from everywhere on your Macthat directory.)''

* You can test your installation by saying in Save & close the Terminal window which luametatexand see whether it points to something in your context-osx-64 treefile.

* In the Terminal window run mtxrun --generateand next context --make --all * Now If you want to use LMTX as your default TeX typesetter in principle you are done and you can typeset a test file named » mytest.tex » by saying context mytest.tex * At this pointTeXShop, you can enable again SIP and Gatekeeper as indicated above. * In order to update go to TeXShop -> Preferences, then under the latest version of LuaMetaTeX tab Typesetting, in a Terminal dothe Default Command section, choose the radio button "Command listed below", then type {{code|ConTeXt LMTX}} below that. cd ~/context-osx-64/-- sh install.sh{{Installation navbox}}[[Category:Installation]]The update should go ahead without any interference from Gatekeeper or SIP, even if you have trurned them to their default settings.[[Category:Standalone]]