About this plugin
JReferences adds numbered footnotes and bibliographic references to individual posts and pages, with reusable named citations. The bibliography appears automatically at the end of the content. The plugin does not render notes in archives or excerpts.
To use it, simply add your reference using a shortcode you can choose (‘jref’ by default), and a few attributes (always use lowercase):
- title (mandatory)
- author
- date
- url
- editor
- page
- lang
- readon
Values are treated as plain text (except URLs); HTML markup is not supported inside individual reference fields. Only ‘title’ is mandatory. All attributes roles are easy to understand; ‘page’ is for a book (but can be used for any content), ‘readon’ is the date you last consult the reference.
Again, in this first release, there’s no specific control or action triggered by attribute’s content (like verifying the format, or linking to an archive site). Maybe in a future release…
A list of all references will be added at the end of the post. When a reader follows a numbered citation link, the corresponding bibliography entry is highlighted in pale yellow using the CSS:target selector. The highlight remains until another fragment identifier is selected.
Here are some examples:
- [jref]url=http://geba.fr|date=janv 2017|title=The Title.|author=Janiko|lang=FR|editor=geba.fr|page=p.5[/jref]
- [jref name=’numref’]url=http://geba.fr|date=janv 2017|title=The Title.|author=Janiko|lang=FR|editor=geba.fr|page=p.5[/jref]
- [jref name=’numref’ /]
You can optionnaly add a name to the citation, so you can reuse it in your post. Important note: the displayed attributes will be the attributes of the FIRST reference with that name. Any other attribute will be ignored.
Description en français
JReferences ajoute des appels de notes numérotés et une bibliographie à la fin des articles et pages consultés individuellement. Une référence nommée peut être réutilisée plusieurs fois. Aucun affichage des notes dans les archives ou extraits.
Quand on clique sur un numéro de note, la référence correspondante est surlignée en jaune pâle grâce à la règle CSS:target, pour faciliter son repérage. La surbrillance disparaît lorsqu’une autre ancre est sélectionnée.
org[/jref], puis [jref name="source" /]. Les réglages permettent de changer le nom du shortcode, mais les anciens contenus qui utilisent le précédent nom ne seront alors plus interprétés.