Atom-LaTeX is an extension for Atom.io, aiming to provide all-in-one features and utilities for LaTeX typesetting with Atom.
TeXShop (TeXShop), if you want something lightweight and functional. This was one of the first decent TeX editors for the Mac, and was one of the driving forces behind the 'resurgence of TeX usage on the Mac platform'[1]. I've used both TeXShop and TeXworks, and they're very similar in. LaTeX editor for Mac OS X, iOS, iPad, iPhone and iPod Touch, with syntax highlighting, multi-file support and integrated PDF. Atom-LaTeX uses a.latexcfg file with a JSON object under the root directory of the LaTeX project to partially control its behaviour. Following is a complete example of its content. Following is a complete example of its content.
Note
The original package author James-Yu
switched back to Visual Studio Code since late March 2017. If you prefer VS Code as well, check out the sibling of this package LaTeX-Workshop.
Features
Some features have screenshots/screencasts available here. Have a check!
- Compile LaTeX with BibTeX
- Preview PDF with build-in viewer
- Parse LaTeX compiling log
- Autocomplete
- Syntax highlighting
- Direct and reverse SyncTeX
If you figured out some neat features, that you'd like included, create an issue!
Why another LaTeX package?
Unification provides a seamless experience. Aiming to make it work and work perfectly.
Requirements
Latex Editor Review
- LaTeX distribution in system PATH. For example, TeX Live.
- Please note MikTeX does not ship with SyncTeX. See this link for a possible solution.
- Set LaTeX root file.
Installation
Installing Atom-LaTeX is simple. You can find it in the atom.io package registry, or simply run apm install atom-latex
from the command line.
For cutting edge features or changes, you can clone this repository to the Atom package folder:
- Windows
%USERPROFILE%.atompackages
- Mac/Linux
$HOME/.atom/packages
Usage
All commands can be invoked from Package
→Atom-LaTeX
menu or from the command palette. Alternatively, keybindings are provided. Each command is invoked if the two key combinations are pressed sequentially.
For reverse SyncTeX from PDF to LaTeX, use ctrl+Mouse Left Click in the PDF viewer to reveal the line in editor.
Mac OS users can use command key as a replacement of ctrl.
Command | Default Keybind | Function |
---|---|---|
atom-latex:build | ctrl+L ctrl+B | Build LaTeX file. |
atom-latex:build-here | ctrl+L ctrl+H | Build LaTeX using active text editor file if possible. |
atom-latex:clean | ctrl+L ctrl+C | Clean LaTeX auxillary files. |
atom-latex:preview | ctrl+L ctrl+P | Preview generated PDF file with in-browser viewer. |
atom-latex:kill | ctrl+L ctrl+K | Terminate current LaTeX building process. |
atom-latex:synctex | ctrl+L ctrl+S | Direct SyncTeX from the current cursor position. |
atom-latex:toggle-panel | ctrl+L ctrl+L | Toggle Atom-LaTeX panel display. |
Setting the LaTeX root file
A LaTeX root file is essential for Atom-LaTeX. Building, preview, autocompletion, and more features rely on its proper configuration. Atom-LaTeX provides multiple methods of setting this up.
Open the root file, then use the
Build Here
command. Alternatively, useBuild LaTeX from active editor
menu item.Manually select the file by clicking the
home
icon on the control panelAdd a magic comment
% !TEX root = pathtorootfile.tex
to all of your LaTeX source file. The path can be absolute or relative.Create a project specific
.latexcfg
file at the root directory of your project. The file should contain a JSON object withroot
key set to the root file. For example:If all previous checks fail to find a root file, Atom-LaTeX will iterate through all LaTeX files in the root directory and set the first file with the sequence
begin{document}
as the root file.
You can choose one or multiple methods stated above to set the root file.
Setting up a toolchain
By default latexmk
is used to automate the LaTeX building sequence. This tool is bundled in most LaTeX distributions, and requires perl
to execute.
If latexmk
fails, the custom toolchain
is utilised which by default sequentially runs the typical pdflatex
>bibtex
>pdflatex
>pdflatex
command chain:
Multiple commands should be separated by &&
. Placeholders %TEX
,%ARG
and %BIB
will be replaced by tools defined in the settings menu%DOC
will be replaced by the root LaTeX filename (without extension), while %EXT
gives the file extension
For non perl
users, other automatic LaTeX helper utilities such as texify
or arara
can also be configured.
- Sample
custom toolchain
configuration fortexify
Do note that texify
requires the complete root file name with extension to compile.
- Sample
custom toolchain
configuration forarara
Have a look at this comment for more details on setting up arara
Enable spell check
Best Free Latex Editor
- Open the settings panel of Atom core package
spell-check
. - Add
text.tex.latex
to theGrammars
section.
Project-based Configuration
Atom currently does not provide per-project configuration. Atom-LaTeX uses a .latexcfg
file with a JSON object under the root directory of the LaTeX project to partially control its behaviour. Following is a complete example of its content.
Latex For Mac
If a key is set, the configuration will overwrite the global one in atom settings.
Set per-project LaTeX toolchain
If LaTeX projects need special toolchains, one can add a toolchain
key to the .latexcfg
file. For example:
This example will only use the defined compiler in atom configuration to build the project.Alternatively, you can also directly specify compilers such as:
Latex Editor For Mac Trace Pdf To Latex File
Support for non .tex
files
Atom-LaTeX has limited support to LaTeX source files with a non .tex
extension. To consider such files as valid LaTeX documents, one can add a latex_ext
key to the .latexcfg
local configuration file. An example:
Note that the value must be a JSON array, even when there is only one alternative file extension.
Sample toolchain for knitr
Have a look at this thread for more options for custom toolchains.
Latex Editor For Mac Trace Pdf To Latex Files
Contributing
- Create issues for bugs
- Fork and PR for fixes
- Thank you so much!