LaTeXTools: A LaTeX Plugin for Sublime Text

Documentation: https://sublimetext.github.io/LaTeXTools

Headline features:

• Support for the import package
• TOC quickpanel now shows just the current document when using (C-r)
• Uses analysis for ref / cite commands and better caching
• Improved fill all completions for large files
• %!TEX directives now override settings in all circumstances

Prereleases

LaTeXTools uses pre-releases to beta test new features and improve the stability of releases. If you also want to get the newest features and help us testing them. Just open Preferences > Package Settings > Package Control > Settings - User and insert at a reasonable (correct JSON syntax) position:

    "install_prereleases": ["LaTeXTools"],

If you also use prereleases of other packages just add them comma separated into the list.

Overview

This plugin provides several features that simplify working with LaTeX files:

• The ST build command takes care of compiling your LaTeX source to PDF using texify (Windows/MikTeX) or latexmk (OSX/MacTeX, Windows/TeXlive, Linux/TeXlive). Then, it parses the log file and lists errors and warning. Finally, it launches the PDF viewer and, on supported viewers (Sumatra PDF on Windows, Skim on OSX, and Evince on Linux by default) jumps to the current cursor position.
• Forward and inverse search with the named PDF previewers is fully supported
• Fill everything including references, citations, packages, graphics, figures, etc.
• Plugs into the "Goto anything" facility to make jumping to any section or label in your LaTeX file(s)
• Smart command completion for a variety of text and math commands
• Additional snippets and commands are also provided
• Fully customizable build command
• Fully customizable PDF viewers
• Full support for project files and multi-file documents
• Easily view package documentation
• Word counts

Installation

By Package Control

1. Install Sublime Text 4 and Package Control. In Sublime Text, open Tools > Command Palette, run Install Package Control, and wait for it to finish.

2. Open Preferences > Package Control, run Add Channel, and enter:

   https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json
   

3. Open Preferences > Package Settings > Package Control > Settings - User. In the channels setting, move the StudioChannel URL before the default Package Control channel. Keep all other settings as they are. For example:

   {
       "channels": [
           "https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json",
           "https://packages.sublimetext.io/channel.json"
       ]
   }

   Keep any other channels already in your settings after StudioChannel, including the older https://packagecontrol.io/channel_v3.json default URL if that is what your installation uses.

   [!WARNING] Putting StudioChannel first changes package selection for every name it shares with another channel. Review the StudioChannel contents before changing the order.

4. Open Preferences > Package Control, run Install Package, search for LaTeXTools, and press Enter. Package Control installs the release published by StudioChannel, which can differ from the current repository checkout.

See also ITE - Integrated Toolset Environment and the Package Control usage guide.

Manually

If you prefer a more hands-on approach, you can clone the git repository or download its .zip file from GitHub and extract it to your Packages directory (open Preferences > Browse Packages in Sublime Text). Then restart Sublime Text. For a manual installation, the package directory must be named LaTeXTools.

TeX distribution and PDF viewer

You'll need a working TeX installation and a PDF viewer. LaTeXTools supports MacTeX, MiKTeX, and TeXLive as TeX systems, and Skim, Sumatra PDF, Evince, Okular, and Zathura as PDF viewers. For setup details, see our online documentation.

Bugs, issues & feature requests

Please read the installation instructions carefully to ensure you get up and running as quickly as possible. Help for troubleshooting common issues can be found in the Troubleshooting section at the end of this README. For other bugs, issues or to request new features, please get in touch with us via Github.

Please search for existing issues and pull requests before opening a new issue.

Acknowledgements

Currently maintained by DeathAxe,

created by Ian Bacher, Marciano Siniscalchi, and Richard Stein

Additional contributors (thank you thank you thank you): first of all, Wallace Wu and Juerg Rast, who contributed code for multifile support in ref and cite completions, "new-style" ref/cite completion, and project file support. Also, skuroda (Preferences menu), Sam Finn (initial multifile support for the build command); Daniel Fleischhacker (Linux build fixes), Mads Mobaek (universal newline support), Stefan Ollinger (initial Linux support), RoyalTS (aka Tobias Schidt?) (help with bibtex regexes and citation code, various fixes), Juan Falgueras (latexmk option to handle non-ASCII paths), Jeremy Jay (basic biblatex support), Ray Fang (texttt snippet), Ulrich Gabor (tex engine selection and cleaning aux files), Wes Campaigne and 'jlegewie' (ref/cite completion 2.0!). Huge thanks to Daniel Shannon (aka phyllisstein) who first ported LaTeXTools to ST3. Also thanks for Charley Peng, who has been assisting users and generating great pull requests; I'll merge them as soon as possible. Also William Ledoux (various Windows fixes, env support), Sean Zhu (find Skim.app in non-standard locations), Maximilian Berger (new center/table snippet), Lucas Nanni (recursively delete temp files), Sergey Slipchenko ($ auto-pairing with Vintage), btstream (original fill-all command; LaTeX-cwl support), Richard Stein (auto-hide build panel, jump to included tex files, LaTeX-cwl support config, TEX spellcheck support, functions to analyze LaTeX documents, cache functionality, multiple cursor editing), Dan Schrage (nobibliography command), PoByBolek (more biblatex command), Rafael Lerm (support for multiple lines in \bibliography commands), Jeff Spencer (override keep_focus and forward_sync via key-binding), Jonas Malaco Filho (improvements to the Evince scripts), Michael Bar-Sinai (bibtex snippets).

If you have contributed and I haven't acknowledged you, email me!

License

See the file ./LICENSE.