Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xuhdev/vim-latex-live-preview
A Vim Plugin for Lively Previewing LaTeX PDF Output
https://github.com/xuhdev/vim-latex-live-preview
Last synced: 12 days ago
JSON representation
A Vim Plugin for Lively Previewing LaTeX PDF Output
- Host: GitHub
- URL: https://github.com/xuhdev/vim-latex-live-preview
- Owner: xuhdev
- License: gpl-3.0
- Created: 2012-05-16T06:12:36.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2023-09-25T07:35:39.000Z (over 1 year ago)
- Last Synced: 2024-11-14T13:41:49.611Z (2 months ago)
- Language: Vim Script
- Homepage: https://www.topbug.net/blog/2013/06/13/live-preview-of-latex-in-vim/
- Size: 391 KB
- Stars: 832
- Watchers: 13
- Forks: 73
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: COPYING
Awesome Lists containing this project
- stars - xuhdev/vim-latex-live-preview
- awesome-LaTeX - LaTeX Live Preview - Instantly previews your LaTeX document. ![foss] (Editors / General purpose text editors)
README
A Vim Plugin for Lively Previewing LaTeX PDF Output
===================================================
This plugin provides a live preview of the output PDF of your LaTeX file. The
display of the output PDF file will be updated lively as you type (just hold
the cursor and you will see the PDF file updated). Currently,
vim-latex-live-preview only support UNIX-like systems. [Please let me know if
you have any suggestions.](.github/CONTRIBUTING.md)
Table of Contents
-----------------
- [Installation](#installation)
- [Usage](#usage)
- [Configuration](#configuration)
- [Known issues](#known-issues)
- [Screenshot](#screenshot)
Installation
------------
Before installing, you need to make sure your Vim version is later than 7.3,
and is compiled with `+python` feature.
### [vim-plug](https://github.com/junegunn/vim-plug)
Add the plugin in the vim-plug section of your `~/.vimrc`:
```vim
call plug#begin('~/.vim/plugged')
[...]
" A Vim Plugin for Lively Previewing LaTeX PDF Output
Plug 'xuhdev/vim-latex-live-preview', { 'for': 'tex' }
[...]
call plug#end()
```
Then reload the config and install the new plugin. Run inside `vim`:
```vim
:so ~/.vimrc
:PlugInstall
```
### [Vundle](https://github.com/VundleVim/Vundle.vim)
Add the plugin in the Vundle section of your `~/.vimrc`:
```vim
call vundle#begin()
[...]
" A Vim Plugin for Lively Previewing LaTeX PDF Output
Plugin 'xuhdev/vim-latex-live-preview'
[...]
call vundle#end()
```
Then reload the config and install the new plugin. Run inside `vim`:
```vim
:so ~/.vimrc
:PluginInstall
```
### Manually
Copy `plugin/latexlivepreview.vim` to `~/.vim/plugin`.
Usage
-----
Simply execute `:LLPStartPreview` to launch the previewer. Then try to type in
Vim and you should see the live update. The updating time could be set by Vim's
['updatetime'][] option. If your pdf viewer crashes when updates happen, you can
try to set 'updatetime' to a higher value to make it update less frequently. The
suggested value of 'updatetime' is `1000`.
If the root file is not the file you are currently editing, you can specify it
by executing `:LLPStartPreview ` or executing `:LLPStartPreview`
with the following declaration in the first line of your source file:
```latex
% !TEX root =
```
The path to the root file can be an absolute path or a relative path, in which
case it is **relative to the parent directory of the current file**.
:warning: if `` contains special characters (such as space), they
must be escaped manually.
Configuration
-------------
### PDF viewer
By default, you need to have [evince][] or [okular][] installed as pdf viewers.
But you can specify your own viewer by setting `g:livepreview_previewer`
option in your `.vimrc`:
```vim
let g:livepreview_previewer = 'your_viewer'
```
Please note that not every pdf viewer could work with this plugin. Currently
evince and okular are known to work well. You can find a list of known working
pdf viewers [here](https://github.com/xuhdev/vim-latex-live-preview/wiki/Known-Working-PDF-Viewers).
### TeX engine
`LLP` uses `pdflatex` as default engine to output a PDF to be previewed. It
fallbacks to `xelatex` if `pdflatex` is not present. These defaults can be
overridden by setting `g:livepreview_engine` variable:
```vim
let g:livepreview_engine = 'your_engine' . ' [options]'
```
### TeX Inputs
TeX engines use the environment variable `TEXINPUTS` to search for packages and
input files (`\usepackage{pkg}` or `\input{filename}`). LLP passes this
environment variable to the compiler by default. The default can be overridden
by setting the `g:livepreview_texinputs` variable:
```vim
let g:livepreview_texinputs = '/path1/to/files//:/path2/to/files//'
```
Note: The double trailing `/` tells the compiler to search subdirectories.
### Bibliography executable
`LLP` uses `bibtex` as the default executable to process `.bib` files. This can
be overridden by setting the `g:livepreview_use_biber` variable.
```vim
let g:livepreview_use_biber = 1
```
Please note that the package `biblatex` can use both `bibtex` and the newer
`biber`, but uses `biber` by default. To use `bibtex`, add `backend=bibtex`
to your `biblatex` usepackage declaration.
```latex
\usepackage[backend=bibtex]{biblatex}
```
Please note that `biblatex` will NOT work straight out of the box, you will
need to set either `g:livepreview_use_biber` or `backend=bibtex`, but not both.
### Autocmd
By default, the LaTeX sources will be recompiled each time the buffer is written
to disk, but also when the cursor holds. To prevent recompilation on cursor
hold (autocmd events `CursorHold` and `CursorHoldI`), use the feature flag:
```vim
let g:livepreview_cursorhold_recompile = 0
```
Known issues
------------
### Swap error
An error `E768: Swap file exists` may occur. See
[issue #7](https://github.com/xuhdev/vim-latex-live-preview/issues/7) to avoid
swap filename collision.
### Project tree
Currently, root file must be in the same directory or upper in the project tree
(otherwise, one has to save file to update the preview).
### E492: Not an editor command: LLPStartPreview
See [issue #12](https://github.com/xuhdev/vim-latex-live-preview/issues/12),
provided the plugin is correctly installed, this is likely a **Python** issue.
### Python-related issues
See [issue #24](https://github.com/xuhdev/vim-latex-live-preview/issues/24),
currently `vim-latex-live-preview` does not support `python/dyn` and Vim
must be recompiled with Python support.
### Bibliography issues
Why doesn't my bibliography appear, with or without an error?
See [issue #46](https://github.com/xuhdev/vim-latex-live-preview/issues/46) and
[PR #99](https://github.com/xuhdev/vim-latex-live-preview/pull/99).
If you're using `biblatex` this is most likely caused by not also setting
`g:livepreview_use_biber = 1` in your `.vimrc`. Or if you intended to use
`bibtex` not using that option when using the `biblatex` package. i.e.
```latex
\usepackage[backend=bibtex]{biblatex}
```
Screenshot
----------
['updatetime']: http://vimdoc.sourceforge.net/htmldoc/options.html#%27updatetime%27
[evince]: http://projects.gnome.org/evince/
[okular]: http://okular.kde.org/