3
edits
Changes
Jump to navigation
Jump to search
m
The easiest way to install For getting ConTeXt on [[MkIV]] onto a Mac OSX is there are basically two routes to use the the MacTeX distributiontake. MacTeX is a TeXlive (TeXLive distribution modified made especially for use on Mac OSX. It will install every thing you need to run ) and the ConTeXt, TeX, LaTeX, XeSuite (LaStandalone)TeX, along with recommended for all those that want the editors [http://www.uoregon.edu/~koch/texshop/ TeXShop] and TeXworks, the TeX Live Utility for managing updates, and many other goodiesmost current versions or latest developments in ConTeXt.
As MacTeX is a TeXlive distribution all binaries Naturally, there are other ways, but they are generally frozen more for a year. If you wish to have a more current version or the latest beta version of ConTeXt you should consider, also installing experienced Mac users and those comfortable with using the "ConTeXt Suite" often called "Standalone ConTeXt"command line.
=== Installing * 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.
* [http://www.tug.org/mactex/ Download and follow The easiest way to install ConTeXt on Mac OSX is to use the instructions from the MacTeX site] 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(Installer larger than 2GBLa)TeX, instructions for slower internet connections on along with the site of MacTeX)* You can also editors [http://tugwww.uoregon.orgedu/~koch/texlivetexshop/acquire.html buy a TeXlive DVDTeXShop] (if you are a member of a and TeXWorks, the TeX user group you often get it Live Utility for free)managing updates, fonts and many other goodies.
==Standalone 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.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=== Installing MacTeX ===
Use * [http://www.tug.org/mactex/ Download and follow the tutorial that is more Mac centric with as little use of instructions from the command line MacTeX site] (TerminalInstaller larger than 2GB, instructions for slower internet connections on the site of MacTeX) as possible.
* 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).
* Start TeXShopThe new [[LMTX]] distribution is also able to run [[MkIV]] files. If TeXShop was installed with MacTeX you can find it in the folder TeX in your Application folderSee [[Installation]] or [[Installing ConTeXt LMTX on MacOS]] for details.
* Make TeXshop use utf== Configuring ConTeXt-8 as its standard encoding for files Choose the TeXShop->Preferences Menue there look for Encoding Click Aware Editors on the Popup-Menubar and choose UTF-8 Close the Dialog window Mac ==
* Start Typically, most editors work out of the Terminal box with MacTeX, but if you will find it in are using a version earlier than those shipped with MacTeX 2011 (TeXShop 2.42), or if you would like to use the Utility-folder in the Applications-folderStandalone distribution (ConTeXt Suite), you need to configure engines for ConTeXt manually.
* [http://www.esm.psu.edu/mac-tex/ Mac OS X TeX/LaTeX Web Site] (Penn State University)
* [[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
* [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
→More Links: spam
< [[Installation]] | [[TeX Distributions]] >
== MacTeX Introduction ==
== MacTeX ==
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".
=== Single user installation === 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 Standalone 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.
* Open the standard MKIV engine for [[TeXShop enter open -a TeXShop $HOME/Library/TeXShop/Engines/ConTeXt\ \(LuaTeX\).engine This will open the file in TeXShop and switch to TeXShop * 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/texmfstartIn Arguments : ]] *texexec as the first argument[[Texpad]] *$fullname as the second argument[[BBEdit]] *$synctexoption as the third argument.[[TextMate]]
== 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.uoregon.edu/~koch/texshop/texshop.html TeXshop], a simple, elegant TeX editor and PDF viewer.
* There are more [[Text Editors]] that support ConText.
{{Installation navbox}}
[[Category:Installation]]
