Difference between revisions of "Installing ConTeXt LMTX on MacOS"

From Wiki
Jump to navigation Jump to search
(Created page with "Since April 2019, there is a new flavor of ConTeXt, named « LuaMetaTeX » meant to integrate Lua, Metapost and TeX, the latter meaning ConTeXt. It is going to be self-contai...")
 
m (remove unnecessary 10.15 stuff)
 
(19 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Since April 2019, there is a new flavor of ConTeXt, named « LuaMetaTeX » meant to integrate Lua, Metapost and TeX, the latter meaning ConTeXt.
+
Since a few users have encountered difficulties in installing, and updating to, beta releases of [[Installation|ConTeXt LMTX]] on macOS, below we describe an installation procedure for macOS. For other platforms the procedures are more or less analogous.
It is going to be self-contained and smaller than previous versions of ConTeXt mkiv and mkii.  
 
  
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 ==
  
Since a few users have encountered difficulties in installing, and updating to, beta releases of LuaMetaTeX on MacOS, below we describe an installtion procedure for MacOS. For other platforms the procedures are more or less analogous.
+
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 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).
  
 
+
Open a Terminal window ({{code|Terminal.app}} is found in {{code|/Applications/Utilities/}}). In the Terminal window type
== Installing on MacOS ==
+
  cd '''~/context-osx-64/'''
 
+
Then you should be able to execute the command
* First download http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip
 
 
 
* Put the unzipped folder « context-osx-64 « whereever 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 (Terminal.app is found in /Applications/Utilities). In the Terminal window type
 
  cd ~/context-osx-64/
 
 
 
* Then you should be able to execute the command
 
 
  sh install.sh
 
  sh install.sh
  
* It may happen that MacOS will not allow you to execute the above shell command, in particular this happens beginning with MacOS 10.15 Catalina, where GateKeeper tries to protect you against yourself… In that case, you should open the System Préferences (from the Apple menu) 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, if everything goes smoothly, a complete functioning tree of LMTX, complete with dozens of manuals, will be installed in {{code|'''~/context-osx-64/'''}}. Whenever you want to update your installation of LMTX, it is enough to go to that directory in Terminal & run the installation script again:
 
 
* After that, if everything goes smoothly a complete functionning tree of LuaMetaTeX, complete with dozens of manuals, will be installed in 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
 
  sh install.sh
  
* If you want to use LuaMetaTeX from the Terminal interface you should add the path of your installation to $PATH by adding this to your
+
== Running LMTX from the Terminal ==
.bashrc
 
(or any other flavor of shell interface you are using) by adding to that file 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 to use TeXShop [https://pages.uoregon.edu/koch/texshop/obtaining.html]. Once TeXShop is installed, go to
+
If you want to 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 another configuration file, depending on your flavor of shell interface):
~/Library/TeXShop/Engine
+
  export PATH=$PATH:'''~/context-osx-64/'''tex/texmf-osx-64/bin
and there duplicate for instance the file « ConTeXt (LuaTeX).engine » (or any other of the files « .engine »). Name the duplicate
 
LuaMetaTeX.engine
 
and open it in TeXShop (or any text editor). Replace the content of the file « LuaMetaTeX.engine » with the following lines:
 
#!/bin/bash
 
  export PATH=~/context-osx-64/tex/texmf-osx-64/bin:~/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" --purgeall
 
then save and close the file.
 
  
* 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
+
''Reminder: if you have installed {{code|context-osx-64/}} elsewhere, please replace the segment {{code|'''~/context-osx-64/'''}} in the above code with the path to that directory.''
LuaMetaTeX
 
  
* In principle, once the above PATH has been added, typing in a Terminal window
+
In principle, once your PATH has been modified, typing in a Terminal window
 
  which context
 
  which context
 
or  
 
or  
 
  context --version
 
  context --version
you should get the path to context binary and its version. If this is the case, then you can typeset a file named « myfile.tex » from the Terminal by typing:
+
you should get the path to 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
 
  context myfile.tex
  
* It may happen that for some reasons not everything goes smoothly and you cannot typeset any document. In that case, try typing in a Terminal window:
+
----
 +
 
 +
It may happen that for some reason not everything goes smoothly & you cannot typeset any document. In that case, try typing in a Terminal window:
 
  which luametatex
 
  which luametatex
in order to see whether
+
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.
~/context-osx-64/tex/texmf-osx-64/bin/luametatex
 
is present or not.
 
  
* If not, the download has not been complete.
+
If {{code|luametatex}} is present, in the Terminal type:
 
 
* If luametatex is present, in the Terminal type:
 
 
  luametatex --version
 
  luametatex --version
 
and see whether it says, among other things:
 
and see whether it says, among other things:
 
  Functionality : level 20191206
 
  Functionality : level 20191206
