Skip to content

Latest commit

 

History

History
46 lines (31 loc) · 3.2 KB

README.md

File metadata and controls

46 lines (31 loc) · 3.2 KB

Bepress Plugin for Janeway

This plugin allows you to import an export of a bepress Digital Commons publication into a Janeway instance

There are 3 supported Digital Commons structure types:

  • Journals
  • Series (Imported as a journal)
  • Events (Limited support)

Installation Instructions

  1. Clone this repository into the Janeway plugins folder (path/to/janeway/src/plugins/)
  2. Run the plugin installation command: python3 src/manage.py install_plugins typesetting.
  3. Run the migration command python3 src/manage.py migrate bepress
  4. Restart your webserver

Usage guide

Bepress offers various mechanisms for exporting your metadata:

Importing from an Amazon S3 backup

If you have enabled the Amazon S3 backup service with Bepress, you will have access to a backup containing your articles files and metadata in XML format. In order to ingest that backup into Janeway, you will need to load that backup directory into Janeway's file system under src/files/plugins/bepress.

Importing from a spreadsheet

If you don't have access to a bepress archive via Amazon S3, you can instead download a batch export from your bepress installation. The metadata is not as complete as with an XML archive (e.g submission dates are not present) But it has enough metadata to recreate the articles in Janeway.

Note Some exports won't include the PDF URL (fulltext_url), in those cases, this plugin will attempt to retrieve the URL of the PDF from the live article page.

The spreadsheet needs to be exported as a CSV before you can import it into Janeway and then it be loaded from the Bepress plugin page in your Janeway installation. Janeway will generate a set of XML files, equivalent to the bepress archive format that will be saved under src/files/plugins/bepress

Importing from OAI

Another alternative for those who don't have access to the archive files is to generate one using Bepress OAI endpoint. This feature is only supported via command line however and can take a long time, since it will generate an archive of the metadata for the entire institution.

To run this command all you need is the OAI url for your institution and then run the command import_bepress_from_oai.

The resulting metadata archives will be saved under src/files/plugins/bepress and will be displayed in the bepress plugin management page, ready to be loaded into any Janeway site.

Metadata Bindings

You can see a table on how the metadata is translated from the Bepress archives into Janeway in this document

Running the import process

Once your XML metadata has been loaded in (whether from an archive or from a CSV), you can run the import process by visiting the Bepress page in your Janeway installation and completing the import form. In this form you will need to select the journal onto which you want to load the articles, the structure type of the incoming data in bepress as well as an option to load the content onto a different Issue in Janeway than the issue declared on the article metadata: Bepress Import Form