Documentation for Developers

Documentation for Developers

Installing on Vagrant (for testing)

• Install or start up Islandora

  Vagrant (https://github.com/Islandora-Labs/islandora\_vagrant)

• Install Transcript UI

  • git clone

    https://github.com/sprklinginfo/transcripts_ui.git

  • drush en transcripts_ui -y

• Install Oral Histories Module

  • git clone

    https://github.com/digitalutsc/islandora_solution_pack_oralhistories.git

  • Go to Drupal modules page and enable the oral histories module

• Go to Transcript UI (under Configuration) and configure default and

  any additional transcript tiers and speakers needed.

  • Tiers

    • or_transcript|Transcript

    • or_translation|Translation

  • Speaker names

    • or_speaker|Speaker

    • or_solespeaker|Speaker

• Configure Solr (copy xslt, add field, restart tomcat sudo service

  tomcat7 restart)

  • cd

    /var/lib/tomcat7/webapps/fedoragsearch/WEB-INF/classes/fgsconfigFinal/index/FgsIndex/islandora_transforms

  • cp

    /var/www/drupal/sites/all/modules/islandora_solution_pack_oralhistories/xsl/or_transcript_solr.xslt ./

  • cd ..

  • Edit foxmlToSolr.xslt, and add the following line

    • <xsl:include

      href="/var/lib/tomcat7/webapps/fedoragsearch/WEB-INF/classes/fgsconfigFinal/index/FgsIndex/islandora_transforms/or_transcript_solr.xslt"/>

  • Edit /usr/local/solr/collection1/conf/schema.xml and add the

    following dynamicfield:

    • <dynamicField name="or_*" type="text" indexed="true" stored="true" multiValued="true"/>

  • Restart the tomcat

• Configure Module Options:

  • Go to admin/islandora/solution_pack_config/oralhistories

    (in Drupal)

• Manual Testing - Uploading an oral history object/media and a

  transcript

  • Get test fixtures from here:

    https://github.com/digitalutsc/islandora\_solution\_pack\_oralhistories/tree/master/tests/fixtures

  • Go to

    islandora/object/islandora%253Aoralhistories_collection/manage (in Drupal)

  • Click Add an object to this collection and continue with the

    workflow to ingest the media and transcript files

• Automated Testing - Running ingest/purge tests for Oral History

  • Enable Testing module

  • Go to admin/config/development/testing

  • Ensure drupal filter at

    /usr/local/fedora/server/config/filter-drupal.xml is writable by the server (chown www-data:www-data filter-drupal.xml)

  • Scroll down to oral history tests, check them and run the tests

• Theme

  • If you are using non bootstrap theme, then include

    (in islandora_oralhistories.info)

  • stylesheets[all][] = bootstrap/css/oh-bootstrap-all.css

  • scripts[] = bootstrap/js/bootstrap.min.js

• Please make sure to have the following permission set:

• View repository objects: View objects in the repository. Note:

  Fedora XACML security policies may override this permission.

• remove the @scripts in the Transcript UI