A Solution Pack for handling citations and theses. A foundational module for implementing Islandora as an institutional repository.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
build
images
includes
js
modules
tests/scripts
xml
xsl
.travis.yml
CONTRIBUTING.md
LICENSE.txt
README.md
build.xml
islandora_scholar.api.php
islandora_scholar.drush.inc
islandora_scholar.info
islandora_scholar.install
islandora_scholar.module

README.md

Islandora Scholar Build Status

Introduction

Islandora Scholar is a suite of modules designed to help Islandora function as an Institutional Repository. It provides a framework for handling Citation and Thesis objects, and a variety of additional features for working with citations. It includes:

  • Citation Content Model and Thesis Content Model (and associated default forms)
  • Display formatted citations based on MODS data based on user-uploaded CSL files
  • (optional) tab on Citation objects containing the self-archiving policies of the associated periodical, based on Sherpa/RoMEO
  • (optional) links on Citation and Thesis objects to search for them in Google Scholar or your local discovery layer
  • Importers and populators to create objects based on DOIs, PMIDs, Endnote XML, or RIS files (see associated submodules)
  • Ability to embargo objects or datastreams permanently or with a time limit (see Scholar Embargo submodule)
  • Google Scholar-ready microdata in meta tags (see Islandora Google Scholar submodule)

Requirements

This module requires the following modules/libraries:

The Citeproc module depends on the citeproc-php library, which should be installed in the sites/all/libraries directory, such that the main CiteProc.php file is located at sites/all/libraries/citeproc-php/CiteProc.php. More information is available in Citeproc's README.md file.

The Bibutils module depends on Bibutils, a command-line tool which must be installed on the server. More information is available in Bibutils' README.md file.

Installation

Install as usual, see this for further information. This module requires new Fedora objects. If enabling through Drush, use the administrative user (e.g. drush en -u 1 islandora_scholar).

Configuration

Configure Islandora Scholar at Administration » Islandora » Solution pack configuation » Scholar (admin/islandora/solution_pack_config/scholar). Further documentation of the available options is available at our wiki.

Upgrade notice

As of Islandora 7.x-1.3, PDF datastreams of citationCModel objects are expected to have derivatives (PREVIEW, TN, optionally FULL_TEXT). Existing citations that are missing PDF-derived datastreams can be updated using the provided Drush script, which will generate the derivatives.

This can be done by running: drush -u 1 islandora-scholar-update-citations

Documentation

Further documentation for this module is available at our wiki.

Complementary Modules

Aside from the submodules bundled with Scholar, several other modules can be useful for creating an institutional repository:

  • Entities Solution Pack - create and manage objects representing people (scholars) and organizations (departments)
  • Islandora Badges - display citation counts for objects, pulling from a variety of citation-tracking APIs
  • Islandora Usage Stats - keeps track of views/downloads of Islandora objects.

Troubleshooting/Issues

Having problems or solved a problem? Check out the Islandora google groups for a solution.

Maintainers/Sponsors

Current maintainers:

Development

If you would like to contribute to this module, please check out CONTRIBUTING.md. In addition, we have helpful Documentation for Developers info, as well as our Developers section on the Islandora.ca site.

License

GPLv3