Table of Contents
Essentially all commands are accessible through the menu, and the most common commands are also accessible through keyboard shortcuts. The menu is subdivided into several sections. We'll discuss the sections in the order of appearance. Each description contains the synopsis of the refdb-mode command, i.e. what you'll have to type in after pressing M-x if you want to run the command from the minibuffer.
This section contains all commands that you need to manage references.
refdb-addref-on-region(void);
bound to: Ctrl-cCtrl-rra
Adds the references in the current buffer to the currently selected database. If the buffer is a risx buffer, the whole contents of the buffer will be added to the database. If nxml-mode considers the buffer to be invalid, an error message is returned and no data are sent to the database
If the buffer is a RIS buffer and no region is selected, the whole buffer will be sent to the database. If a region is selected, only the references contained in the region will be sent to the database.
refdb-updateref-on-region(void);
bound to: Ctrl-cCtrl-rru
Updates the references in the current buffer, i.e. existing references in the database are updated with the data of the current buffer. Works essentially like the Add References command.
refdb-checkref-on-region(void);
bound to: Ctrl-cCtrl-rrc
Checks the references in the current buffer against the ones in the current database. You'll get a list of possible duplicate references, author names, periodicals, and keywords.
refdb-deleteref(idlist);
bound to: Ctrl-cCtrl-rrd
Asks interactively for a list of IDs to delete from the current database. The references will be permanently removed from the database.
It is not possible to delete references that other users have added to their personal interest list. Use Dump References instead in this case
This submenu provides a variety of commands to run simple and complex queries. The commands interactively ask for the value to search for. Wherever appropriate there is a choice between exact matches and regular expressions.
refdb-getref-by-author(author);
bound to: Ctrl-cCtrl-rga
Asks interactively for the name of an author. All references that contain this person as an author, as an editor, or as a series editor will be displayed. refdb-mode attempts an exact match of the value that you type in. Tab completion is available.
refdb-getref-by-author-regexp(author);
bound to: Ctrl-cCtrl-rxa
Asks interactively for the name of an author as a regular expression. All references that contain this person as an author, as an editor, or as a series editor will be displayed. refdb-mode attempts a regular expression match of the value that you type in. Tab completion is available.
refdb-getref-by-title(title);
bound to: Ctrl-cCtrl-rgt
Asks interactively for the title of a reference. All references that use this string as a title, a book title, or a series title will be displayed. refdb-mode attempts an exact match of the value that you type in.
refdb-getref-by-title-regexp(title);
bound to: Ctrl-cCtrl-rxt
Asks interactively for a title as a regular expression. All references that contain a matching string as a title, a book title, or a series title will be displayed. refdb-mode attempts a regular expression match of the value that you type in.
refdb-getref-by-keyword(keyword);
bound to: Ctrl-cCtrl-rgk
Asks interactively for a keyword. All references that contain this keyword will be displayed. refdb-mode attempts an exact match of the value that you type in. Tab completion is available.
refdb-getref-by-keyword-regexp(keyword);
bound to: Ctrl-cCtrl-rxk
Asks interactively for a keyword as a regular expression. All references 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.
refdb-getref-by-periodical(periodical);
bound to: Ctrl-cCtrl-rgp
Asks interactively for the name of a periodical. All references that were published in this periodical will be displayed. refdb-mode attempts an exact match of the value that you type in. Tab completion is available.
refdb-getref-by-periodical-regexp( | periodical); | |
periodical); |
bound to: Ctrl-cCtrl-rxp
Asks interactively for the name of a periodical as a regular expression. All references that were published in this periodical will be displayed. refdb-mode attempts a regular expression match of the value that you type in. Tab completion is available.
refdb-getref-by-id(id);
bound to: Ctrl-cCtrl-rgi
Asks interactively for the numerical ID of a reference which will be displayed. The ID is a unique identifier of each reference which is maintained by RefDB.
refdb-getref-by-citekey(citekey);
bound to: Ctrl-cCtrl-rgc
Asks interactively for the alphanumeric citation key of a reference which will be displayed. The citation key is also an unique identifier which you can set when first adding a reference to the database.
refdb-getref-by-advanced-search( | searchstring); | |
searchstring); |
bound to: Ctrl-cCtrl-rgd
Asks interactively for a complete query string. The syntax of getref 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.
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.
refdb-getref-by-author-on-region(void);
bound to: Ctrl-cCtrl-rCtrl-ga
Uses the selected region as the value of an author regular expression search. All references which contain the given person as an author, editor, or series editor will be displayed.
refdb-getref-by-title-on-region(void);
bound to: Ctrl-cCtrl-rCtrl-gt
Uses the selected region as the value of a title regular expression search. All references which contain a matching string in the title, the book title, or the series title will be displayed.
refdb-getref-by-keyword-on-region(void);
bound to: Ctrl-cCtrl-rCtrl-gk
Uses the selected region as the value of a keyword regular expression search. All references which contain a matching keyword will be displayed.
refdb-getref-by-periodical-on-region(void);
bound to: Ctrl-cCtrl-rCtrl-gp
Uses the selected region as the value of a periodical regular expression search. All references which were published in a matching periodical will be displayed.
refdb-getref-from-citation(void);
bound to: Ctrl-cCtrl-rCtrl-c
Uses the citation around point to retrieve all cited references in that citation from the database.
refdb-pickref(idlist);
Asks interactively for a list of ID values. These references will be added to your personal reference list.
refdb-dumpref(idlist);
Asks interactively for a list of ID values. These references will be removed from your personal reference list.
This submenu offers a variety of commands to convert reference data to and from RIS. All commands work on the data in the current buffer and do not access the RefDB database. Use these commands to import from or export to data formats that RefDB does not support natively. In the first case, the buffer must contain reference data in one of the formats BibTeX, copac, EndNote, ISI, Medline, or MODS. The result will be in RIS format. In the second case the buffer must contain RIS data. The output will be either EndNote or MODS.