amin/vim-denote
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

doc: denote link completion

Browse Source
This commit is contained in:
Ämin Baumeler
2026-02-19 16:19:18 +01:00
parent 83ea4f2bcf
commit 24cadefafc
2 changed files with 21 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
README.md
View File

@@ -32,15 +32,22 @@ the help files. This will allow you to get more help using `:help denote` or
similar commands. similar commands.
### Usage ### Usage
For following links, simply move your cursor to the denote link, and press For _following links,_ simply move your cursor to the denote link, and press
`gf`. `gf`.
Browsing and searching notes is implemented using the [location This package also provides denote _link completion_ using the
[|'omnifunc'|](https://vimhelp.org/options.txt.html#%27omnifunc%27) option. So,
the link is completed after pressing `<C-X><C-O>` while typing any prefix of a
denote link `denote:<identifier>`. Even more so, if this completion is invoked
after typing `denote:<str>`, then the link is completed for denote entries
that have `<str>` as part of the title.
_Browsing_ and _searching notes_ is implemented using the [location
list](https://vimhelp.org/quickfix.txt.html#location-list). list](https://vimhelp.org/quickfix.txt.html#location-list).
So, after running any of the following commands, you may navigate your notes This means that you may navigate your notes using, e.g., `:lopen` to open the
using, e.g., `:lopen` to open the list, `:lnext` and `:lprev`, to move to the next or list, `:lnext` and `:lprev`, to move to the next or previous entry (the list
previous entry (the list does not need to be opened for that), and `:lclose` does not need to be opened for that), and `:lclose` for closing the location
for closing the location list. list.
#### Commands #### Commands
This package defines the following user commands: This package defines the following user commands:

13
doc/denote.txt
View File

@@ -21,7 +21,7 @@ do adjusting the tags or changing the title of a note. The official manual is
available online: available online:
https://protesilaos.com/emacs/denote https://protesilaos.com/emacs/denote
The denote plugin adds denote-functionality to vim --- the vim way. We are The denote plugin adds denote functionality to vim --- _the vim way._ We are
aware of two other plugins, but we fear that these plugins are not flexible aware of two other plugins, but we fear that these plugins are not flexible
enough, and more importantly, do not follow the vim philosophy for handling enough, and more importantly, do not follow the vim philosophy for handling
denote notes. These mentioned plugins are available here: denote notes. These mentioned plugins are available here:
@@ -29,10 +29,13 @@ denote notes. These mentioned plugins are available here:
https://git.sr.ht/~ashton314/vim-denote https://git.sr.ht/~ashton314/vim-denote
In contrast to these plugins, the present package relies on the In contrast to these plugins, the present package relies on the
|location-list| features for displaying denote entries, and on and |location-list| features for displaying denote entries, and on the options
|'includeexpr'| option for following the links (see, |gf|). This plugin also |'quickfixtextfunc'|, |'includeexpr'|, and |'omnifunc'|. With these, denote
provides custom location-list formatting using the option links can be followed using |gf|, and completed using omni comletion (see,
|'quickfixtextfunc'|. |compl-omni|). For link completion, press |i_CTRL-X_CTRL-O| after typing any
prefix of a denote link. This completion also works with titles: by invoking
omni completion after typing "denote:foo", denote links are completed for
entries containing "foo" in the title.
*denote-commands* *denote-commands*
Commands ~ Commands ~