This module adds a CKEditor5 plugin to insert inline citations that appear as a bibliography below the content. It integrates with the Bibliography & Citation module and allows users to select or create reference entities.
Contents
Introduction
This module provides a CKEditor5 plugin that lets a user select from a list of references to Bibliography & Citation][1] reference entities which will then appear both inline as citations and as a bibliography below the content.
Requirements
- Bibliography & Citation (3.0.x version)
- Inline Entity Form (Recommended)
Installation
-
Install as normal, which will also enable the dependent modules Bibcite and Bibcite Entity.
-
Enable the Insert Citations button in CKEditor5:
-
Go to Administration > Configuration > Text Formats andd Editors and edit a format.
-
Move "Insert Citation" into the active toolbar.
-
Enable the "Convert bibcite-footnote tags to rendered citations." filter.
-
Customize the filter's settings in the "Inline citation filter" section.
Works Cited field
- Go to Administration > Structure > Content Types and edit the type that will include Reference Footnotes
- In the Manage Fields tab, press Add Field.
- Choose Reference as the type of field to add, and "reference" as type of content. (In the second case "Reference" is the Bibcite Reference Entity type).
- Enter an appropriate label and press 'Save and continue'.
- On the next page select all the items in "Reference type" that should be available to choose from as footnotes.
- Customize the field under "Manage form display" and "Manage display",
- Since the bibliography is rendered directly in the Body, choose 'Disabled' for the Works Cited field's display position.
Inline Entity Form
It's recommended to also install Inline Entity Form which allowes a user to create new references directly in the node edit form.
- In "Entity Form Display", select "Inline Entity Form - complex".
- Press the settings button in the rightmost column.
- Enabling "Allow users to add new reference entities" and "Allow users to add existing reference entities" is recommended.
Use
See the documentation for Bibliography and Citation - Import module for how to add citations exported from a citation management system like RefWorks, EndNote, or Zotero.
If a user has permission to use Bibcite Import a link will appear below the Works Cited field in the node edit form.
Adding a Works Cited item
If Inline Entity Form is enabled, an author can create new citations or add references to previously-imported or created references directly with the 'Add new reference' and 'Add existing reference' buttons.
With Inline Entity Form, newly-added citations are immediately selectable in the Reference Footnotes dialog.
If not using the inline entity form, you can select previously imported or created references and save the node. When you edit the node again, and you click on the 'Insert Citation' editor toolbar button, a list of citations will be available to choose from.
Citation Formatting
The Default style selected in the Bibliography & Citation administration pages at Administration > Configuration > Bibliography & Citation > Settings in the Processing tab under Processor.' will be used as the format for all citations and bibliographies.
Current Maintainers
- Alexander O'Neill (https://www.drupal.org/u/alxp)
Sponsors
- TCreated for the University of Prince Edward Island Robertson Library. It was created to provide citations for the Journal of Lucy Maude Montgomery Studies.