discoverygarden / islandora_cwrc_writer

Islandora wrapper for the CWRC-Writer.

Home Page:https://github.com/cwrc/CWRC-Writer

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Islandora CWRC-Writer Build Status

Introduction

Provides a very minimal wrapper around the CWRC-Writer, so that it can be used in an islandora context.

Requirements

This module requires the following modules/libraries:

jQuery Update is not a hard requirement but is necessary if you want to use the templates in the documents dialog box. octokit.js which is used to fetch the templates uses the global jQuery rather than using require.js to fetch the CWRC-Writer specific template.

CWRC-Writer is expected to be installed here:

  • sites/all/libraries/CWRC-Writer (libraries directory may need to be created)

So far we've only tested up to commit 7f96f78e77

Java Servlet Configuration

CWRC-Writer depends on a number of Java Servlets to be functional.

Follow the instructions on the page, but also rename the generated war to validator.war. In most cases your tomcat should exist here /usr/local/fedora/tomcat.

Reverse proxy config:

We make the assumption that we (reverse) proxy VIAF, to fix the same-origin issue.

For Apache, with Drupal running on the same box as Apache, a couple lines like:

ProxyPass /viaf http://www.viaf.org/viaf
ProxyPassReverse /viaf http://www.viaf.org/viaf

To be able to validate documents, we require that the validator.war is deployed to your tomcat directory, and that you set up a (reverse) proxy so that the CWRC-Writer can communicate with it.

ProxyPass /cwrc/services/validator/ http://localhost:8080/validator/
ProxyPassReverse /cwrc/services/validator/ http://localhost:8080/validator/

To be able to access Geonames service you must set up a proxy with authentication:

<Location /geonames>
   RequestHeader set Authorization "Basic XXXXX"
   ProxyPass http://apps.testing.cwrc.ca/cwrc-mtp/geonames/
   ProxyPassReverse http://apps.testing.cwrc.ca/cwrc-mtp/geonames/
</Location>

You'll need permission / authentication credentials from the CWRC organization. You can generation the credentials (replaces the XXXXX portion above) like so:

echo -n "username:password" | base64

In addition you must also enable mod_headers for the authentication credentials to be passed on to the CWRC Geonames service. With apache2 on Ubuntu this can be done like so:

sudo a2enmod headers
sudo service apache2 restart

To Do

Troubleshooting/Issues

Having problems or solved a problem? Contact discoverygarden.

Maintainers/Sponsors

Current maintainers:

Development

If you would like to contribute to this module, please check out our helpful Documentation for Developers info, Developers section on Islandora.ca and contact discoverygarden.

License

GPLv3

About

Islandora wrapper for the CWRC-Writer.

https://github.com/cwrc/CWRC-Writer

License:GNU General Public License v3.0


Languages

Language:PHP 73.3%Language:JavaScript 25.2%Language:CSS 1.5%