Processing Files With RCite
RCite features a preprocessing mode that allows you to easily insert citations and bibliography entries into arbitrary text files. This guide will show you step by step how to do so.
Preprocessing is based on commands very similar to those on the command line
rcite cite and
rcite bib). RCite must know where to find those, therefore
they are surrounded by the so-called 'skeleton' which consists of four percent
%%[command goes here]%%
Each command starts with two words: the command itself ('cite' or 'bib') and the unique key of the text you want to have a citation/bibliography entry for. So if you want to want cite the text 'rauber2008', the whole command would be:
When citing texts, you will frequently want to add a page number to your citation. RCite provides a shortcode for that: Just add the page number after the unique key.
%%cite rauber2008 25%%
This would cite page 25 of the 'rauber2008' text.
Page numbers are not restricted to actual numbers, however: You can also specify page ranges and all sorts of other stuff here. For instance, to cite pp. 25--33:
%%cite rauber2008 25--33%%
However, if you want to use whitespace in your 'page number' (like spaces or tabs, e.g. for citing a paragraph like '§ 256'), you must enclose it in quotation marks, like so:
%%cite rauber2008 "§ 256"%%
Custom BibTeX fields
In some situations you might want to add a BibTeX field to one specific text 'on the fly' without putting it into your bibliography file. RCite supports that too:
%%cite rauber2008 title: Rauber is cool, shorttitle: Rauber cool%%
Here we have specified a new
title ('Rauber is cool') and
('Rauber cool') for this specific citation. These override the
shorttitle values we might have in the bibliography file. Note that the
individual assignments are separated by commas.
Of course you can also specify a page number and custom fields simultaneously. In this case, the page number must precede the custom fields.
%%cite rauber2008 25 title: Rauber is cool%%
Note that if you want to use special characters in your additional fields, you must surround them with quotation marks:
%%cite rauber2008 title: "Is Rauber cool?"%%