Difference between revisions of "Mac Installation"

Latest revision as of 13:31, 11 July 2021

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

Download and follow the instructions from the MacTeX site (Installer larger than 2GB, instructions for slower internet connections on the site of 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.

Difference between revisions of "Mac Installation"

Latest revision as of 13:31, 11 July 2021

Contents

Introduction

MacTeX

Installing MacTeX

Standalone ConTeXt

Configuring ConTeXt-Aware Editors on the Mac

Skim (PDF viewer)

More Links

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

Main

Navigation

Indexes

Interaction

Tools

@@ Line 1: / Line 1: @@
 < [[Installation]] | [[TeX Distributions]] >
-== MacTeX ==
+== Introduction ==
-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, and many other goodies.
+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.
-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".
+Naturally, there are other ways, but they are more for experienced Mac users and those comfortable with using the command line.
-=== Installing MacTeX ===
+* 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 ==
-* [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)
+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 [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).
+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".
-==Standalone ConTeXt==
+After installing MacTeX all you need to do is set up TeXShop to use ConTeXt, see the [[TeXShop]] page.
-The "ConTeXt Suite" distribution is the recommended way to use ConTeXt on any OS.
+=== Installing MacTeX ===
-If you wish to use "ConTeXt Suite" from the command line you can use the Mac tutorial in the Mac section under [[ConTeXt Standalone|ConTeXt Suite]] or
-Use the tutorial that is more Mac centric with as little use of the command line (Terminal) as possible.
+* [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)
+* 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).
-=== Single user installation ===
+==Standalone ConTeXt==
-As "ConTeXt Suite" is self contained it is best and should be installed inside of a folder of its own. so decide where you want it to be installed. We recommend that you put it a folder called context inside your HOME folder:
-* right click on the following link:  [http://minimals.contextgarden.net/setup/first-setup.sh first-setup.sh]
-* a dialog will come up several choices: choose "Download Linked File As…"
-* you are now presented with a standard save dialog. If you can not see the New Folder-button in the bottom left of the dialog hit the triangle next "first-setup.sh"
-* click on the folder selector just under the file name and select your HOME folder ( has a small house next to it)
-* click on the New Folder-button and enter context in the dialog that comes up and hit return. if you use a different folder remember it location you will need it later on.
-* click the Save-button or just hit return.
-Now start the Terminal you will find it in the Utility-folder in the Applications-folder.
-Switch to the folder created above:
- cd $HOME/context
-Run first-setup.sh it to download the whole distribution and make formats:
-  sh ./first-setup.sh
-This takes a long time, so go have a coffee.
-When the installation process is finished you will see a message telling you that you have to initialize ConTeXt each time you want to run ConTeXt or to add the path to your PATH-variable of your shell. You can ignore this message if you are going to use TeXShop. Setting-up TeXShop is described below..
-=== Alterantive ConTeXt Versions ===
-By default, the suite installs ConTeXt beta. If you want the stable version of ConTeXt, you can use
- sh ./first-setup.sh --context=current
-By default, the suite does ''not'' install modules and other third party content. If you want the modules (and have the bandwidth), you can use
- sh ./first-setup.sh --modules=all
-Installing mkiv only reduces the size of the installation (including all the modules) from about 270 to 200MB . Use
- sh ./first-setup.sh --modules=all --engine=luatex
-=== Keeping ConTeXt Up-To-Date ===
-ConTeXt is constantly being improved and expanded if you want to have the latest version of ConTeXt you will need to regularly update your installation this has to be done from within the Terminal.
-Start the Terminal and switch to the folder where ConTeXt was installed:
- cd $HOME/context
-Download the installation script:
- rsync -ptv rsync://contextgarden.net/minimals/setup/first-setup.sh .
-Install the latest version:
- sh ./first-setup.sh --modules=all --engine=luatex
-If you are using a different version then use the use the appropriate options for first-setup.sh!!
-=== System-wide installation ===
-A system wide installation is only recommended for experienced users. You will need administrator rights on the Mac as only administrators are allowed to install programs in the Applications folder.
-Start the Terminal you will find it in the Utility-folder in the Applications-folder.
-Switch to the Application folder:
- cd /Applications
-Create the folder for ConTeXt
- mkdir context
-Switch to the "ConTeXt" folder
- cd context
-Download the installation script
- rsync -av rsync://contextgarden.net/minimals/setup/first-setup.sh .
-Then run that script to download the whole distribution and make formats:
- sudo sh ./first-setup.sh
-You be prompted for you password. Enter your login password and hit return.
-This takes a long time, so go have a coffee.
-When the installation process is finished you will see a message telling you that you have to initialize ConTeXt each time you want to run ConTeXt or to add the path to your PATH-variable of your shell. You can ignore this message if you are going to use TeXShop. Setting-up TeXShop is described below..
-By default only the beta version is installed, If you want a more stable version or third party content then look at the section ''Alterantive ConTeXt Versions'' above. All you need to do is add the option to the installation command in this section.
-== TeXshop and TeXworks ==
-Typically, both editors work out of the box with MacTeX, but if you are using version earlier than those shipped with MacTeX 2011 (TeXShop 2.42) you need to configure engines for ConTeXt manually.
-=== TeXshop ===
-If you install "ConTeXt Suite" or want to use "TeXlive" in parallel with "ConTeXt Suite"s you have to create new engines for "TeXShop", so that you can run your versions of "ConTeXt" directly from within "TeXShop".
-==== Setting TeXShop for Single User Installation ====
-The engines for TeXShop are installed in your Library folder of your HOME folder. They are installed first when you start TexShop for the first time.
-* Start TeXShop. If TeXShop was installed with MacTeX you can find it in the folder TeX in your Application folder.
+The new [[LMTX]] distribution is also able to run [[MkIV]] files. See [[Installation]] or [[Installing ConTeXt LMTX on MacOS]] for details.
-* Make TeXshop use utf-8 as its standard encoding for files
+== Configuring ConTeXt-Aware Editors on the Mac ==
- Choose the TeXShop->Preferences Menue there look for Encoding
- Click on the Popup-Menubar and choose UTF-8
- Close the Dialog window
-* Start the Terminal you will find it in the Utility-folder in the Applications-folder
+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.
-* Open the standard MKIV engine for TeXShop enter
+* [[TeXShop]]
- open -a TeXShop $HOME/Library/TeXShop/Engines/ConTeXt\ \(LuaTeX\).engine
+* [[TeXworks]]
+* [[Texpad]]
-This will open the file in TeXShop and switch to TeXShop
+* [[BBEdit]]
+* [[TextMate]]
-* Save the engine with a new Name "ConTeXt (Standalone)":
-  option click on the File menue
-  choose "Save As …"
-  change (LuaTeX) in the Name field to (Standalone)
-  hit return
-* change the set path line to:
- set path= (/Users/username/context/tex/texmf-osx-64/bin  $path /usr/local/bin)
- If you installed in a different location then change /Users/username/context/ to the location where you
- installed ConTeXt standalone.
-* save the file again
- use either the file menu or cmd-s
-* close the window
- use either the file menu or cmd-w
-You can know use your new engine by choosing it from the Pop-up Menu.
-If you want other options or use MKII then create a new engine and change the line containing mtxrun.
-In the manual for TeXShop you can find instructions for making your engine the the default engine or how to have TeXShop use your engine no matter which engine is set on a file by file basis.
-=== TeXworks ===
-If you install ConTeXt in your Applications Folder, you have to create a new engine.
-Go to your preferences inside TeXworks.
-In Typesetting Menu, in Processing tools, add a new engine.
-In Name, type what you want.
-In Program : /Applications/ConText/tex/texmf-osx-64/bin/texmfstart
-In Arguments :
- *texexec as the first argument
- *$fullname as the second argument
- *$synctexoption as the third argument.
 == 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 [http://skim-app.sourceforge.net/ Skim].
 == More Links ==
 * [http://www.tug.org/mactex/ MacTeX Home Page] (MacTeX at TUG)
-* [http://www.esm.psu.edu/mac-tex/ Mac OS X TeX/LaTeX Web Site] (Penn State University)
 * [http://www.uoregon.edu/~koch/texshop/texshop.html TeXshop], a simple, elegant TeX editor and PDF viewer.
-* [[iTeXMac]],(outdated) 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 on <span class="plainlinks">[http://howtouninstallonmacos.com/ <span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;">how to uninstall on mac</span>]
-* [http://mackeeper.zeobit.com/uninstaller-for-mac Mac Uninstall] Software
 * There are more [[Text Editors]] that support ConText.
-* [http://pdfview.sourceforge.net/ PDFView] is a lightweight Mac OS X application to display PDF files with auto-update and [http://itexmac.sourceforge.net/pdfsync.html PDFSync] function.
-* How-to articles about Mac OS, for example [http://www.mac-how.net/  how to uninstall applications on mac]. Opportunity to submit questions.
-* [http://www.mac-uninstall.com/ Mac Uninstaller]
-* [http://www.use4video.com/DVDRipper.html DVD Ripping Software] for Your Mac
 {{Installation navbox}}
 [[Category:Installation]]