CiteBibtex
Effortlessly insert citations from BibTeX into texts written in Pandoc or LaTeX
Details
Installs
- Total 7K
- Win 3K
- Mac 3K
- Linux 1K
Feb 18 | Feb 17 | Feb 16 | Feb 15 | Feb 14 | Feb 13 | Feb 12 | Feb 11 | Feb 10 | Feb 9 | Feb 8 | Feb 7 | Feb 6 | Feb 5 | Feb 4 | Feb 3 | Feb 2 | Feb 1 | Jan 31 | Jan 30 | Jan 29 | Jan 28 | Jan 27 | Jan 26 | Jan 25 | Jan 24 | Jan 23 | Jan 22 | Jan 21 | Jan 20 | Jan 19 | Jan 18 | Jan 17 | Jan 16 | Jan 15 | Jan 14 | Jan 13 | Jan 12 | Jan 11 | Jan 10 | Jan 9 | Jan 8 | Jan 7 | Jan 6 | Jan 5 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 1 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 2 | 0 | 0 | 0 | 1 | 1 | 0 | 0 | 0 | 0 |
Mac | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 1 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 |
Linux | 2 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 |
Readme
- Source
- raw.githubusercontent.com
CiteBibtex
A Sublime Text plugin to effortlessly insert citations from BibTeX into texts written in Pandoc or LaTeX.
Installation
Install via Package Control.
Compatible with Sublime Text 3 only.
Initial configuration
Set the path to your global BibTeX file (bibtex_file
) in the plugin settings.
Use
Pressing the citation shortcut key (bound to F10
by default) brings up a quick panel for searching the bibliography file. Once the desired reference is found, pressing enter or clicking on it will insert a citation at the current cursor position (if there is more than one cursor, at the first cursor's position). The BibTeX file is checked for modifications each time the quick panel is brought up.
The format for inserted citations is auto-detected as pandoc
(for use with Pandoc) or latex
based on the syntax of the open file (this can be disabled by setting "autodetect_citation_style": false
in the plugin settings). If auto-detection fails, the default is to use pandoc
(which can be changed by setting default_citation_style
in the plugin settings).
The bibtex_file
setting can be overridden on a per-project basis in the project settings, using either a path relative to the project settings file or an absolute path. The following example project settings demonstrate this:
{
"folders":
[
{
"follow_symlinks": true,
"path": ".",
}
],
"bibtex_file": "path/to/bibtex.bib"
}
Inserting plaintext bibliography entries
There is a separate command (bound to F9
by default) to insert a pre-formatted plaintext bibliography entry rather than a citation key. This is configured via the new citation_format_string
setting in the plugin settings, which is a Python format string, set to "{author} ({year}). {title}"
by default. Any BibTeX field can be used in the format string, missing ones will be replaced with an empty string.
Extraction of citations from master BibTeX file
The command CiteBibTeX: Extract citations in current file
is available via the command palette, and will extract all references used in the currently open file from the global BibTeX file, saving that subset in a local BibTeX file.
For example, if my_paper.md
is currently open and cites 10 out of 100 references in the global BibTeX file, calling this command will save those 10 references in a file called my_paper.bib
in the same directory as my_paper.md
. This may useful to keep references portable alongside the text that uses them for sharing or archiving.
Acknowledgments
Includes the BibTeX parsing library python-bibtexparser (LGPLv3-licensed).
Includes md2bib.py
from pandoc-wrappers by Joseph Reagle (GPLv3-licensed).
License
GNU GPLv3 (see LICENSE
file).