# LaTeXing - Professional Typesetting

An extension for Sublime Text which makes your life
easier and more comfortable while creating your documents.

# Version 1.0

by Chris

With this release LaTeXing makes a huge step in the direction of making it more robust and easier compaible with the different system configurations. Here a list of some new features:

## TikZ Preview Mode

Working with TikZ files is sometimes very helpful but can also slow down your build process significant. LaTeXing offers two huge advantages, the first one is you can toggle a "Preview Mode" which will build a PDF right after you made some changes. The second one is that a PDF file of the current figure can be created next to your source file and you can just include it like a ordinary figure afterwords which will save you a lot of typset time afterwards.

Check this tutorial for more details how to use it.

## Check System

This version is using a new system check which makes it more easy and comfortable for you to see what and where LaTeXing can find and use. After running the system check the following view will open and gives you details informations about the individual executables and the used path.

## Executables

You can just adjust the path of the used executable, for example you can set a command without a path but also an absolute path of required. If you having a list with more than one entry, the first successful match will be used.

"executables": {
// Required
"perl": ["perl"],
"latexmk": ["latexmk"],
"pdflatex": ["pdflatex"],
"xelatex": ["xelatex"],
"lualatex": ["lualatex"],
"sublime": ["subl", "sublime_text", "sublime_text.exe"],
// Optional
"kpsewhich": ["kpsewhich"],
"mthelp": ["mthelp"],
"texcount": ["texcount"],
"texdoc": ["texdoc"],
"rscript": ["Rscript"]
}

## Further Features

There are more than 10 new features and further improvments and fixes. Please check the complete change log below for a list of new features, bug fixes, and further improvements.

## Version 1.0 (2013-11-04)

#### New

New "LaTeXing: Fold Section" and "LaTeXing: Fold Environment" command to fold the current section/environment.

#### New

Added "LaTeXing: Changelog" command

#### New (#44)

Fold environments non intendion based, define the supported types in the settings.

#### New (#44)

Fold sections non intendion based, e.g. running this command in a subsection will fold everything until the next subsection include subsubsections.

#### New

New "LaTeXing: Rename Current Environment" command, which allows you to rename the current envioment.

#### New

New "LaTeXing: Toggle Star Environment" command, which allows you to star, unstar the current envioment.

#### New

New check system dialog which should make it more easily to see if LaTeXing can detect the required tools.

#### New

New texcount view for listing the word count per file.

#### New

Provide command to create an environment with the current selected word as environment name

#### New

Provide command to create a command with the current selected word as command name

#### New

TikZ support with live preview, for enhanced syntax highlighting TikZ is required.

#### Improved

Autocomplete of LaTeX command in Knitr mode.

#### Improved

Better use of a custom output directory, using random temporary dictionary is now possible. Please check for the available options.

#### Improved

Change pdf viewer settings structure. The oder is now managed by the settings pdf_viewer_order.

#### Improved

Enhanced citekey format options for all supported reference systems. Check the settings for the available options.

#### Improved

Full Knitr Support in Beamer Class

#### Improved

Make the partial mode more flexiable now. The document will be parsed until begin document or if available until the tag % (PARTIAL).

#### Improved

Use setting "executables" to define all required commands to avoid problems with the path.

#### Fixed

Auto convert url date from Mendeley from YYYY/MM/DD or DD/MM/YY into YYYY-MM-DD.

#### Fixed

Import urldate field from Mendeley.com now.

# Glossaries Support

by Chris

The glossaries package can be used to create glossaries. It supports multiple glossaries, acronyms, and symbols. The setup is sometimes a bit difficult but here we are working throught it how to use it with LaTeXing without loosing any comfort.

Let's consider an example before we talk about the setup in detail.

\documentclass{article}
\usepackage[acronym]{glossaries}

\makeglossaries

\newglossaryentry{sample}{
name={sample},
description={a sample entry}
}

\newacronym[
\glsshortpluralkey=cas,
\glslongpluralkey=contrived acronyms]{aca}{aca}{a contrived acronym}

\begin{document}

A \gls{sample} entry and \gls{aca}. Second use: \gls{aca}.

Plurals: \glspl{sample}. Reset acronym\glsreset{aca}.
First use: \glspl{aca}. Second use: \glspl{aca}.

\printglossaries

\end{document}

.... read the full tutotial on latexing.com/docs.html.

# Knitr Support

by Chris

## What is Knitr?

knitr is a syntax and an R package that allow you to put R code right in your LaTeX files. This is great for writing scientific articles or reports that use data, because you never loose track of how exactly you arrived at your results. LaTeXing makes it dead simple to use knitr in Sublime Text 3. In this post I would like to introduce you to my knitr setup.

