ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Cite​Te​X

by Alexander K. ST3 OS XLinux

A sublime text plugin to add citation and reference assistance.

Labels LaTeX, tex, cite

Details

Installs

  • Total 4
  • Win 0
  • OS X 4
  • Linux 0
Apr 25 Apr 24 Apr 23 Apr 22 Apr 21 Apr 20 Apr 19 Apr 18 Apr 17 Apr 16 Apr 15 Apr 14 Apr 13 Apr 12 Apr 11 Apr 10 Apr 9 Apr 8 Apr 7 Apr 6 Apr 5 Apr 4 Apr 3 Apr 2 Apr 1 Mar 31 Mar 30 Mar 29 Mar 28 Mar 27 Mar 26 Mar 25 Mar 24 Mar 23 Mar 22 Mar 21 Mar 20 Mar 19 Mar 18 Mar 17 Mar 16 Mar 15 Mar 14 Mar 13 Mar 12
Windows 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
OS X 0 0 1 0 0 0 0 0 0 0 0 0 0 0 1 0 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Linux 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

CiteTeX

A Sublime Text 3 plugin for cite and ref completions

This plugin is not aimed at replacing LaTeXTools, its goal is rather to add some features regarding citation and reference completions.

Disclaimer

I am not responsible for any damage caused by this plugin, directly or indirectly. That includes in particular corruption or loss of you BibTeX files. Make sure you have a backup!

How To Use

Reference completion

Sophisticated reference completion is triggered by typing ref<TAB> in a .tex file. All defined symbols in other .tex files in the same folder will be listed.

Resource management

In order to access resources (e.g. PDFs) directly via popups, declare resource_root in your project settings:

"settings": {
        "TEXroot": "main.tex",
        "output_directory": "./build",
        "resource_root": "your resource directory here"
    }

To link a PDF to your BibTeX entry, add the BibTeX entry to your .bib file. With your .bib file currently open, run the Citetex: Add resource to bibentry command e.g. via the quick command menu (Ctrl+Shift+P). You are given a preview list of existent keys and their titles, select the one you want the resource to be added to. In the subsequent menu, you may select your PDF file. Note that it has to be in the folder you specified in your resource_root folder.

The reason why I built it this way is that you may have a Git project for your TeX work, but do not necessarily want to include your PDF material in it. Using this method, you have a per-project folder for your material separated from your work.

Features

Concerning citations

  • Preview of citation reference when hovered over \cite{...}
  • Display of title and year after a citation as a phantom
  • Go to BibTeX entry of reference
  • Preview of rendered entry according to given cite style
  • Error check of .bib files and inline display of warnings
  • Support of multiple .bib files (more testing required, though)
  • Add new .bib entry from DOI Link
  • Open URL or DOI in browser
  • If resource is stored locally, PDF can be opened directly
  • For resources, a 'base' directory must be specified

Concerning references

  • Preview of referenced label when hovering over \ref{...}
  • Go to label definition (from hovered reference or by quick menu)
  • Sophisticated reference insertion (see below)
  • locale- and scope-dependent insertion of referenced type

TODO

  • Raise warning in case of multiply defined labels or cite keys
  • Add support for other types of material (e.g. images)
  • Mac OS, Windows support

Sophisticated reference insertion

While LaTeXTools provides a fairly helpful completion menu when inserting references, reference insertion of CiteTeX not only lists defined labels, it also lists its labeled title or caption and its origin to make inter-document referencing less painful. When inserting a reference, it recognizes its type (e.g. section, chapter, figure) and adds its corresponding prefix (i.e. Sec., Ch., Fig.) according to the specified language.

Installation

So far, this plugin has only been tested on the following operating systems:

  • Arch Linux

Testers on Mac and Windows are welcome! (I will not put too much effort in getting it to work under Windows, though.)

Dependencies

This plugin relies on LaTeX and BibTeX for rendering and handling tex files. Specifically, latex and dvipng should be available in your PATH. Other than that, no special python packages or executables are required.

Temporary files

CiteTeX uses a subfolder of the sublime text cache folder.

Known issues

It may take while to index all entries and provide renderings for the popups when Sublime Text is started.

Questions?

Send me an e-mail: afk (at) daichronos (dot) net