Managing notes

This section contains all commands that you need to manage extended notes.

Add Notes

refdb-addnote-on-buffer(void);

bound to: Ctrl-cCtrl-rna

Adds the extended notes in the current buffer to the currently selected database. If nxml-mode considers the buffer to be invalid, an error message is returned and no data are sent to the database

Update Notes

refdb-updatenote-on-buffer(void);

bound to: Ctrl-cCtrl-rnu

Updates the extended notes in the current buffer, i.e. existing notes in the database are updated with the data of the current buffer. Works essentially like the Add Notes command.

Delete Notes

refdb-deletenote(idlist);

bound to: Ctrl-cCtrl-rnd

Asks interactively for a list of NIDs to delete from the current database. The notes will be permanently removed from the database.

Note

It is not possible to delete notes that you do not own.

Get Notes submenu

This submenu provides a variety of commands to run simple and complex queries to retrieve extended notes. The commands interactively ask for the value to search for. Wherever appropriate there is a choice between exact matches and regular expressions.

Title

refdb-getnote-by-title(title);

bound to: Ctrl-cCtrl-rot

Asks interactively for the title of a reference. All references that use this string as a title will be displayed. refdb-mode attempts an exact match of the value that you type in.

Title (regexp)

refdb-getnote-by-title-regexp(title);

bound to: Ctrl-cCtrl-rpt

Asks interactively for a title as a regular expression. All notes that contain a matching string as a title will be displayed. refdb-mode attempts a regular expression match of the value that you type in.

Keyword

refdb-getnote-by-keyword(keyword);

bound to: Ctrl-cCtrl-rok

Asks interactively for a keyword. All extended notes that contain this keyword will be displayed. refdb-mode attempts an exact match of the value that you type in. Tab completion is available.

Keyword (regexp)

refdb-getnote-by-keyword-regexp(keyword);

bound to: Ctrl-cCtrl-rpk

Asks interactively for a keyword as a regular expression. All extended notes that contain this keyword will be displayed. refdb-mode attempts a regular expression match of the value that you type in. Tab completion is available.

Note ID

refdb-getnote-by-nid(id);

bound to: Ctrl-cCtrl-roi

Asks interactively for the numerical ID of an extended note which will be displayed. The ID is a unique identifier of each note which is maintained by RefDB.

Citation key

refdb-getnote-by-ncitekey(citekey);

bound to: Ctrl-cCtrl-roc

Asks interactively for the alphanumeric citation key of an extended note which will be displayed. The citation key is also an unique identifier which you can set when first adding a note to the database.

Linked to Author

refdb-getnote-by-authorlink(author);

bound to: Ctrl-cCtrl-roa

Asks interactively for the name of an author which will be used for an exact match. All notes which are linked to this author name will be displayed.

Linked to Author (regexp)

refdb-getnote-by-authorlink-regexp(author);

bound to: Ctrl-cCtrl-rpa

Asks interactively for the name of an author which will be used for a regexp match. All notes which are linked to this author name will be displayed.

Linked to Periodical

refdb-getnote-by-periodicallink( periodical);
  periodical);

bound to: Ctrl-cCtrl-rop

Asks interactively for the name of a periodical which will be used for an exact match. All notes which are linked to this periodical will be displayed.

Linked to Periodical (regexp)

refdb-getnote-by-periodicallink-regexp( periodical);
  periodical);

bound to: Ctrl-cCtrl-rpp

Asks interactively for the name of a periodical which will be used for a regexp match. All notes which are linked to this periodical will be displayed.

Linked to Keyword

refdb-getnote-by-keywordlink(keyword);

bound to: Ctrl-cCtrl-rol

Asks interactively for a keyword which will be used for an exact match. All notes which are linked to this keyword will be displayed.

Linked to Keyword (regexp)

refdb-getnote-by-keywordlink-regexp( keyword);
  keyword);

bound to: Ctrl-cCtrl-rpl

Asks interactively for a keyword which will be used for a regexp match. All notes which are linked to this keyword will be displayed.

Linked to ID

refdb-getnote-by-idlink(id);

bound to: Ctrl-cCtrl-roq

Asks interactively for the ID of a reference. All notes which are linked to this reference will be displayed.

Linked to Citation Key

refdb-getnote-by-citekeylink(citekey);

bound to: Ctrl-cCtrl-rov

Asks interactively for the citation key of a reference. All notes which are linked to this reference will be displayed.

Advanced Notes search

refdb-getnote-by-advanced-search( searchstring);
  searchstring);

bound to: Ctrl-cCtrl-rod

Asks interactively for a complete notes query string. The syntax of getnote queries is described in the RefDB manual. You may need to escape special characters to hide them from the Lisp interpreter in order to obtain a valid query string.

Get Notes on Region submenu

The commands of this submenu do not ask for a value to search for, but work on a region that you have selected in the current buffer, either by mouse or by setting mark and point appropriately. The contents of the region will be used as the value of your query.

Title

refdb-getnote-by-title-on-region(void);

bound to: Ctrl-cCtrl-rCtrl-ot

Uses the selected region as the value of a title regular expression search. All notes which contain the given title will be displayed.

Keyword

refdb-getnote-by-keyword-on-region(void);

bound to: Ctrl-cCtrl-rCtrl-ok

Uses the selected region as the value of a keyword regular expression search. All notes which contain a matching keyword will be displayed.

Linked to Author

refdb-getnote-by-authorlink-on-region(void);

bound to: Ctrl-cCtrl-rCtrl-oa

Uses the selected region as the value of an author name regular expression search. All notes which are linked to a matching person will be displayed.

Linked to Keyword

refdb-getnote-by-keywordlink-on-region(void);

bound to: Ctrl-cCtrl-rCtrl-ol

Uses the selected region as the value of a keyword regular expression search. All notes which are linked to a matching keyword will be displayed.

Linked to Periodical

refdb-getnote-by-periodicallink-on-region(void); 
 void); 

bound to: Ctrl-cCtrl-rCtrl-op

Uses the selected region as the value of a periodical search. Notes which are linked to a matching periodical will be displayed.

Linked to ID

refdb-getnote-by-idlink-on-region(void);

bound to: Ctrl-cCtrl-rCtrl-oq

Uses the selected region as the value of a reference ID search. Notes linked to the reference with the given ID will be displayed.

Linked to Citation Key

refdb-getnote-by-citekeylink-on-region(void);

bound to: Ctrl-cCtrl-rCtrl-ov

Uses the selected region as the value of a reference citation key search. Notes linked to the reference with the given citation key will be displayed.

Add Links

refdb-addlink(void);

Asks interactively for the ID of an extended note, and for a list of items to link to. Appropriate links will be added to the note.

Delete Links

refdb-deletelink(void);

Asks interactively for the ID of an extended note, and for a list of items to be unlinked. Matching links will be deleted from the note.