(here 20191206 is the date stamp of luametatex, of course this will change during time). If not, there might be an issue with the files you have downloaded.
+
(here {{code|20191206}} is the date stamp of {{code|luametatex}}; this will change over time, of course). If not, there might be an issue with the files you have downloaded.
  
* If yes, in the folder
+
If there is no issue, in {{code|'''~/context-osx-64/'''tex/}}, remove the directory {{code|texmf-cache/}}, then in the Terminal run:
~/context-osx-64/tex
 
remove the folder « texmf-cache » and then in the Terminal run:
 
 
  mtxrun --generate
 
  mtxrun --generate
In principle, after that, the folder texmf-cache is present again.
+
After that, in principle, the directory {{code|texmf-cache/}} should be present again.
  
* If this is the case, in the Terminal window type:
+
If this is the case, in the Terminal window type:
 
  context --make --all
 
  context --make --all
If everything goes nicely, you should be able to see LuaMetaTeX functionning.
+
If everything goes nicely, you should be able to see LMTX functioning.
 +
 
 +
== Running LMTX from TeXShop ==
 +
 
 +
Alternatively, you could use a TeX editor such as [https://pages.uoregon.edu/koch/texshop/obtaining.html TeXShop]. Once TeXShop is installed, go to {{code|~/Library/TeXShop/Engine/}}, create a new file named {{code|ConTeXt LMTX.engine}}, open it in your preferred text editor, and add the following lines:
 +
#!/bin/bash
 +
export PATH=$PATH:'''~/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" --purgeall
 +
 
 +
''Reminder: if you have installed {{code|context-osx-64/}} elsewhere, please replace the segment {{code|'''~/context-osx-64/'''}} in the above code with the path to that directory.)''
 +
 
 +
Save & close the file.
 +
 
 +
If you want to use LMTX as your default TeX typesetter in TeXShop, go to TeXShop -> Preferences, then under the tab Typesetting, in the Default Command section, choose the radio button "Command listed below", then type {{code|ConTeXt LMTX}} below that.
 +
----
 +
{{Installation navbox}}
 +
[[Category:Installation]]
 +
[[Category:Standalone]]

Latest revision as of 09:51, 7 July 2020

Since a few users have encountered difficulties in installing, and updating to, beta releases of ConTeXt LMTX on macOS, below we describe an installation procedure for macOS. For other platforms the procedures are more or less analogous.

Installing LMTX on MacOS

First download 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 LMTX directory will be ~/context-osx-64/ (from now on, this is what we assume).

Open a Terminal window (Terminal.app is found in /Applications/Utilities/). In the Terminal window type

cd ~/context-osx-64/

Then you should be able to execute the command

sh install.sh

After that, if everything goes smoothly, a complete functioning tree of LMTX, complete with dozens of manuals, will be installed in ~/context-osx-64/. Whenever you want to update your installation of LMTX, it is enough to go to that directory in Terminal & run the installation script again:

sh install.sh

Running LMTX from the Terminal

If you want to run LMTX from the Terminal interface in any directory, you should add the path of your installation to $PATH by adding this to your .bashrc (10.14 and earlier) or .zshenv (10.15) (or another configuration file, depending on your flavor of shell interface):

export PATH=$PATH:~/context-osx-64/tex/texmf-osx-64/bin

Reminder: if you have installed context-osx-64/ elsewhere, please replace the segment ~/context-osx-64/ in the above code with the path to that directory.

In principle, once your PATH has been modified, typing in a Terminal window

which context

or

context --version

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

context myfile.tex

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

which luametatex

in order to see whether ~/context-osx-64/tex/texmf-osx-64/bin/luametatex is present or not. If not, the download is incomplete.

If luametatex is present, in the Terminal type:

luametatex --version

and see whether it says, among other things:

Functionality : level 20191206

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

If there is no issue, in ~/context-osx-64/tex/, remove the directory texmf-cache/, then in the Terminal run:

mtxrun --generate

After that, in principle, the directory texmf-cache/ 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 LMTX functioning.

Running LMTX from TeXShop

Alternatively, you could use a TeX editor such as TeXShop. Once TeXShop is installed, go to ~/Library/TeXShop/Engine/, create a new file named ConTeXt LMTX.engine, open it in your preferred text editor, and add the following lines:

#!/bin/bash
export PATH=$PATH:~/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" --purgeall

Reminder: if you have installed context-osx-64/ elsewhere, please replace the segment ~/context-osx-64/ in the above code with the path to that directory.)

Save & close the file.

If you want to use LMTX as your default TeX typesetter in TeXShop, go to TeXShop -> Preferences, then under the tab Typesetting, in the Default Command section, choose the radio button "Command listed below", then type ConTeXt LMTX below that.