Atom-LaTeX is an extension for Atom.io, aiming to provide all-in-one features and utilities for LaTeX typesetting with Atom.
The original package author @James-Yu
switched back to Visual Studio Code for most coding and typesetting tasks due to reasons 1, 2, 3, and more since late Mar. 2017.
Atom-LaTeX is currently actively maintained by @ashthespy
. Please join me in thanking him for the great contribution!
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!
Unification provides a seamless experience. Aiming to make it work and work perfectly.
- LaTeX distribution in system PATH. For example, TeX Live.
- Set LaTeX root file.
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%\.atom\packages
- Mac/Linux
$HOME/.atom/packages
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. |
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 panel -
Add a magic comment
% !TEX root = \path\to\root\file.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:{ "root" : "\path\to\root\file.tex" }
-
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.
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:
%TEX %ARG %DOC && %BIB %DOC && %TEX %ARG %DOC && %TEX %ARG %DOC
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
texify --synctex --pdf --tex-option=\"-interaction=nonstopmode\" --tex-option=\"-file-line-error\" %DOC.%EXT
Do note that texify
requires the complete root file name with extension to compile.
- Sample
custom toolchain
configuration forarara
arara %DOC -v
Have a look at this comment for more details on setting up arara
- Open the settings panel of Atom core package
spell-check
. - Add
text.tex.latex
to theGrammars
section.
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.
{
"root" : "\path\to\root\file.tex",
"toolchain" : "%TEX %ARG %DOC",
"latex_ext": [".tikz", ".Rnw"]
}
If a key is set, the configuration will overwrite the global one in atom settings.
If LaTeX projects need special toolchains, one can add a toolchain
key to the .latexcfg
file. For example:
{ "toolchain" : "%TEX %ARG %DOC" }
This example will only use the defined compiler in atom configuration to build the project. Alternatively, you can also directly specify compilers such as:
{ "toolchain" : "pdflatex -synctex=1 -interaction=nonstopmode -file-line-error -pdf %DOC" }
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:
{ "latex_ext": [".tikz", ".Rnw"] }
Note that the value must be a JSON array, even when there is only one alternative file extension.
Sample toolchain for knitr
{"toolchain": "Rscript -e \"library(knitr); knit('%DOC.%EXT')\" && latexmk -synctex=1 -interaction=nonstopmode -file-line-error -pdf %DOC"}
Have a look at this thread for more options for custom toolchains.
- Create issues for bugs
- Fork and PR for fixes
- Thank you so much!