Filetype detection, syntax highlighting, auto-formatting, auto-completion, and other tools for working with ledger files.
Compatible with both
See plaintextaccounting.org for background information and other useful links.
Install as you would any other VIM plugin.
There are a variety of ways depending on your plugin manager.
For example with Pathogen you would clone this repository into your configuration directory.
With vim-plug and many similar ones, you would declare it in your rc file like this, then run
Install using VIM packages functionality (vim 8+)
To install as a single plugin, using VIM packages functionality first create a target folder:
mkdir -p ~/.vim/pack/ledger/start cd ~/.vim/pack/ledger/start git clone <URL>
Edit .vimrc and append the line:
You can also manually copy the corresponding directories into your VIM plugins directory.
One installed this plugin will identify files ending with
.journal as ledger files automatically.
Alternatively if you use a different extension you can add a modeline to each like this:
; vim: filetype=ledger
Tips and useful commands
Try account-completion (as explained below)
:call ledger#transaction_date_set(line('.'), 'auxiliary')
will set today's date as the auxiliary date of the current transaction. You can use also
unshiftin place of
auxiliary. When you pass "unshift" the old primary date will be set as the auxiliary date and today's date will be set as the new primary date. To use a different date pass a date measured in seconds since 1st Jan 1970 as the third argument.
:call ledger#transaction_state_set(line('.'), '*')
sets the state of the current transaction to '*'. You can use this in custom mappings.
:call ledger#transaction_state_toggle(line('.'), ' *?!')
will toggle through the provided transaction states. You can map this to double-clicking for example:
noremap <silent><buffer> <2-LeftMouse>\ :call ledger#transaction_state_toggle(line('.'), ' *?!')<CR>
Align commodities at the decimal point. See
will replace the text on the current line with a new transaction based on the replaced text.
Include the following let-statements somewhere in your
.vimrc to modify the behaviour of the ledger filetype.
Number of columns that will be used to display the foldtext. Set this when you think that the amount is too far off to the right.
let g:ledger_maxwidth = 80
String that will be used to fill the space between account name and amount in the foldtext. Set this to get some kind of lines or visual aid.
let g:ledger_fillstring = ' -'
If you want the account completion to be sorted by level of detail/depth instead of alphabetical, include the following line:
let g:ledger_detailed_first = 1
By default vim will fold ledger transactions, leaving surrounding blank lines unfolded. You can use
g:ledger_fold_blanksto hide blank lines following a transaction.
let g:ledger_fold_blanks = 0
A value of 0 will disable folding of blank lines, 1 will allow folding of a single blank line between transactions; any larger value will enable folding unconditionally.
Note that only lines containing no trailing spaces are considered for folding. You can take advantage of this to disable this feature on a case-by-case basis.
Omni completion is implemented for transactions descriptions and posting account names.
Account names are matched by the start of every sub-level. When you insert an account name like this:
You will get a list of top-level accounts that start like this.
Go ahead and try something like:
When you have an account like this, 'Assets:Bank:Checking' should show up.
When you want to complete on a virtual transaction, it's currently best to keep the cursor in front of the closing bracket. Of course you can insert the closing bracket after calling the completion, too.
Copyright 2019–2021 Caleb Maclennan
Copyright 2009–2017 Johann Klähn
Copyright 2009 Stefan Karrmann
Copyright 2005 Wolfgang Oertl
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.