How to install your distribution (manually, with i-Installer, Fink or MacPorts) What user interface to pick (TeXShop, LyX, or commandline) What typesetting variant to use (LaTeX, ConTeXt or others) If you use a Mac and don't want to decide yourself: install TeX Live. If you use MacPort, use MacPorts to install it, otherwise install it manually. Mac OS X (Fink). If you are installing on one of these distributions, follow their recommended way of installation, and you can safely ignore the next sections that give details for installing dblatex from the source tarball. Install Python if necessary. Install the XSLT. By default xsltproc is used. Install the XML DocBook.
Need to develop LaTex documents? TeXMaker for Mac combines a lot of features and tools in just one easy-to-use application. The app is well designed and offers many built-in shortcuts that you can. Here are the steps to install TeX Live first and then SW without the TeX Live install: It may be necessary to disable any antivirus software. If you are behind a firewall, this may cause problems and prevent using the over the network TeX Live installation (see the note below).
You will need to be running either SublimeText 2 or 3. For ST3, the plugin has been tested against the latest beta versions, though it may work for dev builds as well.
You will also need to install a TeX distribution, but this can be done separately. The various options for TeX distributions are discussed in the OS-specific sections below.
Installation
The recommended way to install the LaTeXTools plugin is via Package Control. It's awesome and makes it easy to keep your installed packages up-to-date. If you don't already have Package Control, instructions to install it can be found here (it's very easy!).
Once, you have Package Control installed, launch the Command Palette by pressing Ctrl+shift+p (Windows / Linux) or ⌘+shift+p (OS X) and select the Package Control: Install Package option. This will bring up a quick panel with a list of installable plugins. Start typing LaTeXTools and when you see it, select it. That's it!
If you prefer a more hands-on approach, you can always clone the git repository or else just grab the plugin's .zip file from GitHub and extract it to your Sublime Packages directory (you can open it easily from ST, by clicking on Preferences | Browse Packages). Please note that if you do a manual installation, the package must be named 'LaTeXTools'.
If you are running LaTeXTools for the first time, you may want to run the LaTeXTools: Reset user settings to default command from the Command Palette to get an editable copy of the settings file. To open this file, please select Preferences | Package Settings | LaTeXTools | Settings – User. Please pay careful attention to the settings in the Platform-Specific Settings for your platform, as these may need to be adjusted for your environment. See the OS-specific instructions below for details on what needs to be adjusted.
OS X
Distribution
On OSX, you need to be running the MacTeX distribution (which is pretty much the only one available on the Mac anyway). Just download and install it in the usual way. We have tested MacTeX versions 2010--2016, both 32 and 64 bits; these work fine. MacTeX 2008 does not seem to work out of the box, so please upgrade.
If you don't want to install the entire MacTeX distribution—which is pretty big—BasicTeX will also work, though you may need to spend more time ensuring all the packages you need are installed! One such package that is missing is latexmk
, which is a script for building LaTeX documents, which LaTeXTools uses by default. You can either choose to install latexmk
or change the builder to use a builder that does not require latexmk
. To install latexmk
, you can either use the TeX Live Utility (assuming you are using a recent version of BasicTeX) or from the Terminal type sudo tlmgr install latexmk
, which will prompt you for your password and install the latexmk
package.
Setup Skim
We recommend that you install the Skim PDF viewer, as this provides forward and inverse search capabilities, which are very useful! Skim is the default viewer that LaTeXTools uses on OS X. If you don't install Skim, please see the information on available viewers for details on how to setup LaTeXTools to work with Preview.app
To configure inverse search, in Skim, open the Preferences dialog, select the Sync tab, then:
- Uncheck the 'Check for file changes' option
- Choose the Sublime Text preset (for ST3) or Sublime Text 2 (for ST2)
If you are using an old version of Skim without built-in support for ST, you can always choose the Custom preset and enter (for ST3): /Applications/Sublime Text.app/Contents/SharedSupport/bin/subl
in the Command field, and '%file':%line
in the Arguments field.
Setup ImageMagick and Ghostscript
If you are using Sublime Text 3 version 3118 or later and want to use the equation preview feature or use the image preview feature for PDFs, EPSs, or PSs, you will need to ensure that Ghostscript 8 or higher is installed and available on the texpath
defined for your machine. If you installed the full MacTeX distribution, Ghostscript is already included. If you installed the BasicTeX distribution, you will need to install Ghostscript yourself.
If you do not want to use the equation preview feature, change the preview_math_mode
setting to 'none'
when you are configuring your settings.
Similarly, if you would like to use the image preview feature to view file types not support by SublimeText or Ghostcript (so anything other than PNGs, JPEGs, GIFs, PDFs, EPSs, and PSs), you will need to ensure that ImageMagick is installed on your machine and available on your texpath
.
If you do not want to use the image preview feature, change the preview_image_mode
setting to 'none'
when you are configuring your settings.
The easiest way to install ImageMagick or Ghostscript is to use either Homebrew or MacPorts. Installing should be as simple as typing the relevant command in the Terminal:
Product | Package Manager | Command |
---|---|---|
ImageMagick | Homebrew | brew install imagemagick |
ImageMagick | Mac Ports | sudo port install ImageMagick |
Ghostscript | Homebrew | brew install ghostscript |
Ghostscript | Mac Ports | sudo port install ghostscript |
If you do not use Homebrew or MacPorts (and you should), you will need to compile and install binaries from source. The source for Ghostscript can be found on this page and the source and compilation instructions for ImageMagick can be found on this page.
You can use the LaTeXTools: Check System command to verify that these are installed and setup in a place LaTeXTools can find.
Configure LaTeXTools Settings
To edit the LaTeXTools user settings, select Preferences | Package Settings | LaTeXTools | Settings – User from the ST menu and scroll down to the section titled Platform settings and find the osx block.
Within that block, verify that the 'texpath'
setting is correct. This setting is use by LaTeXTools to determine the PATH
used for running TeX and friends which, because of how LaunchControl works will differ from your path on the shell. The default value should work with MacTeX installed in the normal way, but you will want to verify that this setting is correct. Note that your 'texpath'
must include $PATH
.
El Capitan
Prior to El Capitan, MacTeX defaulting to installing itself in the /usr
directory. However, beginning with El Capitan, applications can no longer write to /usr
. MacTeX 2015 and later remedies this by creating a link to TeX binaries in /Library/TeX
you can read more about this on the MacTeX site. The default LaTeXTools settings file now adds /Library/TeX/texbin
to the texpath
. In practice, this means the following:
- If you are running MacTeX 2015 and do not have the
texpath
option in your user settings file, you do not need to take further action. - If you are running MacTex 2015 and have the
texpath
setting open your user settings file (remember, you can do so from the Preferences | Package Settings | LaTeXTools submenu) and add/Library/TeX/texbin
as the first entry intexpath
. - If you are running earlier MacTeX versions, unfortunately you do not have the
/Library/TeX/texbin
link at all, so adding that path totexpath
would not help. You have two options: create the link yourself, or edit thetexpath
option to point to the appropriate directory. Check Section 8 of this document for details.
Sorry for the complications. It's not my fault.
Windows
Distribution
On Windows, both MiKTeX and TeXLive are supported. Pick one and install it following the relevant documentation.
Setup Sumatra
We recommend that you also install the Sumatra PDF viewer. Its very light-weight and supports both forward and inverse search. It is also the only viewer supported on Windows. Just download and install it in the normal way.
Once you've installed SumatraPDF, its a good idea to add it to your PATH
so that LaTeXTools can easily find it. To do this, find the folder you installed SumatraPDF to (usually C:Program FilesSumatraPDF
). Once you have this, open the command line (cmd.exe
) and run setx PATH %PATH%;C:Program FilesSumatraPDF
, changing the C:Program FilesSumatraPDF
depending on where you actually installed it.
You now need to set up inverse search in Sumatra PDF. However, the GUI for doing this is hidden in Sumatra until you open a PDF file that has actual synchronization information (that is, an associated .synctex.gz
file). See this forum post for details.
If you have a PDF file with a corresponding .synctex.gz
file, then open it in Sumatra and go to Settings | Options, and enter:
- (ST3)
'C:Program FilesSublime Text 3sublime_text.exe' '%f:%l'
- (ST2)
'C:Program FilesSublime Text 2sublime_text.exe' '%f:%l'
as the inverse-search command line (in the text-entry field at the bottom of the options dialog). You may need to modify these paths depending on where you installed ST.
If you do not already have such a file, you can easily create one by compiling any LaTeX file with pdflatex -synctex=1 <file.tex>
and opening the resulting PDF in SumatraPDF. Alternatively, you can open the console (cmd.exe
) and run the following command (assuming SumatraPDF.exe is on your PATH
):
sumatrapdf.exe -inverse-search 'C:Program FilesSublime Text 3sublime_text.exe' '%f:%l'
(Adapt as necessary for ST2 or depending on the path you installed ST to)
I'm sorry this is not straightforward---it's not my fault :-)
Setup ImageMagick and Ghostscript
If you are using Sublime Text 3 version 3118 or later and want to use the equation preview feature or use the image preview feature for PDFs, EPSs, or PSs, you will need to ensure that Ghostscript 8 or higher is installed and available on the texpath
defined for your machine.
If you do not want to use the equation preview feature, change the preview_math_mode
setting to 'none'
when you are configuring your settings.
To install and setup Ghostcript:
- If you are using MiKTeX, LaTeXTools should automatically find the MiKTeX Ghostscript install, provided MiKTeX is available on your
PATH
system variable or via the LaTeXToolstexpath
setting. - If you are using TeXLive and you installed the default profile, you should already have Ghostscript installed in
<drive>:pathtotexlive<year>tlpkgtlgsbin
. Make sure this is added to yourPATH
system variable or to thetexpath
when setting up LaTeXTools. - If you do not have Ghostscript installed, you can simple download and install the latest release here.
Similarly, if you would like to use the image preview feature to view file types not support by SublimeText or Ghostcript (so anything other than PNGs, JPEGs, GIFs, PDFs, EPSs, and PSs), you will need to ensure that ImageMagick is installed on your machine, which you should be able to do using one of the binary releases. Once ImageMagick is installed, ensure its location is either added to your PATH
system variable or the texpath
LaTeXTools setting.
If you do not want to use the image preview feature, change the preview_image_mode
setting to 'none'
when you are configuring your settings.
You can use the LaTeXTools: Check System command to verify that these are installed and setup in a place LaTeXTools can find.
Configure LaTeXTools Settings
To edit the LaTeXTools user settings, select Preferences | Package Settings | LaTeXTools | Settings – User from the ST menu and scroll down to the section titled Platform settings and find the windows block.
Within that block, verify that the 'texpath'
setting is correct. This setting is use by LaTeXTools to determine the PATH
used for running TeX and friends. Both MiKTeX and TeXLive by default add themselves to your PATH
, but if you told them not to, you will need to ensure that they are added to the path here.
If you did not follow the instructions above to add SumatraPDF to your path, you will need to change the sumatra
to point to you Sumatra install. Normally, it will end up being C:Program FilesSumatraPDFSumatraPDF.exe
.
Finally, you need to ensure that the distro
setting is correct. The possible values are 'miktex'
and 'texlive'
, depending on which distribution you installed.
Linux
Linux support is coming along nicely. However, as a general rule, you will need to do some customization before things work. This is due to differences across distributions (a.k.a. 'fragmentation'). Do not expect things to work out of the box.
Distribution
You need to install TeXLive.
We highly recommend installing the version directly from TUG, which can be found here rather than the version included with your distribution, as TeXLive is generally updated more regularly and tends to include more features. In particular, if you are on Ubuntu, note that apt-get install texlive
will get you a working but incomplete setup. For example, it will not install latexmk
, which is essential to LaTeXTools. You need to install it via apt-get install latexmk
. However, as long as the expected binaries are available on your system, LaTeXTools should generally work.
You can use the LaTeXTools: Check System command to ensure that the expected binaries are found.
Setup ImageMagick and Ghostscript
If you are using Sublime Text 3 version 3118 or later and want to use the equation preview feature or use the image preview feature for PDFs, EPSs, or PSs, you will need to ensure that Ghostscript 8 or higher is installed and available on the texpath
defined for your machine.
If you do not want to use the equation preview feature, change the preview_math_mode
setting to 'none'
when you are configuring your settings.
Similarly, if you would like to use the image preview feature to view file types not support by SublimeText or Ghostcript (so anything other than PNGs, JPEGs, GIFs, PDFs, EPSs, and PSs), you will need to ensure that ImageMagick is installed on your machine and available on your texpath
. Note that for some image formats, ImageMagick also requires Ghostscript to be installed.
If you do not want to use the image preview feature, change the preview_image_mode
setting to 'none'
when you are configuring your settings.
If you installed the full TeXLive profile from TUG, you should already have a version of Ghostscript installed. Otherwise, it can simply be installed using your distribution's package manager. ImageMagick should also be available the same way.
Once again, you can use the LaTeXTools: Check System command to verify that these are setup in a place LaTeXTools can find.
Setup Viewer
By default, LaTeXTools assumes you are using Evince (Document Viewer) as your PDF viewer. Support is also available for Okular and Zathura and other viewers that can be run via the command line. See the section on available-viewers for details on how to setup other viewers.
Evince is already installed by default on any distro that provides the Gnome desktop environment, but if it hasn't been, it can be installed using your distribution's package manager. In addition to Evince, you will need to ensure you have the Python bindings for dbus
and the Python bindings for Gnome, i.e. gobject
or python-gi
, depending on your distribution. If you use the Gnome desktop, you likely already have these, but if not, you will need to install them using your distribution's package manager. In particular, they are reportedly not installed on Arch Linux by default.
Unlike other viewers and platforms, Evince forward and backward search should work out of the box thanks to the magic of dbus
, but if not, please let us know!
Configure LaTeXTools Settings
To edit the LaTeXTools user settings, select Preferences | Package Settings | LaTeXTools | Settings – User from the ST menu and scroll down to the section titled Platform settings and find the linux block.
Within that block, verify that the 'texpath'
setting is correct. This setting is use by LaTeXTools to determine the PATH
used for running TeX and friends. Please note that if you use Unity (the default launcher on Ubuntu), ST can end up 'seeing' a different PATH
then you will in the terminal. This is because Unity inherits its environment from /bin/sh
rather than /bin/bash
, /bin/zsh
, /bin/fish
, etc. This means that you may need to add the path to TeX and friends to your 'texpath'
for LaTeXTools to work.
If your PATH
contains a Python distribution that is not the default Python distribution, it may be necessary to configure the 'python'
setting to point to the system Python distribution. There have been reports of issues using dbus
and gobject
on conda and similar Python releases.
- This article was written in January 2007. Given the volatile nature of this topic, expect that the content of this article is outdated after about two years time.
- 1Installation Choices
- 2Install ConTeXt and LaTeX using ports
- 3Pick an editor
Installation Choices
First of all, there is TeX. An archaic type-setting system.If you want to install TeX, you need to think about three things:
- What distribution to use (teTeX, XeTeX, TeX Live or others)
- How to install your distribution (manually, with i-Installer, Fink or MacPorts)
- What user interface to pick (TeXShop, LyX, or commandline)
- What typesetting variant to use (LaTeX, ConTeXt or others)
If you use a Mac and don't want to decide yourself: install TeX Live. If you use MacPort, use MacPorts to install it, otherwise install it manually. Download and install TeXShop manually.
Distributions
See for example TeX Distributions at contextgarden.net, Common LaTeX distributions at the Latex Project or .
- TeX Live
- A multiplatform distribution. It is now the recommended choice, as it contains platform specific latex binaries, such as XeTeX and MacTeX.
- XeTeX
- A newer distribution originating on the Mac. Has nice features like the ability to include any (TrueType or OpenType) font, and natively supports UTF-8. Recommended for Mac users.
- teTeX
- One of the most widely used distributions. Pretty good.
- MacTeX
- Recommended Mac distribution by the TeX Users Group.
- proTeXt
- Recommended Windows distribution by the TeX Users Group.
Installers
If you use a package manager like MacPorts or Fink, simply use that manager to install the required package. I heard some reports that those package did not get the fonts correct when exporting to PDF, but to be honest: it worked flawlessly for me.
If you don't use MacPorts of Fink, I recommend the i-Installer. It's a package manager for Mac OS X. While support ended at January 2007, it is still a good choice since the main purpose was to install TeX-related packages.
User Interface
To actually use TeX, you can either use the command line:
Or use an editor. One of the best editors is TeXShop, which has a window to edit your TeX files, and allows you to simply click a button to do the typesetting (calling pdflatex, texexec or any other tool applicable).
If you don't feel comfortable using TeX, you way want to start with LyX, a GUI-editor for LaTeX. While LyX allows you to import tex files, I wouldn't count on that to work reliable. That said, LyX is a great way start with LaTex: you can do most of the editing in LyX, and when an article is done, you can export to LaTeX and do some fine tuning of the lay-out. That way you slowly learn the different type-setting commands in LaTeX.
Type Setting Variant
No-one types directly in TeX anymore. Typically people will use LaTeX. But even then, there are many choices for packages. For example, do you use verbatim, moreverb or listings to produce code listings. And for small in-line pictures, do you use picins or wrapfig. I usually deal with it by Googling for the correct package, get overwhelmed, pick one and hope for the best. A good rule of thumb is to only use package that already came with the distribution. A good change that others can then read it too.
LaTeX is the de-facto standard, and great for writing articles. However, if you care about lay-out you may want to consider ConTeXt, which allows you to fine tune your lay-out. So if you simply want to write text with pictures, and want to share with colleagues: use LaTeX. If you want to make a nice looking brochure, use ConTeXt.
Install ConTeXt and LaTeX using ports
As described above, there are multiple ways to install software.This guide installs LaTeX on Mac OS X using ports.
Prerequisites
Requirements XCode and MacPorts. If you haven't installed these yet:
- Download XCode (aka Developer Tools; need free Apple Developer Account to download)
- Download and install MacPorts
- reconfigure shell to include /opt/local/bin
- sudo port selfupdate
Install TeX Live with Ports
Now that your done, install TeX Live:
This installs texlive_base, texlive_texmf-minimal, texlive_texmf-full, freetype, fontconfig, ncurses, zlib, libpng, texinfo, texi2html, ghostscript and XFree86.
Pick an editor
You can type your tex files in any text editor and run latex or pdflatex from the command line. However, it sometimes is benefical to use a dedicated editor. Some common choices are
- TextMate, an all-purpose text-editor with LaTeX bundle
- BBEdit, an all-purpose text-editor
- TeXShop, a dedicated LaTeX editor
- LyX, a graphical-only LaTeX editor, targeted at users who do not care about the intrinsics of tex code, but like a GUI editor.
Install TeXShop
Manually install TeXShop.
Open TeXShop, go the Preferences. There are few settings to make, depending on the installer and distribution.
Encoding
First of all, go to the 'Document' tab.
Set the Encoding to 'UTF-8 Unicode'.
You really want to do this. Even if you are going to stick to ASCII, do choose UTF-8, since UTF-8 is fully backward compatible with ASCII.
Installer Path
Secondly, go the to the 'Engine' tab, and set the paths based on the installer you used.
For Macports, set the path to the following values:
- (pdf)TeX
- /opt/local/bin
- Distiller (Ghostscript)
- /opt/local/bin
If you would have installed teTeX using the i-Installer, this should be:
- (pdf)TeX
- /usr/local/teTeX/bin/powerpc-apple-darwin-current
- Distiller (Ghostscript)
- /usr/local/bin
XeTeX Distribution
If you use teTeX, you don't have to change anything.
If you installed XeTeX, you should also change these settings in the 'Misc' tab:
Install Latex Package Mac
- TeX Program
- xetex
- Latex Program
- xelatex
See Using XeTeX with TeXShop for details.
Latex Installation For Mac
You can now use UTF-8 directly in your documents. If you want to use custom Mac-fonts as well, you may want to consider installing the fontspec package from CTAN.
Using ConTeXt with XeTeX
If you use ConTeXt with teTeX, everything is set. You can simply select 'ConTeXt' from the TypeSet menu, and you're off.
Also, if you use LaTeX with XeTeX, everything is set. Due to the settings in the Misc tab, you're automatically using XeTeX.
Mac Os Latex
However, if you want to combine ConTeXt with XeTeX, things are a bit more complicated. Since I wasn't interested in that feature, I refer to the ConTeXt wiki on XeTeX