Changes

Jump to navigation Jump to search
Restructured & improved readability (by SublimeText.Mediawiker)
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 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.
See http://www.pragma-ade.com/install.htm [http://www.pragma-ade.com/install.htm] where you can find the installer script for the machine you are using== Installing LMTX on macOS up to 10.14 ==
Since a few users have encountered difficulties in installingAs of December 2019, and updating the following instructions work for macOS up to, beta releases of LuaMetaTeX on MacOS, below we describe an installtion procedure version 10.14 but do not work for MacOSmacOS 10. For other platforms 15 Catalina, due to the procedures are more or less analogousApple's System Integrity Protection (SIP).
First download the LMTX zip from the "64 bit Mac OSX" link at http://www.pragma-ade.com/install.htm. Put the unzipped folder {{code|context-osx-64/}} wherever you wish—for instance, in your home directory. Thus the path to your future LMTX directory will be {{code|'''~/context-osx-64/'''}} (from now on, this is what we assume).
== Installing on MacOS up 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 sh install.sh It may happen that macOS will not allow you to execute the above shell command, or the {{code|mtxrun}} script which is called by {{code|install.sh}}. In that case, you should open System Preferences (from the Apple menu) and choose Security & Privacy, then go to the General pane. There you should be able to authorize the shell script, which has been blocked, to be executed. When you issue the command again, macOS will ask you whether you really want to 10execute it.14 ==
* After that, if everything goes smoothly, a complete functioning tree of LMTX, complete with dozens of manuals, will be installed in {{code|'''Beware:~/context-osx-64/''' As }}. Whenever you want to update your installation of December 2019LMTX, the following instructions work for MacOS up it is enough to version 10.14 but do not work for MacOS 10.15 Catalina, due go to that directory in Terminal & run the Apple's System Integrity Protection (SIP). Please see the dedicated section for installing on MacOS 10installation script again: sh install.15 Catalinash
* First download http://lmtx== Installing LMTX on macOS 10.pragma-ade.nl/install-lmtx/context-osx-64.zip 15 Catalina ==
* Put the unzipped folder « First obtain a complete tree of {{code|context-osx-64 « wherever /}} that works on macOS 10.14 or previous, from someone you wish: for instance in your home directoryknow. Thus You can always contact the path to your future LuaMetaTeX directory will ConTeXt mailing list & ask for this from someone (one day there might be (and below a direct distribution of this is what we assumezip file) ~/. If you yourself have access to macOS 10.14 or previous, you can follow [[#Installing LMTX on macOS up to 10.14|the instructions above]] & create a {{code|context-osx-64/}} tree, then copy that tree on a USB memory stick & transfer it to your macOS 10.15. In this case, you should wipe the {{code|tex/texmf-cache/}} folder in the copy intended for macOS 10.15.
* Open a Terminal window Disable the SIP (TerminalSystem Integrity Protection), following the instructions given [https://www.app is found in macworld.co.uk/Applicationshow-to/Utilities). In the Terminal window type cd ~mac/contexthow-osxturn-64off-mac-os-x-system-integrity-protection-rootless-3638975/here], for example. Later, you can restore the SIP, once the installation of LMTX is over.
* Then In a Terminal window, reinstate the Anywhere option in Gatekeeper (visible in Apple menu -> Preferences -> Security & Privacy) by typing: sudo spctl --master-disableLater, you should be able to execute can put back the commandGatekeeper default by saying sh installsudo spctl --master-enableonce the installation of LMTX is over. Restart your Mac and put the folder {{code|context-osx-64/}} wherever you wish—for instance, in your home directory. Thus the path to your future LuaMetaTeX directory will be {{code|'''~/context-osx-64/'''}}.sh
* It may happen that MacOS will not allow you to execute the above shell command, or the mtxrun script which is called by install.sh. In that caseAt this point, you should open the System Préferences (from the Apple menu) may enable SIP and there choose Security & Privacy, and go to the General pane. There you should be able to authorize the shell script, which has been blocked, to be executed. After that you issue Gatekeeper again the command sh install.shand MacOS will ask you again whether you really want to execute mtxrun: you say YES!
* After that, if everything goes smoothly a complete functionning tree In order to update to the latest version of LuaMetaTeX, complete with dozens of manuals, will be installed in the foldera Terminal run: cd '''~/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
The update should go ahead without any interference from Gatekeeper or SIP, even if you have reverted them to their default settings.
* If you want to use LuaMetaTeX == Running LMTX from the Terminal interface you should add the path of your installation to $PATH by adding to your .bashrc(or any other flavor of shell interface you are using) the line export PATH=~/context-osx-64/tex/texmf-osx-64/bin:~/context-osx-64/bin:~/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 If you want to use TeXShop [https://pages.uoregon.edu/koch/texshop/obtaining.html]. Once TeXShop is installedrun LMTX from the Terminal interface in any directory, go you should add the path of your installation to ~/Library/TeXShop/Engineand there duplicate for instance the file « ConTeXt (LuaTeX)$PATH by adding this to your {{code|.engine » bashrc}} (or any other another configuration file, depending on your flavor of the files « .engine »). Name the duplicate LuaMetaTeX.engineand open it in TeXShop (or any text editorshell interface). Replace the content of the file « LuaMetaTeX.engine » with the following lines: #!/bin/bash export PATH=~/context-osx-64/tex/texmf-osx-64/bin$PATH:'''~/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 the file.
* If ''Reminder: if you want to use LuaMetaTeX as your default TeX typesetter in TeXShop, go to TeXShop have installed {{code|context-osx-> Preferences64/}} elsewhere, then under please replace the tab « Typesetting » and segment {{code|'''~/context-osx-64/'''}} in the « Default Command » section choose above code with the radio button « Command listed below « and below path to that type LuaMetaTeXdirectory.''
* In principle, once the above your PATH has been addedmodified, typing in a Terminal window
which context
or
context --version
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:
context myfile.tex
* ---- 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:
which luametatex
in order to see whether {{code|'''~/context-osx-64/'''tex/texmf-osx-64/bin/luametatex}} is present or not. If not, the download is incomplete.
* If not, the download has not been complete. * If {{code|luametatex }} is present, in the Terminal type:
luametatex --version
and see whether it says, among other things:
Functionality : level 20191206
(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:
mtxrun --generate
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:
context --make --all
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 {{code|~/Library/TeXShop/Engine/}}, create a MacOS less than or equal to 10new file named {{code|ConTeXt LMTX.14engine}}, you can follow open it in your preferred text editor, and add the instructions above, create a following lines: #!/bin/bash export PATH=$PATH:'''~/context-osx-64 tree, and then copy that tree on a USB memory stick and transfer it to your MacOS 10.15. In thi scase you should wipe the /'''bin:'''~/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.showerror" -integrity-protectionautopdf "$1" -rootless-3638975/Later, you can put back the SIP, once the installation of LuaMetaTeX is over.purgeall
* In a Terminal window, reinstate the « Anywhere » option in Gatekeeper (which is visible in the Apple menu -> Préferences ''Reminder: if you have installed {{code|context-> Security & Privacy) by doing sudo spctl osx--master-disableLater64/}} elsewhere, you can put back please replace the Gatekeeper default by saying sudo spctl segment {{code|'''~/context-osx-master-enableonce 64/'''}} in the above code with the installation of LuaMetaTeX is overpath to that directory.)''
* Restart your Mac and put Save & close the folder « context-osx-64 « wherever you wish: for instance in your home directoryfile. Thus the path to your future LuaMetaTeX directory will be (and below this is what we assume) ~/context-osx-64/
* In a Terminal window export the PATH export PATH=~/context-osx-64/tex/texmf-osx-64/bin:~/context-osx-64/bin:~/context-osx-64/tex/texmf-osx-64/bin:$PATHYou can add this path to your .zshrc or .bashrc if If you wish want to use LuaMetaTeX from everywhere on LMTX as your Mac. * You can test your installation by saying default TeX typesetter in the Terminal window which luametatexand see whether it points TeXShop, go to something in your contextTeXShop -osx-64 tree. * In > Preferences, then under the Terminal window run mtxrun --generateand next context --make --all * Now tab Typesetting, in principle you are done and you can typeset a test file named » mytest.tex » by saying context mytest.tex * At this pointthe Default Command section, you can enable again SIP and Gatekeeper as indicated above. * In order to update to choose the latest version of LuaMetaTeX in a Terminal do cd ~/context-osx-64/ sh install.shThe update should go ahead without any interference from Gatekeeper or SIPradio button "Command listed below", even if you have trurned them to their default settingsthen type {{code|ConTeXt LMTX}} below that.
35

edits

Navigation menu