Skip to content

00mjk/yale-mirador

 
 

Repository files navigation

Build Status Dependency Status

Yale Mirador Extension

This projects embeds Mirador and also contains some modifications and extensions to it.

Definitions

Some clarification of the terms we will be using because it can get quite confusing:

  • IIIF Mirador: the original Mirador project and its code at https://github.com/IIIF/mirador
  • Yale Core: the Yale fork of Mirador with the same structure as "IIIF Mirador" but with the minimal code modifications we had to made to make it work with the embedding environment. (https://github.com/yale-web-technologies/mirador)
  • Yale Extension: this project. It has its own project structure and includes additional JavaScript and styles added on top of "Mirador Core".

Download and Initial Setup

git clone --recursive git@github.com:yale-web-technologies/yale-mirador.git
cd yale-mirador
npm install  # Install node modules for yale-mirador

Bulid

npm run build

It runs webpack for Yale Extension and creates output files in dist/. It also copies the Mirador-y distribution code from node_modules/ to dist/.

Running the Example

npm start

It will open a browser and run the instance there. You can also open http://localhost:3000 manually.

Test

Install karma-cli globally so the karma command becomes available.

npm install -g karma-cli

Run all tests

npm test

Run a single test file

npm test -- -f <test-file>
npm test -- -f test/state-store.test.js  # for example

Deploy

Dependency

See package.json for dependencies – note the version requirements. Notably you should include

The app also depends on jQuery but it is embedded in "IIIF Mirador", which may complicate the asset management.

JavaScript

"Golden Layout" should be included after "Yale Core" and before "Yale Extension" because it depends on jQuery, because "Yale Core" embeds jQuery in itself, and because "Yale Extension" depends on it.

Parameters

Cookies

  • loggedIn: 'true' or 'false'
  • isEditor: 'true' or 'false'

JavaScript

See index.html and config.js to see an example of initiating the app.

About

Yale extension to IIIF Mirador

Resources

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 65.0%
  • CSS 34.8%
  • Other 0.2%