LaTeX Smart Quotes

The purpose of this Sublime Text Package is to make the quotes in LaTeX "smart", i.e. insert the quotes you intend to use. It is inspired by the typopunct-mode for Emacs.

To establish this goal it uses:

• language detection (supported languages: English, German, French)
• context detection according to the caret position

Installation

By Package Control

1. Download & Install Sublime Text 3 (https://www.sublimetext.com/3)
2. Go to the menu Tools -> Install Package Control, then, wait few seconds until the installation finishes up
3. Now, Go to the menu Preferences -> Package Control
4. Type Add Channel on the opened quick panel and press Enter
5. Then, input the following address and press Enter

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

6. Go to the menu Tools -> Command Palette... (Ctrl+Shift+P)
7. Type Preferences: Package Control Settings – User on the opened quick panel and press Enter
8. Then, find the following setting on your Package Control.sublime-settings file:

   "channels":
   [
       "https://packagecontrol.io/channel_v3.json",
       "https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json",
   ],

9. And, change it to the following, i.e., put the https://raw.githubusercontent... line as first:

   "channels":
   [
       "https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json",
       "https://packagecontrol.io/channel_v3.json",
   ],

   • The https://raw.githubusercontent... line must to be added before the https://packagecontrol.io... one, otherwise, you will not install this forked version of the package, but the original available on the Package Control default channel https://packagecontrol.io...
10. Now, go to the menu Preferences -> Package Control
11. Type Install Package on the opened quick panel and press Enter
12. Then, search for LaTeXSmartQuotes and press Enter

See also:

1. ITE - Integrated Toolset Environment
2. Package control docs for details.

Usage

Usually you do not have to do anything special and just use LaTeX as always. If you type " or ' this Package will try to extract the language of the document and insert the correct quotation marks.

The language detection is executed the first time you press " or ' and the result will be cached. If you want to rerun it open the command palette (ctrl+shift+p) and insert LaTeX SmartQuotes: Auto Detect Buffer Language, the result will be displayed in the status bar at the bottom. If the detected language is incorrect or you use a multilingual document, you can change the language by executing the command LaTeX SmartQuotes: Set Buffer Language in the command palette. This command will provide you a list with all available languages. If the language ends with -ucs it will use unicode characters.

Hints

• You can use ctrl+l " or ctrl+l ' (respectively super+l " or super+l ' on OSX) to insert the usual quotation marks instead of the LaTeX and language specific. If you want to disable the special quotes (e.g. in a lstlisting environment), you can set the buffer language to "None".

• If you use unicode characters you should have \usepackage[utf8]{inputenc} at the start of your document.

• The language detection checks for specific packages, hence it does not always work correctly. Nevertheless it should always work with the babel package.

• To disable the automatic language detection and define a language, which should always be used, you can define it in your user settings. For example you can add "latex_smart_quotes_current_language": "german-ucs" to always use german with unicode support. You might want to do this if you only use one language anyway.
  If you are a native english speaker you might want to add "latex_smart_quotes_current_language": "english" to your settings file.

Options

Options are set in the package settings file, which is as usual available in the menu Prefences>Package Settings>LaTeXSmartQuotes>Settings - User.

• latex_smart_quotes_default_language The default language, which is used if no language has been detected
• latex_smart_quotes_use_ucs enables unicode support, i.e. unicode quotations instead of ascii characters

Demonstration

This demonstrates the context detection, i.e. the choice of opening and closing quotes.

This demo shows some available quotes. The quote types are chosen automatically by the language detection of this package.

Issues

If something does not work as you expected or you want support of an additional language, then you can create a pull request or an issue on github. In the case you don't own a github account you can also write in email to r-stein.github@web.de.