Skip to content

Provides functionality for object citation - configurable

Notifications You must be signed in to change notification settings

digitalutsc/citation_select

Repository files navigation

Citation Select

Adds a block that allows users to select and view citations of a node object from a list of citation styles. Uses Citation Style Language (CSL) provided by the Bibcite module.

Setup and Usage

Requirements

  • Token module
  • Citeproc-php Library
  • ADCI/Full-Name-Parser Library

Installation

Download module using Composer, and enable with Drush.

Configuration

Block

  1. Place the "Citation Select Block" as a Drupal block (for example, at Structure › Block Layout).
  2. Select the content types that the block should appear in under Configure Block

Mapping

  1. Navigate to Configuration › Citation Select settings › CSL Mappings.
  2. Select node fields to map citation fields from
    1. Mappings can be set for the "type" of citation (e.g. book, document). For example, if your system uses the term Paged Content to identify books, the Name of that term (e.g. "Paged Content") can be mapped to the CSL-recognized term book. If there is no valid type or the field cannot be found, then the type is set to document
    2. Mappings can also be set for Typed Relation fields (see Controlled Access Terms module). For example, if the machine name of a relation is relators:aut, that can be mapped to author so that the correct relations can be extracted for the author field in CSL. Note that the typed relation field must also be set in the CSL field mapping for the "author" CSL field.

Styles

  1. Upload more citation styles using CSL by navigating to Configuration > Citation Select settings > CSL Styles.

Usage

  1. Place the Citation Select block to appear on desired node pages.
  2. Configure the Citation Select CSL Mapping to map node fields to CSL fields.
  3. Install some CSL styles.
  4. Use the Citation Select block on the node's page to choose a citation style. The formatted citation will appear below the block and can be copied with the "Copy citation" button.

Note

If using EDTF dates as a field for citation processing beware of the following:

  • Citation Select processor is unable to handle open interval dates (i.e [..2003] or ../2003)
    • Citation Select will ignore these types of date sets or intervals and cite as if the dates do not exist
  • Citation Select allows for closed date sets and closed interval dates along with single dates (i.e [1999-01..2003-02] or 1999/2003 or 2003-02-01)

About

Provides functionality for object citation - configurable

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages