Difference between revisions of "Mac Installation"

From Wiki
Jump to navigation Jump to search
 
(81 intermediate revisions by 25 users not shown)
Line 1: Line 1:
−
< [[Installation hints]] | [[TeX Distributions]] >
+
< [[Installation]] | [[TeX Distributions]] >
  
−
Welcome to the Macintosh! Nowadays it's not a big difference how to use TeX on MacOS or any other Unix.
+
== Introduction ==
  
−
==Distributions and Tools==
+
For getting ConTeXt [[MkIV]] onto a Mac there are basically two routes to take. MacTeX (TeXLive distribution made especially for Mac OSX) and the ConTeXt Suite (Standalone), recommended for all those that want the most current versions or latest developments in ConTeXt.
  
−
The first stop for just about every ConTeXt user on the Mac should be [http://ii2.sourceforge.net/tex-index.html gwTeX] via [http://ii2.sourceforge.net iInstaller], which is an auto-updatable (re-)distribution. This installs everything necessary for a basic TeX foundation. The i-Installer also includes a ConTeXt updater package, for handling new releases.
+
Naturally, there are other ways, but they are more for experienced Mac users and those comfortable with using the command line.
  
−
Beyond this, there may be other tools that interest you:
+
* The simplest method is to use MacTeX, but as this is essentially TeXLive you will not have the most recent binaries (generally frozen for a year).
−
* [[XeTeX]], is an alternative TeX engine that uses special typography features of OS X (available via iInstaller).
+
* The advantage is that you get TeX et al, fonts and some nice utilities, including the editor TeXShop (highly recommended) which can run ConTeXt and TeX-Variants from within the editor without any knowledge of the command line.
−
* [http://www.uoregon.edu/~koch/texshop/texshop.html TeXshop], a simple, elegant TeX editor and PDF viewer.
+
* ConTeXt Suite (Standalone) is recommended for those that wish to have the latest stable version, latest developmental version, or wish to run several versions of ConTeXt side by side. The downside to the side by side approach is that you need some knowledge of how to use the command line and how to set-up the paths in a Unix environment.  
−
* [[iTeXMac]], a more fully featured, but sometimes more complex, TeX editor and PDF viewer
 
−
* [http://www.ing.unipi.it/~d9615/homepage/texniscope.html TeXniscope] is an interesting, auto-updating PDF- and DVI viewer, especially helpful when you're updating documents from the command line or otherwise outside of the above-mentioned integrated editor/viewers.
 
  
−
==Installation==
+
== MacTeX ==
  
−
* If you have a broad bandwith internet connection, use Gerben Wierda's iInstaller to install the latest TeXlive tree and (afterwards) the latest ConTeXt beta.
+
The easiest way to install ConTeXt on Mac OSX is to use the the MacTeX distribution. MacTeX is a TeXLive distribution modified especially for use on Mac OSX. It will install every thing you need to run ConTeXt, TeX, LaTeX, Xe(La)TeX, along with the editors [http://www.uoregon.edu/~koch/texshop/ TeXShop] and TeXWorks, the TeX Live Utility for managing updates, fonts and many other goodies.  
−
* You can also buy a TeXlive DVD.
 
  
−
==Configuration of texmfstart==
+
As MacTeX is a TeXLive distribution all binaries are generally frozen for a year. If you wish to have a more current version or the latest beta version of ConTeXt you should consider, also installing the "ConTeXt Suite" often called "Standalone ConTeXt".
−
Versions of ConTeXt later than April 2006, use a new Ruby script (set up by Hans Hagen and Taco Hoekwater) called texmfstart.rb which has to be configured properly. Actually it is still possible to use the "old" script based on Perl, but for instance when one says
 
−
        texexec example.tex
 
−
in order to typeset the file example.tex, you'll see in the log file a warning like
 
−
        warning: use 'texmfstart texexec' instead
 
−
Since ConTeXt is developing very fast, it is likely that one day or another the "old" script would become orphan. (Recall that according to some theoretician physicists the velocity of ConTeXt development is a counter-example to the fact that the velocity of light is an upper limit for all velocities...). Since I (i.e. Otared K.) and many other Mac users had difficulties to do this (that is make texmfstart work), thanks to help and insights from Mojca M. and Taco H. I explain below how I did configure texmfstart on my machine. To be more precise, I should say that  I have teTeX and ConTeXt installed (and updated quite often...) with Gerben Wierda's i-Installer. Actually in what follows nothing is specific to Mac OS X: it is very likely that on any Unix like system texmfstart can be configured in the same way.  
 
  
−
* In principle on your computer there is a directory (or folder...) named
+
After installing MacTeX all you need to do is set up TeXShop to use ConTeXt, see the [[TeXShop]] page.
−
        /usr/local/teTeX/bin/
 
−
if, as it is very likely, you have installed TeX in /usr/local. Otherwise with the command
 
−
          locate /teTeX/bin/
 
−
in a Terminal window find the directory teTeX/bin/. In this directory there should be a subdirectory named
 
−
powerpc-apple-darwin7.9.0
 
−
or something like that (depending on the type of the processor you have). Go there with the command cd (change directory): for instance in my case I would say:
 
−
        cd powerpc-apple-darwin7.9.0
 
−
or even if you know already the path to this directory you can say
 
−
        cd  /usr/local/teTeX/bin/powerpc-apple-darwin7.9.0/
 
  
−
* Find the path to the file "texmfstart.rb" (which has been installed during your TeX and ConTeXt installation): in the Terminal window type
+
=== Installing MacTeX ===
−
        locate texmfstart.rb
 
−
It may happen that several such files exist. For instance on my system I have two "texmfstart.rb",
 
  
−
      /usr/local/teTeX/share/texmf.local/scripts/context/ruby/texmfstart.rb
+
* [http://www.tug.org/mactex/ Download and follow the instructions from the MacTeX site] (Installer larger than 2GB, instructions for slower internet connections on the site of MacTeX)
−
      /usr/local/teTeX/share/texmf.tetex/scripts/context/ruby/texmfstart.rb
 
  
−
the second one is old, while the first one is recent and has been installed by Gerben's i-Installer. I assumed (remember we are using ConTeXt...) that the newer one is the right one...
+
* You can also [http://tug.org/TeXLive/acquire.html buy a TeXLive DVD] (if you are a member of a TeX user group you often get it for free).
  
−
* In the Terminal window (while you are in the directory powerpc-apple-darwin7.9.0) type:
+
==Standalone ConTeXt==
−
sudo emacs texmfstart
 
−
and after giving an su (super user) password, in the editor's window type the following code (given by Taco H.), that is the two following lines:
 
  
−
        #!/bin/sh
+
The new [[LMTX]] distribution is also able to run [[MkIV]] files. See [[Installation]] or [[Installing ConTeXt LMTX on MacOS]] for details.
−
        ruby /usr/local/teTeX/share/texmf.local/scripts/context/ruby/texmfstart.rb $@
 
  
−
This means that using the "shell sh" we create a new command executed with ruby (the last "$@" is a placeholder which is replaced by an argument when texmfstart is executed).
+
== Configuring ConTeXt-Aware Editors on the Mac ==
−
Indeed you can create a file named texmfstart with any text editor provided you manage to put (or copy) it in the above mentioned directory powerpc-apple-darwin7.9.0.
 
  
−
* Save and exit emacs by typing
+
Typically, most editors work out of the box with MacTeX, but if you are using a version earlier than those shipped with MacTeX 2011 (TeXShop 2.42), or if you would like to use the Standalone distribution (ConTeXt Suite), you need to configure engines for ConTeXt manually.
−
[CTRL]-X [CTRL]-S
 
−
and then
 
−
[CTRL]-X [CTRL]-C
 
  
−
* At this point we have created a script named texmfstart... Now we have to make it executable, so in the Terminal window (while you are in the
+
* [[TeXShop]]
−
directory powerpc-apple-darwin7.9.0) type
+
* [[TeXworks]]
 +
* [[Texpad]]
 +
* [[BBEdit]]
 +
* [[TextMate]]
  
−
sudo chmod +x texmfstart
+
== Skim (PDF viewer) ==
−
("chmod" stands for change mode, "+x" means add the executable bit to the file texmfstart).
 
  
−
* Now if in any (other) Terminal window you type, for instance
+
Unless you are using TeXshop or TeXworks with built-in viewers, the recommended PDF viewer with SyncTeX support and auto-refresh on Mac OS X is [http://skim-app.sourceforge.net/ Skim].
−
texmfstart
 
−
or
 
−
texmfstart --version
 
−
you should get the version of texmfstart and a series of example usage (more or less cryptic to the non specialist...).
 
  
−
* If you go to a directory where you have a file named for instance example.tex, then you can typeset it with ConTeXt by saying:
+
== More Links ==
−
texmfstart texexec example.tex
 
−
and now you shouldn't have the "warning: use 'texmfstart texexec' instead". Indeed you can make several variation on the above command by giving it more "switches" and optional arguments.
 
−
And you are done!
 
  
−
==MacOS 9 (Classic)==
+
* [http://www.tug.org/mactex/ MacTeX Home Page] (MacTeX at TUG)
−
 
+
* [http://www.uoregon.edu/~koch/texshop/texshop.html TeXshop], a simple, elegant TeX editor and PDF viewer.
−
Unfortunately it's ''not possible'' to use ConTeXt on MacOS Classic. You can get as far as creating the ConTeXt formats with one of the [http://www.esm.psu.edu/mac-tex/versions.html Classical Distributions], but ConTeXt's Perl scripts won't work with MacPerl (I tried hard...). Perhaps the problems could be solved, but who'll put a lot of effort in a deprecated system?
+
* There are more [[Text Editors]] that support ConText.
−
 
 
−
So everything else on this page refers to MacOS X.
 
−
 
 
−
==Links==
 
  
−
* [http://www.esm.psu.edu/mac-tex/ Mac-TeX] (Penn State University)
+
{{Installation navbox}}
  
 
[[Category:Installation]]
 
[[Category:Installation]]

Latest revision as of 13:31, 11 July 2021

< Installation | TeX Distributions >

Introduction

For getting ConTeXt MkIV onto a Mac there are basically two routes to take. MacTeX (TeXLive distribution made especially for Mac OSX) and the ConTeXt Suite (Standalone), recommended for all those that want the most current versions or latest developments in ConTeXt.

Naturally, there are other ways, but they are more for experienced Mac users and those comfortable with using the command line.

  • The simplest method is to use MacTeX, but as this is essentially TeXLive you will not have the most recent binaries (generally frozen for a year).
  • The advantage is that you get TeX et al, fonts and some nice utilities, including the editor TeXShop (highly recommended) which can run ConTeXt and TeX-Variants from within the editor without any knowledge of the command line.
  • ConTeXt Suite (Standalone) is recommended for those that wish to have the latest stable version, latest developmental version, or wish to run several versions of ConTeXt side by side. The downside to the side by side approach is that you need some knowledge of how to use the command line and how to set-up the paths in a Unix environment.

MacTeX

The easiest way to install ConTeXt on Mac OSX is to use the the MacTeX distribution. MacTeX is a TeXLive distribution modified especially for use on Mac OSX. It will install every thing you need to run ConTeXt, TeX, LaTeX, Xe(La)TeX, along with the editors TeXShop and TeXWorks, the TeX Live Utility for managing updates, fonts and many other goodies.

As MacTeX is a TeXLive distribution all binaries are generally frozen for a year. If you wish to have a more current version or the latest beta version of ConTeXt you should consider, also installing the "ConTeXt Suite" often called "Standalone ConTeXt".

After installing MacTeX all you need to do is set up TeXShop to use ConTeXt, see the TeXShop page.

Installing MacTeX

  • You can also buy a TeXLive DVD (if you are a member of a TeX user group you often get it for free).

Standalone ConTeXt

The new LMTX distribution is also able to run MkIV files. See Installation or Installing ConTeXt LMTX on MacOS for details.

Configuring ConTeXt-Aware Editors on the Mac

Typically, most editors work out of the box with MacTeX, but if you are using a version earlier than those shipped with MacTeX 2011 (TeXShop 2.42), or if you would like to use the Standalone distribution (ConTeXt Suite), you need to configure engines for ConTeXt manually.

Skim (PDF viewer)

Unless you are using TeXshop or TeXworks with built-in viewers, the recommended PDF viewer with SyncTeX support and auto-refresh on Mac OS X is Skim.

More Links

v · d · e
Installation
General
TeX distributions
Operating systems
Integrating editors with ConTeXt
Retrieved from "https://wiki.contextgarden.net/index.php?title=Mac_Installation&oldid=32627"