139
edits
Changes
Jump to navigation
Jump to search
Once you have started one of the programs, all you have to do is enter a command and press the RETURN-key and the command will be executed.
== TeXShop and TeXworks == Typically, both 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.
installed ConTeXt standalone. ''Do not forget to change username in the line above to your actual username!!''
correct command (whoami instead of who am i)
* The simplest method is to use MacTeX, but as 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 to this 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. Well, actually not that much if you use the an editor or IDE, like TeXShopand TeXWorks.
* ''For the best possible experience and ease of installation a combination of MacTeX and ConTeXt Suite is advised.''
=== Installing 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)
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 below that is more Mac OSX centric. We do use the command line program Terminal of Mac OSX as it poses the easiest way to get things done. But, do not worry as the process is straight foreword and you can just copy and paste the commands into the Terminal! === Using the Commandline === If you do not what a command tool is, do not worry. It is simple a program in which commands are entered as text and then executed. Mac OS comes with two tools for entering command lines the Terminal and a X11 environment X11 or Xquartz, depending on which Mac OSX version you are running. These programs can be found in the Utilities-folder of the Applications-Folder.
=== Single user installation ===
In the Terminal after each command you have to press the RETURN-key.
* Start the Terminal you will find it in the UtilityUtilities-folder in the Applications-folder.
* Create the folder/directory ''context'' in your ''HOME folder'':
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..
For easier your connivance you can copy all the command commands in this block , paste it into the Terminal and hit RETURN:
mkdir $HOME/context
cd $HOME/context
rsync -av rsync://contextgarden.net/minimals/setup/first-setup.sh .
sh ./first-setup.sh --modules=all --engine=luatex
=== Alterantive Alternative ConTeXt Versions ===
By default, the suite installs ConTeXt beta.
You can install different versions of ConTeXt next to each other. All you need to do is create a new directory for this version and follow the instructions above using the name of the directory instead of the name ''context''.
BEWARE: If you use the command line you have to set up the paths for your shell. If you use TeXShop you have to set-up engines for TeXShop for each version, this process in is describe below in the section ''Creating and Installing a TeXShop Engine''
=== Keeping ConTeXt Up-To-Date ===
If you are using a different version then use the use the appropriate options for first-setup.sh!!
=== System-wide installation ===
== Configuring ConTeXt-Aware Editors on the Mac ==
=== TeXShop ===
===== Creating an ''Engine'' for TeXShop =====
Actually, ''engine'' is somewhat misleading. In TeXShop an ''engine'' is a script that contains commands that are use to typeset your documents. TeXShop comes with many engines set up to run TeX, LaTeX, Xe(La)TeX and ConTeXt MKII and MKIV that have been installed via MacTeX.
* Start the Terminal you will find it in the Utility-folder in the Applications-folder
* find what Find your username is , if you do not know it already.<p>The command <code>whoami</code> will output your user name.</p> who am i the first word of the result is your username
* Open the standard MKIV engine for TeXShop enter
open -a TeXShop $HOME/Library/TeXShop/Engines/ConTeXt\ \(LuaTeX\).engine
* Save the engine with a new Name "ConTeXt Suite":
option click on the File menue menu
choose "Save As …"
change (LuaTeX) in the Name field to Suite
hit return
* change 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
* save Save the file again
use either the file menu or cmd-s
* In the other window navigate to the Applications-folder and to where TeXShop was installed.
If you installed via MacTeX you will find it in Applications->TeX->TexShop
* Open the folder containing the default engines for TeXShop
Do not forget that you have to also copy your own copy of the newly created engine to your own ''Engine''-folder!!
*$fullname as the second argument
*$synctexoption as the third argument.
=== Texpad ===
Texpad (https://www.texpadapp.com) is a commercial LaTeX editor, which supports typesetting in ConTeXt. It has a number of nice features, such as a project outline/manager that lists todos and cross-references; a built in previewer; and syncs with an OS X version of the software. Texpad supports ConTeXt out of the box. However, Texpad also allows users to write and install build scripts (.tpbuild, the equivalent of an "engine" in TexShop or TeXworks, as described above.). By means of these custom scripts, Texpad can also be configured to typeset using ConTeXt Standalone (ConTeXt suite).
As of Texpad 1.7.14 (July 2015), these are the steps which allow for typesetting using ConTeXt Standalone:
1. Create an empty text file.
2. Paste the following into it:
#!/bin/bash
# Texpad build (.tpbuild) for ConTeXt Standalone suite
export PATH=$HOME/context/tex/texmf-osx-64/bin:$PATH
mtxrun --script context --autogenerate --synctex=1 "$TEXPAD_ROOTFILE"
3. Save it as `ConTeXt_Suite.tpbuild`', and place this file in `~/Library/Application Support/Texpad/Buildscripts`
4. Relaunch Texpad. Open or create your ConTeXt document.
5. In the drop-down menu (which establishes the Typeset Chain) on the toolbar's far left, select "Typeset configuration > Manual"; click "Use a .tpbuild script", and select "ConTeXt_Suite".
Note that the second step assumes that you have installed your ConTeXt standalone in your $HOME directory. If, instead, you've installed it in your Applications directory or elsewhere, simply replace $HOME with the relevant path.
=== BBEdit ===
There is a [https://github.com/pmazaitis/ConTeXtBBLM BBEdit Language Module] for ConTeXt that supports:
* Syntax highlighting
* Code folding
* Navigation by headings and callouts
* Integrated navigation to included files
* Command completion
To install, download the [https://github.com/pmazaitis/ConTeXtBBLM/releases current release], unzip, and drag the language module onto the BBEdit icon.
== Skim (PDF viewer) ==
* [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) (broken link)
* [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] (broken link)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] (outdated)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]