Let’s consider an example before we talk about the setup in detail.

\documentclass{article}

\begin{document}

R can be used as a calculator.

<<calc>>=
5 + 5
@

Knitr integrates R plots into your document.

<<plot_something, fig.width=3.5, fig.height=3.5>>=
plot(1:100, rnorm(100), ylab = "A random value")
@

Knitr integrates R tables into your document.

<<some_table, results='asis'>>=
library(xtable)
xtable(data.frame(a = 1:3, b = 11:13, c = 21:23))
@

\end{document}

.... read the full tutotial written by Severin on latexing.com/docs.html.

# Version 0.9

by Chris

With Version 0.8 the support for the online reference systems was introduces, in this version the support was improved and many bugs fixed with especially the Zotero support. Here a list of some new features:

## Partial Build Option

Working on a huge project means sometimes waiting for the compiler to finish or you can just uncomment some subfiles with the lost of automatically fill references across you whole project. With the partial build you are not losing anything, you can just add the partial build option and build your file as usual. LaTeXing will just include the current subfile in your pdf.

## Further Features

• Biblatex support
• Adjust the path in the normal settings
• Format pattern for citation key while working with Zotero and Mendeley
• Cite panel format keys: {sauthor}, {stitle} a short version of the authors and title
• Proxy support for online functionality
• Expert Settings, makes it east to adjust LaTeX.sublime-build etc...
• Knitr Support

## Improvements

• Zotero is now working on Linux and general Improvements
• Keep focus is now working in Okular and Evince
• General performance of synchronisation
• Performance of bib file parser
• Message dialog before updating local citations

## Installation Note

Because Package Control now supports different source codes for the same package, LaTeXing for Sublime Text is now also available simple as LaTeXing. Normally Package Control should take care on this situation but this isn't working right at the moment. If you have difficulties, just remove your old LaTeXing3 installation and reinstall the new version.

## Version 0.9 (2013-08-15)

#### New

Add new cite panel format keys: {sauthor}, {stitle} a short version of the authors and title.

#### New

Proxy support for online functionality like Mendeley, Zotero. The settings are reading from Package Control, so please check here for more details.

#### New (#83)

Support of Knitr, please check here for more details about how to use it.

#### Improved (#82)

Avoid \$ (dollar sign) matching in Vintage command mode

#### Improved

Improved performance of bib file parser for huge files with more than 1000 lines.

#### Improved (#60)

Make multi-document support compatible to LaTeXTools, to make the switch more smoothly.

#### Improved

Show message dialog before updating local citations for remote sources.

#### Improved (#87)

Use return key to leave environments like the math envionment, further adjustable via the keymap settings.

#### Fixed

Keep focus is now working for Okular and Evince on Linux

#### Fixed (#87)

Open correct sublime-keymap from menu "Preferences > Package Settings > LaTeXing > Keybindings - User"; it was opening "Default (OSX).sublime-keymap"

#### Fixed

Zotero is now working on Linux and general Improvements of the field map.

# Version 0.8

by Chris

After a few weeks the next version of LaTeXing is available via Package Control as well as the ordinary way. Here a list of all new features:

• Cache system (see for more infos) with automatically rebuild
• Mendeley, Zotero, Citeulike, (improved Bibsonomy) support via sever API, with caching the informations, offline mode, and synchronisation
• Global bibliography file support
• Jump back from Labels to the corresponding used position in your document
• Rename labels thoughout the project
• Automatic label creation can now be customised
• Online lookup remembers the last used search

With this version a few big changes have been applied, we tried to iron all problems out but especially with the server API and your personal configuration it could lead to problem. Just be sure that you followed the available tutorials on http://www.latexing.com/docs.html and if you cannot solve it please let us know.

## Version 0.8 (2013-07-22)

#### New (#47)

Option to adjust the behaviour of the automatically label creation.

#### New (#56)

Function to rename a label throughout the while project by running the fill command within a label.

#### New

Global bibliography file support to use an exported file from Mendely Desktop for example.

#### New (#57)

Go from a label to the postions where you are refering it.

#### New

Implement a inteligent cache system with automatically rebuild, check here for more infos.

#### New (#46)

Lookup symbol option, check http://detexify.kirelabs.org/classify.html if you are looking for a special symbol.

#### New

Mendeley, Zotero, Citeulike, (improved Bibsonomy) support via sever API, with caching the informations, offline mode, and synchronisation.

#### Improved (#64)

Build log will disappear automatically if no informations available.

#### Improved (#73)

Online lookup remembers the most recently used option.

#### Fixed (#66)

In math mode < will not expand to <>.