AirLatex.vim

Current State: Work in Progress
(Please use it right now only for testing purposes.)

Features

That's possible already:

• open documents and write remotely
• cursor positions are sent to the server
• list all projects
• custom servers

Not implemented, yet:
This project is just at its dawn, however I plan to also implement the following features in the future:

• show colored cursor positions of other users
• send recompile-command to the server
• file operations inside vim (new file/copy/delete)
• review mode (comments, track changes, ...)

Installation / First Use

Notes regarding Vim 8 support: Vim 8 will be supported in the future, however i could not make it work completely, yet. If you need this feature feel free to contribute. (See vim8 branch for current state.) ;)

1. Install the requirements. (python3)

   pip3 install keyring tornado requests pynvim
   

2. Install the Vim Plugin itself Using Vim Plug:

   Plug 'da-h/AirLatex.vim', {'do': ':UpdateRemotePlugins'}
   " your login-name
   let g:AirLatexUsername="[email protected]"
   
   " optional: set server name
   let g:AirLatexDomain="www.overleaf.com"
   

   Using Vundle:

   Plugin 'da-h/AirLatex.vim'
   " your login-name
   let g:AirLatexUsername="[email protected]"
   
   " optional: set server name
   let g:AirLatexDomain="www.overleaf.com"
   

   After installation using :PluginInstall run :UpdateRemotePlugins to register the python plugin.

3. For the login, this plugin uses keyring to store credentials by default.
   On your first login, AirLatex will ask for your password. The credentials will be saved in your keyring. AirLatex does not manage credentials for security reasons.

   If your overleaf/sharelatex instance uses a more complicated login process, set your username to "cookies".
   In that case, AirLatex will ask you for the session cookies (that unfortunately needs to be lookuped-up by hand in your browser) and paste it into the promt.
   Alternatively, assuming your session cookie is YOURSESSIONCOOKIE, you can circumvent the login prompt by setting the username to "cookies:YOURSESSIONCOOKIE".
   If you have any Idea how to improve this process, feel free to contribute or raise an issue.

4. Open AirLatex in Vim with :AirLatex Feel free to map AirLatex to a binding of your liking, e.g.:

   nmap <leader>a :AirLatex<CR>
   

Settings

Troubleshooting

If you find a bug.
Feel free to open an issue! To make things a bit easier for me, please use AirLatex' debug mode (leg g:AirLatexLogLevel='DEBUG').

Credits

This plugin is a complete rework of Vim-ShareLaTeX-Plugin.
I took all the good ideas and added even more vim love. ❥ ;)