https://wiki.folger.edu/collections-architecture-portal/_mw/api.php?action=feedcontributions&user=StaceyRedick&feedformat=atomMiranda Behind-the-Scenes Portal - User contributions [en]2024-03-28T21:23:15ZUser contributionsMediaWiki 1.39.6https://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Introduction_to_the_platform&diff=270Introduction to the platform2024-03-05T21:10:35Z<p>StaceyRedick: </p>
<hr />
<div><br />
== What is Miranda? ==<br />
<br />
Miranda is a digital asset ''platform,'' a foundation for the Folger's digital collections and one upon which further applications, publications, and initiatives can be built. Miranda's goal is to improve discovery and access in libraries, from making it easier for all users to explore what the Folger has to offer, to improving tools for staff to provide context and information, to increasing efficiency and cost-effectiveness in our digital storage and hosting. <br />
<br />
Miranda is being built to help fill a need in the mid-sized cultural institution space that is currently not well served by existing open or closed source solutions. As "born digital" or "digital native" types of content such as databases, blog posts, mobile applications and the like become more commonplace, the existing systems that libraries and cultural institutions have relied on are either too limited, too expensive, or too inflexible to fit our institution's particular needs. <br />
<br />
Miranda is an open source software system (licensed under the GNU General Public License v3.0) that allows for the storage of arbitrary binary files and assets and their associated metadata and inter-asset relationships. It has been designed to allow for flexible definition of the kinds of assets it stores, flexible binary file asset storage, enterprise class search, and is built from the ground up to leverage APIs. The DAP has an import component for rapidly ingesting data, an indexing service to manage what metadata is made available for public search, a GraphQL API for asset consumption, and a microservice to publicize configured asset types and their validation schemas. <br />
<br />
This project is made possible through the generous support of the [https://www.mellon.org Andrew W. Mellon Foundation]. Miranda's platform has been designed and built by the [https://parsonstko.com/ ParsonsTKO] firm in partnership with the Folger; the WordPress multisite installation has been built by [https://sitesbycoop.com/ Sites by Coop]. <br />
<br />
For an overview of the platform, the development process, and the project's ethos for cultural insitutions who may be interested in replicating or modeling the platform for their collections, see the [https://wiki.folger.edu/collections-architecture-portal/File:Miranda_platform_white_paper.pdf Miranda white paper]. <br />
<br />
To see what the digital asset platform looked like and how it worked, watch this [[Media:Quick Miranda Tour.mp4|Miranda Video Tour]] of its unique features. To explore the platform and its capabilities in more detail, watch this longer [[Media:Miranda_Digital_Asset_Platform_Demo_2-15-2024.mp4|Miranda demo]].<br />
<br />
==== How Miranda helps the Folger: ====<br />
<br />
* '''Enhanced remote access''' -- Not everyone can physically travel to the Folger in Washington, DC. Existing tools were designed to facilitate discovery of assets but not as helpful in the consumption of these assets. <br />
* '''Audience expansion''' -- The Folger currently serves an audience of over 2 million people annually, online and in person. However, many audiences could not be easily targeted with library- or institution-specific data formats, data exchange standards, and other types of technical roadblocks of high learning curves. By developing a system utilizing widely adopted, well-documented standards and solutions, the DAP makes it much more likely that new audiences and organizations can and will leverage Folger assets.<br />
* '''International partnerships''' -- As the Folger seeks to develop strong partnerships with similar organizations across the globe it needed a non-proprietary mechanism for connecting with organizations that had chosen different technical infrastructures for managing their own internal assets. In many ways this is the Folger’s own internal use case for audience expansion, and the partnerships will allow the Folger to develop the DAP with real world experience in sharing, connecting, and juxtaposing their assets with other organizations’ holdings.<br />
* '''Digital Acquisition and Basic Preservation''' -- While many of the original assets the Folger collected were well understood, and the universe of types of content was fairly static (as it is rare that a new kind of 16th-century manuscript is discovered), the digital world is in flux and new content types come into being regularly. Some recent content types are already no longer being developed. In addition, the Folger is creating new kinds of digital assets out of the physical holdings, such as the Folger Digital Texts archive and surveys of female owners of early modern books.<br />
<br />
== Major platform components ==<br />
<br />
=== Content Importer === <br />
Imports JSON structured content<br />
=== Content Validator === <br />
Validates imported JSON by matching it against an available configured schema.<br />
Allows for a hierarchy of validation schemas to be defined with fallbacks. <br />
=== Content Search === <br />
System allows individual content items to be flagged as “searchable” or not, allowing you to keep internal metadata in the system but not junk up your search results with it. <br />
=== GraphQL API === <br />
System allows individual content items to be flagged as “published” or not, allowing you to keep some data in the system as private / draft content.<br />
=== Schema Microservice === <br />
Allows developers to easily see what content types are configured in any particular installation of Miranda and to retrieve the JSON validation schema that is used to test each content type during import.<br />
=== Web Client === <br />
A web client that leverages both elastic search and our GraphQL API.<br />
The client also demonstrates how various system integrations can happen in this client middleware. (For instance using third-party viewers to let web users browse and navigate visual assets in the client.)<br />
<br />
=== Repository (AWS) ===<br />
Our cloud-based storage system <br />
<br />
=== WordPress Plugin ===<br />
Employing the IIIF Universal Viewer, the plugin allows users to insert Miranda items directly with a shortcode (using the alphanumeric Miranda ID string), which displays the digital object and some top-line metadata. See the plugin in action on the [https://stories.folger.edu/rumors-of-royalty/road-to-revolution/ ''Rumors of Royalty''] Stories site.<br />
<br />
== What software and systems is the DAP built with? ==<br />
* PHP 7 - http://php.net/manual/en/<br />
* Symfony 3 - https://symfony.com/doc/current/index.html<br />
* GraphQL - http://graphql.org<br />
* JSON - http://www.json.org<br />
* Postgresql - https://www.postgresql.org<br />
* ElasticSearch - https://www.elastic.co/guide/index.html<br />
* Pattern Lab - http://patternlab.io<br />
* Amazon Web Services - https://aws.amazon.com <br />
* Cantaloupe - https://medusa-project.github.io/cantaloupe/</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=File:Miranda_Digital_Asset_Platform_Demo_2-15-2024.mp4&diff=269File:Miranda Digital Asset Platform Demo 2-15-2024.mp42024-03-05T21:07:54Z<p>StaceyRedick: </p>
<hr />
<div>A longer demo of the Miranda Digital Asset Platform.</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Introduction_to_the_platform&diff=268Introduction to the platform2024-03-04T22:12:57Z<p>StaceyRedick: </p>
<hr />
<div><br />
== What is Miranda? ==<br />
<br />
Miranda is a digital asset ''platform,'' a foundation for the Folger's digital collections and one upon which further applications, publications, and initiatives can be built. Miranda's goal is to improve discovery and access in libraries, from making it easier for all users to explore what the Folger has to offer, to improving tools for staff to provide context and information, to increasing efficiency and cost-effectiveness in our digital storage and hosting. <br />
<br />
Miranda is being built to help fill a need in the mid-sized cultural institution space that is currently not well served by existing open or closed source solutions. As "born digital" or "digital native" types of content such as databases, blog posts, mobile applications and the like become more commonplace, the existing systems that libraries and cultural institutions have relied on are either too limited, too expensive, or too inflexible to fit our institution's particular needs. <br />
<br />
Miranda is an open source software system (licensed under the GNU General Public License v3.0) that allows for the storage of arbitrary binary files and assets and their associated metadata and inter-asset relationships. It has been designed to allow for flexible definition of the kinds of assets it stores, flexible binary file asset storage, enterprise class search, and is built from the ground up to leverage APIs. The DAP has an import component for rapidly ingesting data, an indexing service to manage what metadata is made available for public search, a GraphQL API for asset consumption, and a microservice to publicize configured asset types and their validation schemas. <br />
<br />
This project is made possible through the generous support of the [https://www.mellon.org Andrew W. Mellon Foundation]. Miranda's platform has been designed and built by the [https://parsonstko.com/ ParsonsTKO] firm in partnership with the Folger; the WordPress multisite installation has been built by [https://sitesbycoop.com/ Sites by Coop]. <br />
<br />
For an overview of the platform, the development process, and the project's ethos for cultural insitutions who may be interested in replicating or modeling the platform for their collections, see the [https://wiki.folger.edu/collections-architecture-portal/File:Miranda_platform_white_paper.pdf Miranda white paper]. <br />
<br />
To see what the digital asset platform looked like and how it worked, watch this [[Media:Quick Miranda Tour.mp4|Miranda Video Tour]] of its unique features.<br />
<br />
==== How Miranda helps the Folger: ====<br />
<br />
* '''Enhanced remote access''' -- Not everyone can physically travel to the Folger in Washington, DC. Existing tools were designed to facilitate discovery of assets but not as helpful in the consumption of these assets. <br />
* '''Audience expansion''' -- The Folger currently serves an audience of over 2 million people annually, online and in person. However, many audiences could not be easily targeted with library- or institution-specific data formats, data exchange standards, and other types of technical roadblocks of high learning curves. By developing a system utilizing widely adopted, well-documented standards and solutions, the DAP makes it much more likely that new audiences and organizations can and will leverage Folger assets.<br />
* '''International partnerships''' -- As the Folger seeks to develop strong partnerships with similar organizations across the globe it needed a non-proprietary mechanism for connecting with organizations that had chosen different technical infrastructures for managing their own internal assets. In many ways this is the Folger’s own internal use case for audience expansion, and the partnerships will allow the Folger to develop the DAP with real world experience in sharing, connecting, and juxtaposing their assets with other organizations’ holdings.<br />
* '''Digital Acquisition and Basic Preservation''' -- While many of the original assets the Folger collected were well understood, and the universe of types of content was fairly static (as it is rare that a new kind of 16th-century manuscript is discovered), the digital world is in flux and new content types come into being regularly. Some recent content types are already no longer being developed. In addition, the Folger is creating new kinds of digital assets out of the physical holdings, such as the Folger Digital Texts archive and surveys of female owners of early modern books.<br />
<br />
== Major platform components ==<br />
<br />
=== Content Importer === <br />
Imports JSON structured content<br />
=== Content Validator === <br />
Validates imported JSON by matching it against an available configured schema.<br />
Allows for a hierarchy of validation schemas to be defined with fallbacks. <br />
=== Content Search === <br />
System allows individual content items to be flagged as “searchable” or not, allowing you to keep internal metadata in the system but not junk up your search results with it. <br />
=== GraphQL API === <br />
System allows individual content items to be flagged as “published” or not, allowing you to keep some data in the system as private / draft content.<br />
=== Schema Microservice === <br />
Allows developers to easily see what content types are configured in any particular installation of Miranda and to retrieve the JSON validation schema that is used to test each content type during import.<br />
=== Web Client === <br />
A web client that leverages both elastic search and our GraphQL API.<br />
The client also demonstrates how various system integrations can happen in this client middleware. (For instance using third-party viewers to let web users browse and navigate visual assets in the client.)<br />
<br />
=== Repository (AWS) ===<br />
Our cloud-based storage system <br />
<br />
=== WordPress Plugin ===<br />
Employing the IIIF Universal Viewer, the plugin allows users to insert Miranda items directly with a shortcode (using the alphanumeric Miranda ID string), which displays the digital object and some top-line metadata. See the plugin in action on the [https://stories.folger.edu/rumors-of-royalty/road-to-revolution/ ''Rumors of Royalty''] Stories site.<br />
<br />
== What software and systems is the DAP built with? ==<br />
* PHP 7 - http://php.net/manual/en/<br />
* Symfony 3 - https://symfony.com/doc/current/index.html<br />
* GraphQL - http://graphql.org<br />
* JSON - http://www.json.org<br />
* Postgresql - https://www.postgresql.org<br />
* ElasticSearch - https://www.elastic.co/guide/index.html<br />
* Pattern Lab - http://patternlab.io<br />
* Amazon Web Services - https://aws.amazon.com <br />
* Cantaloupe - https://medusa-project.github.io/cantaloupe/</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Introduction_to_the_platform&diff=267Introduction to the platform2024-03-04T22:12:12Z<p>StaceyRedick: </p>
<hr />
<div><br />
== What is Miranda? ==<br />
<br />
Miranda is a digital asset ''platform,'' a foundation for the Folger's digital collections and one upon which further applications, publications, and initiatives can be built. Miranda's goal is to improve discovery and access in libraries, from making it easier for all users to explore what the Folger has to offer, to improving tools for staff to provide context and information, to increasing efficiency and cost-effectiveness in our digital storage and hosting. <br />
<br />
Miranda is being built to help fill a need in the mid-sized cultural institution space that is currently not well served by existing open or closed source solutions. As "born digital" or "digital native" types of content such as databases, blog posts, mobile applications and the like become more commonplace, the existing systems that libraries and cultural institutions have relied on are either too limited, too expensive, or too inflexible to fit our institution's particular needs. <br />
<br />
Miranda is an open source software system (licensed under the GNU General Public License v3.0) that allows for the storage of arbitrary binary files and assets and their associated metadata and inter-asset relationships. It has been designed to allow for flexible definition of the kinds of assets it stores, flexible binary file asset storage, enterprise class search, and is built from the ground up to leverage APIs. The DAP has an import component for rapidly ingesting data, an indexing service to manage what metadata is made available for public search, a GraphQL API for asset consumption, and a microservice to publicize configured asset types and their validation schemas. <br />
<br />
This project is made possible through the generous support of the [https://www.mellon.org Andrew W. Mellon Foundation]. Miranda's platform has been designed and built by the [https://parsonstko.com/ ParsonsTKO] firm in partnership with the Folger; the WordPress multisite installation has been built by [https://sitesbycoop.com/ Sites by Coop]. <br />
<br />
For an overview of the platform, the development process, and the project's ethos for cultural insitutions who may be interested in replicating or modeling the platform for their collections, see the [https://wiki.folger.edu/collections-architecture-portal/File:Miranda_platform_white_paper.pdf Miranda white paper]. <br />
<br />
To see what Miranda looked like and how it worked, watch this [[Media:Quick Miranda Tour.mp4|Miranda Video Tour]] of the digital asset platform's unique features.<br />
<br />
==== How Miranda helps the Folger: ====<br />
<br />
* '''Enhanced remote access''' -- Not everyone can physically travel to the Folger in Washington, DC. Existing tools were designed to facilitate discovery of assets but not as helpful in the consumption of these assets. <br />
* '''Audience expansion''' -- The Folger currently serves an audience of over 2 million people annually, online and in person. However, many audiences could not be easily targeted with library- or institution-specific data formats, data exchange standards, and other types of technical roadblocks of high learning curves. By developing a system utilizing widely adopted, well-documented standards and solutions, the DAP makes it much more likely that new audiences and organizations can and will leverage Folger assets.<br />
* '''International partnerships''' -- As the Folger seeks to develop strong partnerships with similar organizations across the globe it needed a non-proprietary mechanism for connecting with organizations that had chosen different technical infrastructures for managing their own internal assets. In many ways this is the Folger’s own internal use case for audience expansion, and the partnerships will allow the Folger to develop the DAP with real world experience in sharing, connecting, and juxtaposing their assets with other organizations’ holdings.<br />
* '''Digital Acquisition and Basic Preservation''' -- While many of the original assets the Folger collected were well understood, and the universe of types of content was fairly static (as it is rare that a new kind of 16th-century manuscript is discovered), the digital world is in flux and new content types come into being regularly. Some recent content types are already no longer being developed. In addition, the Folger is creating new kinds of digital assets out of the physical holdings, such as the Folger Digital Texts archive and surveys of female owners of early modern books.<br />
<br />
== Major platform components ==<br />
<br />
=== Content Importer === <br />
Imports JSON structured content<br />
=== Content Validator === <br />
Validates imported JSON by matching it against an available configured schema.<br />
Allows for a hierarchy of validation schemas to be defined with fallbacks. <br />
=== Content Search === <br />
System allows individual content items to be flagged as “searchable” or not, allowing you to keep internal metadata in the system but not junk up your search results with it. <br />
=== GraphQL API === <br />
System allows individual content items to be flagged as “published” or not, allowing you to keep some data in the system as private / draft content.<br />
=== Schema Microservice === <br />
Allows developers to easily see what content types are configured in any particular installation of Miranda and to retrieve the JSON validation schema that is used to test each content type during import.<br />
=== Web Client === <br />
A web client that leverages both elastic search and our GraphQL API.<br />
The client also demonstrates how various system integrations can happen in this client middleware. (For instance using third-party viewers to let web users browse and navigate visual assets in the client.)<br />
<br />
=== Repository (AWS) ===<br />
Our cloud-based storage system <br />
<br />
=== WordPress Plugin ===<br />
Employing the IIIF Universal Viewer, the plugin allows users to insert Miranda items directly with a shortcode (using the alphanumeric Miranda ID string), which displays the digital object and some top-line metadata. See the plugin in action on the [https://stories.folger.edu/rumors-of-royalty/road-to-revolution/ ''Rumors of Royalty''] Stories site.<br />
<br />
== What software and systems is the DAP built with? ==<br />
* PHP 7 - http://php.net/manual/en/<br />
* Symfony 3 - https://symfony.com/doc/current/index.html<br />
* GraphQL - http://graphql.org<br />
* JSON - http://www.json.org<br />
* Postgresql - https://www.postgresql.org<br />
* ElasticSearch - https://www.elastic.co/guide/index.html<br />
* Pattern Lab - http://patternlab.io<br />
* Amazon Web Services - https://aws.amazon.com <br />
* Cantaloupe - https://medusa-project.github.io/cantaloupe/</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Introduction_to_the_platform&diff=266Introduction to the platform2024-03-04T22:10:22Z<p>StaceyRedick: </p>
<hr />
<div><br />
== What is Miranda? ==<br />
<br />
Miranda is a digital asset ''platform,'' a foundation for the Folger's digital collections and one upon which further applications, publications, and initiatives can be built. Miranda's goal is to improve discovery and access in libraries, from making it easier for all users to explore what the Folger has to offer, to improving tools for staff to provide context and information, to increasing efficiency and cost-effectiveness in our digital storage and hosting. <br />
<br />
Miranda is being built to help fill a need in the mid-sized cultural institution space that is currently not well served by existing open or closed source solutions. As "born digital" or "digital native" types of content such as databases, blog posts, mobile applications and the like become more commonplace, the existing systems that libraries and cultural institutions have relied on are either too limited, too expensive, or too inflexible to fit our institution's particular needs. <br />
<br />
Miranda is an open source software system (licensed under the GNU General Public License v3.0) that allows for the storage of arbitrary binary files and assets and their associated metadata and inter-asset relationships. It has been designed to allow for flexible definition of the kinds of assets it stores, flexible binary file asset storage, enterprise class search, and is built from the ground up to leverage APIs. The DAP has an import component for rapidly ingesting data, an indexing service to manage what metadata is made available for public search, a GraphQL API for asset consumption, and a microservice to publicize configured asset types and their validation schemas. <br />
<br />
This project is made possible through the generous support of the [https://www.mellon.org Andrew W. Mellon Foundation]. Miranda's platform has been designed and built by the [https://parsonstko.com/ ParsonsTKO] firm in partnership with the Folger; the WordPress multisite installation has been built by [https://sitesbycoop.com/ Sites by Coop]. <br />
<br />
For an overview of the platform, the development process, and the project's ethos for cultural insitutions who may be interested in replicating or modeling the platform for their collections, see the [https://wiki.folger.edu/collections-architecture-portal/File:Miranda_platform_white_paper.pdf Miranda white paper]. <br />
<br />
For a quick video tour of the Miranda digital asset platform's unique features, watch this video: [[Media:Quick Miranda Tour.mp4|Quick Miranda Tour]]<br />
<br />
==== How Miranda helps the Folger: ====<br />
<br />
* '''Enhanced remote access''' -- Not everyone can physically travel to the Folger in Washington, DC. Existing tools were designed to facilitate discovery of assets but not as helpful in the consumption of these assets. <br />
* '''Audience expansion''' -- The Folger currently serves an audience of over 2 million people annually, online and in person. However, many audiences could not be easily targeted with library- or institution-specific data formats, data exchange standards, and other types of technical roadblocks of high learning curves. By developing a system utilizing widely adopted, well-documented standards and solutions, the DAP makes it much more likely that new audiences and organizations can and will leverage Folger assets.<br />
* '''International partnerships''' -- As the Folger seeks to develop strong partnerships with similar organizations across the globe it needed a non-proprietary mechanism for connecting with organizations that had chosen different technical infrastructures for managing their own internal assets. In many ways this is the Folger’s own internal use case for audience expansion, and the partnerships will allow the Folger to develop the DAP with real world experience in sharing, connecting, and juxtaposing their assets with other organizations’ holdings.<br />
* '''Digital Acquisition and Basic Preservation''' -- While many of the original assets the Folger collected were well understood, and the universe of types of content was fairly static (as it is rare that a new kind of 16th-century manuscript is discovered), the digital world is in flux and new content types come into being regularly. Some recent content types are already no longer being developed. In addition, the Folger is creating new kinds of digital assets out of the physical holdings, such as the Folger Digital Texts archive and surveys of female owners of early modern books.<br />
<br />
== Major platform components ==<br />
<br />
=== Content Importer === <br />
Imports JSON structured content<br />
=== Content Validator === <br />
Validates imported JSON by matching it against an available configured schema.<br />
Allows for a hierarchy of validation schemas to be defined with fallbacks. <br />
=== Content Search === <br />
System allows individual content items to be flagged as “searchable” or not, allowing you to keep internal metadata in the system but not junk up your search results with it. <br />
=== GraphQL API === <br />
System allows individual content items to be flagged as “published” or not, allowing you to keep some data in the system as private / draft content.<br />
=== Schema Microservice === <br />
Allows developers to easily see what content types are configured in any particular installation of Miranda and to retrieve the JSON validation schema that is used to test each content type during import.<br />
=== Web Client === <br />
A web client that leverages both elastic search and our GraphQL API.<br />
The client also demonstrates how various system integrations can happen in this client middleware. (For instance using third-party viewers to let web users browse and navigate visual assets in the client.)<br />
<br />
=== Repository (AWS) ===<br />
Our cloud-based storage system <br />
<br />
=== WordPress Plugin ===<br />
Employing the IIIF Universal Viewer, the plugin allows users to insert Miranda items directly with a shortcode (using the alphanumeric Miranda ID string), which displays the digital object and some top-line metadata. See the plugin in action on the [https://stories.folger.edu/rumors-of-royalty/road-to-revolution/ ''Rumors of Royalty''] Stories site.<br />
<br />
== What software and systems is the DAP built with? ==<br />
* PHP 7 - http://php.net/manual/en/<br />
* Symfony 3 - https://symfony.com/doc/current/index.html<br />
* GraphQL - http://graphql.org<br />
* JSON - http://www.json.org<br />
* Postgresql - https://www.postgresql.org<br />
* ElasticSearch - https://www.elastic.co/guide/index.html<br />
* Pattern Lab - http://patternlab.io<br />
* Amazon Web Services - https://aws.amazon.com <br />
* Cantaloupe - https://medusa-project.github.io/cantaloupe/</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Introduction_to_the_platform&diff=265Introduction to the platform2024-03-04T22:09:25Z<p>StaceyRedick: </p>
<hr />
<div><br />
== What is Miranda? ==<br />
<br />
Miranda is a digital asset ''platform,'' a foundation for the Folger's digital collections and one upon which further applications, publications, and initiatives can be built. Miranda's goal is to improve discovery and access in libraries, from making it easier for all users to explore what the Folger has to offer, to improving tools for staff to provide context and information, to increasing efficiency and cost-effectiveness in our digital storage and hosting. <br />
<br />
Miranda is being built to help fill a need in the mid-sized cultural institution space that is currently not well served by existing open or closed source solutions. As "born digital" or "digital native" types of content such as databases, blog posts, mobile applications and the like become more commonplace, the existing systems that libraries and cultural institutions have relied on are either too limited, too expensive, or too inflexible to fit our institution's particular needs. <br />
<br />
Miranda is an open source software system (licensed under the GNU General Public License v3.0) that allows for the storage of arbitrary binary files and assets and their associated metadata and inter-asset relationships. It has been designed to allow for flexible definition of the kinds of assets it stores, flexible binary file asset storage, enterprise class search, and is built from the ground up to leverage APIs. The DAP has an import component for rapidly ingesting data, an indexing service to manage what metadata is made available for public search, a GraphQL API for asset consumption, and a microservice to publicize configured asset types and their validation schemas. <br />
<br />
This project is made possible through the generous support of the [https://www.mellon.org Andrew W. Mellon Foundation]. Miranda's platform has been designed and built by the [https://parsonstko.com/ ParsonsTKO] firm in partnership with the Folger; the WordPress multisite installation has been built by [https://sitesbycoop.com/ Sites by Coop]. <br />
<br />
For an overview of the platform, the development process, and the project's ethos for cultural insitutions who may be interested in replicating or modeling the platform for their collections, see the [https://wiki.folger.edu/collections-architecture-portal/File:Miranda_platform_white_paper.pdf Miranda white paper]. <br />
<br />
For a quick video tour of the Miranda digital asset platform's unique features, watch this video: [[Media:Quick Miranda Tour.mp4|Quick Miranda Tour.mp4]]<br />
<br />
==== How Miranda helps the Folger: ====<br />
<br />
* '''Enhanced remote access''' -- Not everyone can physically travel to the Folger in Washington, DC. Existing tools were designed to facilitate discovery of assets but not as helpful in the consumption of these assets. <br />
* '''Audience expansion''' -- The Folger currently serves an audience of over 2 million people annually, online and in person. However, many audiences could not be easily targeted with library- or institution-specific data formats, data exchange standards, and other types of technical roadblocks of high learning curves. By developing a system utilizing widely adopted, well-documented standards and solutions, the DAP makes it much more likely that new audiences and organizations can and will leverage Folger assets.<br />
* '''International partnerships''' -- As the Folger seeks to develop strong partnerships with similar organizations across the globe it needed a non-proprietary mechanism for connecting with organizations that had chosen different technical infrastructures for managing their own internal assets. In many ways this is the Folger’s own internal use case for audience expansion, and the partnerships will allow the Folger to develop the DAP with real world experience in sharing, connecting, and juxtaposing their assets with other organizations’ holdings.<br />
* '''Digital Acquisition and Basic Preservation''' -- While many of the original assets the Folger collected were well understood, and the universe of types of content was fairly static (as it is rare that a new kind of 16th-century manuscript is discovered), the digital world is in flux and new content types come into being regularly. Some recent content types are already no longer being developed. In addition, the Folger is creating new kinds of digital assets out of the physical holdings, such as the Folger Digital Texts archive and surveys of female owners of early modern books.<br />
<br />
== Major platform components ==<br />
<br />
=== Content Importer === <br />
Imports JSON structured content<br />
=== Content Validator === <br />
Validates imported JSON by matching it against an available configured schema.<br />
Allows for a hierarchy of validation schemas to be defined with fallbacks. <br />
=== Content Search === <br />
System allows individual content items to be flagged as “searchable” or not, allowing you to keep internal metadata in the system but not junk up your search results with it. <br />
=== GraphQL API === <br />
System allows individual content items to be flagged as “published” or not, allowing you to keep some data in the system as private / draft content.<br />
=== Schema Microservice === <br />
Allows developers to easily see what content types are configured in any particular installation of Miranda and to retrieve the JSON validation schema that is used to test each content type during import.<br />
=== Web Client === <br />
A web client that leverages both elastic search and our GraphQL API.<br />
The client also demonstrates how various system integrations can happen in this client middleware. (For instance using third-party viewers to let web users browse and navigate visual assets in the client.)<br />
<br />
=== Repository (AWS) ===<br />
Our cloud-based storage system <br />
<br />
=== WordPress Plugin ===<br />
Employing the IIIF Universal Viewer, the plugin allows users to insert Miranda items directly with a shortcode (using the alphanumeric Miranda ID string), which displays the digital object and some top-line metadata. See the plugin in action on the [https://stories.folger.edu/rumors-of-royalty/road-to-revolution/ ''Rumors of Royalty''] Stories site.<br />
<br />
== What software and systems is the DAP built with? ==<br />
* PHP 7 - http://php.net/manual/en/<br />
* Symfony 3 - https://symfony.com/doc/current/index.html<br />
* GraphQL - http://graphql.org<br />
* JSON - http://www.json.org<br />
* Postgresql - https://www.postgresql.org<br />
* ElasticSearch - https://www.elastic.co/guide/index.html<br />
* Pattern Lab - http://patternlab.io<br />
* Amazon Web Services - https://aws.amazon.com <br />
* Cantaloupe - https://medusa-project.github.io/cantaloupe/</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Introduction_to_the_platform&diff=264Introduction to the platform2024-03-04T22:08:30Z<p>StaceyRedick: </p>
<hr />
<div><br />
== What is Miranda? ==<br />
<br />
Miranda is a digital asset ''platform,'' a foundation for the Folger's digital collections and one upon which further applications, publications, and initiatives can be built. Miranda's goal is to improve discovery and access in libraries, from making it easier for all users to explore what the Folger has to offer, to improving tools for staff to provide context and information, to increasing efficiency and cost-effectiveness in our digital storage and hosting. <br />
<br />
Miranda is being built to help fill a need in the mid-sized cultural institution space that is currently not well served by existing open or closed source solutions. As "born digital" or "digital native" types of content such as databases, blog posts, mobile applications and the like become more commonplace, the existing systems that libraries and cultural institutions have relied on are either too limited, too expensive, or too inflexible to fit our institution's particular needs. <br />
<br />
Miranda is an open source software system (licensed under the GNU General Public License v3.0) that allows for the storage of arbitrary binary files and assets and their associated metadata and inter-asset relationships. It has been designed to allow for flexible definition of the kinds of assets it stores, flexible binary file asset storage, enterprise class search, and is built from the ground up to leverage APIs. The DAP has an import component for rapidly ingesting data, an indexing service to manage what metadata is made available for public search, a GraphQL API for asset consumption, and a microservice to publicize configured asset types and their validation schemas. <br />
<br />
This project is made possible through the generous support of the [https://www.mellon.org Andrew W. Mellon Foundation]. Miranda's platform has been designed and built by the [https://parsonstko.com/ ParsonsTKO] firm in partnership with the Folger; the WordPress multisite installation has been built by [https://sitesbycoop.com/ Sites by Coop]. <br />
<br />
For an overview of the platform, the development process, and the project's ethos for cultural insitutions who may be interested in replicating or modeling the platform for their collections, see the [https://wiki.folger.edu/collections-architecture-portal/File:Miranda_platform_white_paper.pdf Miranda white paper]. <br />
<br />
For a video tour of the Miranda digital asset platform's unique features, watch this video: [[Media:Quick Miranda Tour.mp4]]<br />
<br />
==== How Miranda helps the Folger: ====<br />
<br />
* '''Enhanced remote access''' -- Not everyone can physically travel to the Folger in Washington, DC. Existing tools were designed to facilitate discovery of assets but not as helpful in the consumption of these assets. <br />
* '''Audience expansion''' -- The Folger currently serves an audience of over 2 million people annually, online and in person. However, many audiences could not be easily targeted with library- or institution-specific data formats, data exchange standards, and other types of technical roadblocks of high learning curves. By developing a system utilizing widely adopted, well-documented standards and solutions, the DAP makes it much more likely that new audiences and organizations can and will leverage Folger assets.<br />
* '''International partnerships''' -- As the Folger seeks to develop strong partnerships with similar organizations across the globe it needed a non-proprietary mechanism for connecting with organizations that had chosen different technical infrastructures for managing their own internal assets. In many ways this is the Folger’s own internal use case for audience expansion, and the partnerships will allow the Folger to develop the DAP with real world experience in sharing, connecting, and juxtaposing their assets with other organizations’ holdings.<br />
* '''Digital Acquisition and Basic Preservation''' -- While many of the original assets the Folger collected were well understood, and the universe of types of content was fairly static (as it is rare that a new kind of 16th-century manuscript is discovered), the digital world is in flux and new content types come into being regularly. Some recent content types are already no longer being developed. In addition, the Folger is creating new kinds of digital assets out of the physical holdings, such as the Folger Digital Texts archive and surveys of female owners of early modern books.<br />
<br />
== Major platform components ==<br />
<br />
=== Content Importer === <br />
Imports JSON structured content<br />
=== Content Validator === <br />
Validates imported JSON by matching it against an available configured schema.<br />
Allows for a hierarchy of validation schemas to be defined with fallbacks. <br />
=== Content Search === <br />
System allows individual content items to be flagged as “searchable” or not, allowing you to keep internal metadata in the system but not junk up your search results with it. <br />
=== GraphQL API === <br />
System allows individual content items to be flagged as “published” or not, allowing you to keep some data in the system as private / draft content.<br />
=== Schema Microservice === <br />
Allows developers to easily see what content types are configured in any particular installation of Miranda and to retrieve the JSON validation schema that is used to test each content type during import.<br />
=== Web Client === <br />
A web client that leverages both elastic search and our GraphQL API.<br />
The client also demonstrates how various system integrations can happen in this client middleware. (For instance using third-party viewers to let web users browse and navigate visual assets in the client.)<br />
<br />
=== Repository (AWS) ===<br />
Our cloud-based storage system <br />
<br />
=== WordPress Plugin ===<br />
Employing the IIIF Universal Viewer, the plugin allows users to insert Miranda items directly with a shortcode (using the alphanumeric Miranda ID string), which displays the digital object and some top-line metadata. See the plugin in action on the [https://stories.folger.edu/rumors-of-royalty/road-to-revolution/ ''Rumors of Royalty''] Stories site.<br />
<br />
== What software and systems is the DAP built with? ==<br />
* PHP 7 - http://php.net/manual/en/<br />
* Symfony 3 - https://symfony.com/doc/current/index.html<br />
* GraphQL - http://graphql.org<br />
* JSON - http://www.json.org<br />
* Postgresql - https://www.postgresql.org<br />
* ElasticSearch - https://www.elastic.co/guide/index.html<br />
* Pattern Lab - http://patternlab.io<br />
* Amazon Web Services - https://aws.amazon.com <br />
* Cantaloupe - https://medusa-project.github.io/cantaloupe/</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Introduction_to_the_platform&diff=263Introduction to the platform2024-03-04T21:53:00Z<p>StaceyRedick: /* What is Miranda? */</p>
<hr />
<div><br />
== What is Miranda? ==<br />
<br />
Miranda is a digital asset ''platform,'' a foundation for the Folger's digital collections and one upon which further applications, publications, and initiatives can be built. Miranda's goal is to improve discovery and access in libraries, from making it easier for all users to explore what the Folger has to offer, to improving tools for staff to provide context and information, to increasing efficiency and cost-effectiveness in our digital storage and hosting. <br />
<br />
Miranda is being built to help fill a need in the mid-sized cultural institution space that is currently not well served by existing open or closed source solutions. As "born digital" or "digital native" types of content such as databases, blog posts, mobile applications and the like become more commonplace, the existing systems that libraries and cultural institutions have relied on are either too limited, too expensive, or too inflexible to fit our institution's particular needs. <br />
<br />
Miranda is an open source software system (licensed under the GNU General Public License v3.0) that allows for the storage of arbitrary binary files and assets and their associated metadata and inter-asset relationships. It has been designed to allow for flexible definition of the kinds of assets it stores, flexible binary file asset storage, enterprise class search, and is built from the ground up to leverage APIs. The DAP has an import component for rapidly ingesting data, an indexing service to manage what metadata is made available for public search, a GraphQL API for asset consumption, and a microservice to publicize configured asset types and their validation schemas. <br />
<br />
This project is made possible through the generous support of the [https://www.mellon.org Andrew W. Mellon Foundation]. Miranda's platform has been designed and built by the [https://parsonstko.com/ ParsonsTKO] firm in partnership with the Folger; the WordPress multisite installation has been built by [https://sitesbycoop.com/ Sites by Coop]. <br />
<br />
For an overview of the platform, the development process, and the project's ethos for cultural insitutions who may be interested in replicating or modeling the platform for their collections, see the [https://wiki.folger.edu/collections-architecture-portal/File:Miranda_platform_white_paper.pdf Miranda white paper]. <br />
<br />
For a video tour of the Miranda digital asset platform's unique features, watch this video: [[File:Quick Miranda Tour.mp4|center|thumb|A quick tour of the Miranda digital asset platform.]]<br />
<br />
==== How Miranda helps the Folger: ====<br />
<br />
* '''Enhanced remote access''' -- Not everyone can physically travel to the Folger in Washington, DC. Existing tools were designed to facilitate discovery of assets but not as helpful in the consumption of these assets. <br />
* '''Audience expansion''' -- The Folger currently serves an audience of over 2 million people annually, online and in person. However, many audiences could not be easily targeted with library- or institution-specific data formats, data exchange standards, and other types of technical roadblocks of high learning curves. By developing a system utilizing widely adopted, well-documented standards and solutions, the DAP makes it much more likely that new audiences and organizations can and will leverage Folger assets.<br />
* '''International partnerships''' -- As the Folger seeks to develop strong partnerships with similar organizations across the globe it needed a non-proprietary mechanism for connecting with organizations that had chosen different technical infrastructures for managing their own internal assets. In many ways this is the Folger’s own internal use case for audience expansion, and the partnerships will allow the Folger to develop the DAP with real world experience in sharing, connecting, and juxtaposing their assets with other organizations’ holdings.<br />
* '''Digital Acquisition and Basic Preservation''' -- While many of the original assets the Folger collected were well understood, and the universe of types of content was fairly static (as it is rare that a new kind of 16th-century manuscript is discovered), the digital world is in flux and new content types come into being regularly. Some recent content types are already no longer being developed. In addition, the Folger is creating new kinds of digital assets out of the physical holdings, such as the Folger Digital Texts archive and surveys of female owners of early modern books.<br />
<br />
== Major platform components ==<br />
<br />
=== Content Importer === <br />
Imports JSON structured content<br />
=== Content Validator === <br />
Validates imported JSON by matching it against an available configured schema.<br />
Allows for a hierarchy of validation schemas to be defined with fallbacks. <br />
=== Content Search === <br />
System allows individual content items to be flagged as “searchable” or not, allowing you to keep internal metadata in the system but not junk up your search results with it. <br />
=== GraphQL API === <br />
System allows individual content items to be flagged as “published” or not, allowing you to keep some data in the system as private / draft content.<br />
=== Schema Microservice === <br />
Allows developers to easily see what content types are configured in any particular installation of Miranda and to retrieve the JSON validation schema that is used to test each content type during import.<br />
=== Web Client === <br />
A web client that leverages both elastic search and our GraphQL API.<br />
The client also demonstrates how various system integrations can happen in this client middleware. (For instance using third-party viewers to let web users browse and navigate visual assets in the client.)<br />
<br />
=== Repository (AWS) ===<br />
Our cloud-based storage system <br />
<br />
=== WordPress Plugin ===<br />
Employing the IIIF Universal Viewer, the plugin allows users to insert Miranda items directly with a shortcode (using the alphanumeric Miranda ID string), which displays the digital object and some top-line metadata. See the plugin in action on the [https://stories.folger.edu/rumors-of-royalty/road-to-revolution/ ''Rumors of Royalty''] Stories site.<br />
<br />
== What software and systems is the DAP built with? ==<br />
* PHP 7 - http://php.net/manual/en/<br />
* Symfony 3 - https://symfony.com/doc/current/index.html<br />
* GraphQL - http://graphql.org<br />
* JSON - http://www.json.org<br />
* Postgresql - https://www.postgresql.org<br />
* ElasticSearch - https://www.elastic.co/guide/index.html<br />
* Pattern Lab - http://patternlab.io<br />
* Amazon Web Services - https://aws.amazon.com <br />
* Cantaloupe - https://medusa-project.github.io/cantaloupe/</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=File:Quick_Miranda_Tour.mp4&diff=262File:Quick Miranda Tour.mp42024-03-04T21:05:21Z<p>StaceyRedick: </p>
<hr />
<div>This video briefly demonstrates the unique features of the Miranda Digital Asset Platform.</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Main_Page&diff=261Main Page2024-03-04T20:59:15Z<p>StaceyRedick: /* Notice: Miranda retirement */</p>
<hr />
<div>__NOTOC__<br />
Welcome to the <strong>Behind-the-Scenes Portal </strong>for the Miranda Digital Asset Platform<strong>.</strong> <br />
<br />
=Miranda retirement=<br />
<br />
'''''The Miranda platform has been retired. To explore and download Folger collection images and media, visit our new [https://digitalcollections.folger.edu/ digital collections] site.''''' <br />
<br />
Last July we shared that Miranda, our digital asset platform, would be retired. Web-based technology is always evolving, and the expectations of users change alongside the technology. We want to meet the expectations of scholars and researchers as well as provide streamlined access for the curious web user. <br />
<br />
In February 2024, we introduced a new digital collections tool that will better enable us to meet the needs of the Folger’s research community and, combined with the Folger’s recently redesigned main website, provide more entry points for all audiences. You can read more about how to use the Folger’s new digital collections site on this blog post.<br />
<br />
If you have any questions about where to locate a resource or how to retrieve MyShelf data you had stored in Miranda, please reach out to miranda@folger.edu. Information about the project and the platform code repository will remain available here on the Miranda Behind-the-Scenes Wiki through the next two years.<br />
<br />
==Where you can find Folger resources==<br />
<br />
An[[Introduction to the platform| introduction to the Miranda platform]] shares specific information about the platform components and the project goal. <br />
<br />
For digital collection images and media, visit the [https://digitalcollections.folger.edu Folger's Digital Collections] website. <br />
<br />
The [https://catalog.folger.edu/ Folger's library catalog] has bibliographic data and collections materials information. <br />
<br />
The Folger’s [https://www.folger.edu/podcasts/shakespeare-unlimited/ Shakespeare Unlimited podcasts] are available on the Folger’s website.<br />
<br />
The Folger’s [https://findingaids.folger.edu/ Finding Aids database] shares information about our manuscript collections and institutional archives. <br />
<br />
Miranda [https://stories.folger.edu/ Stories websites] feature items from our collection and the collections of global institutional partners. <br />
<br />
More [https://folger.edu/research/online-resources/ online resources] offered by the Folger can be found on the Folger’s website. <br />
<br />
Contact miranda@folger.edu if you have any questions or are looking for other resources not listed above. <br />
<br />
==Where you can find Miranda information and code==<br />
<br />
This portal documents the human and technical development processes that made the Miranda project possible. The Miranda prototype was made public in fall 2017, with an alpha release in May 2018 and a beta launch in January 2019. The grant period concluded at the end of February 2020, and the platform will be retired in fall 2023. <br />
<br />
This portal contains information about what is currently available on the Miranda platform and outlines some of the work completed throughout the project. For technical (and technical-leaning) folks, there is also information on [[Technical Architecture| how the platform itself works,]] how to interact with the platform's [[The Miranda API| APIs]], and the platform's [[Data model| data model.]] <br />
<br />
The code repository for Miranda as well as the 2017 Miranda prototype is [https://github.com/parsonstko/ available on Github] under the MIT License. <br />
<br />
Our technical partners for this project were ParsonsTKO and Aplyca Technologia. The Miranda project was made possible with generous support from the Andrew W. Mellon Foundation. <br />
<br />
==Table of contents==<br />
* [[Introduction to the platform]]<br />
* [[What's in Miranda: Content Types|Platform contents]]<br />
* [[International Image Interoperability Framework|International Image Interoperability Framework (IIIF)]]<br />
* [[My Shelf]]<br />
* [[Topics and Stories]]<br />
* [[Taxonomies]]<br />
* [[Data model]]<br />
* [[The Miranda API]]<br />
* [[Advanced search]]<br />
* [[Technical Architecture]]<br />
* [[Licensing Agreements]]<br />
* [[Team]]<br />
* [[Advisory committee]]</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Main_Page&diff=260Main Page2024-02-28T15:43:40Z<p>StaceyRedick: /* Where you can find Folger resources */ Rearranged the links list.</p>
<hr />
<div>__NOTOC__<br />
Welcome to the <strong>Behind-the-Scenes Portal </strong>for the Miranda Digital Asset Platform<strong>.</strong> To explore Miranda, visit '''[https://collections.folger.edu collections.folger.edu]'''. <br />
<br />
=Notice: Miranda retirement=<br />
<br />
Miranda will be retired in March 2024. While information about the project and the platform code repository will remain available after retirement, the platform itself will no longer be publicly available. <br />
<br />
==What this means for you==<br />
<br />
Before March 2024, you can still: <br />
<br />
*download material in your MyShelf account. [[Download MyShelf data|See this link for download instructions.]] <br />
*redirect Miranda links to other Folger resources. <br />
<br />
This page will be updated with further information about retirement deadlines and additional resources. Please direct questions about Miranda's retirement to miranda@folger.edu. <br />
<br />
==Where you can find Folger resources==<br />
<br />
An[[Introduction to the platform| introduction to the Miranda platform]] shares specific information about the platform components and the project goal. <br />
<br />
For digital collection images and media, visit the [https://digitalcollections.folger.edu Folger's Digital Collections] website. <br />
<br />
The [https://catalog.folger.edu/ Folger's library catalog] has bibliographic data and collections materials information. <br />
<br />
The Folger’s [https://www.folger.edu/podcasts/shakespeare-unlimited/ Shakespeare Unlimited podcasts] are available on the Folger’s website.<br />
<br />
The Folger’s [https://findingaids.folger.edu/ Finding Aids database] shares information about our manuscript collections and institutional archives. <br />
<br />
Miranda [https://stories.folger.edu/ Stories websites] feature items from our collection and the collections of global institutional partners. <br />
<br />
More [https://folger.edu/research/online-resources/ online resources] offered by the Folger can be found on the Folger’s website. <br />
<br />
Contact miranda@folger.edu if you have any questions or are looking for other resources not listed above. <br />
<br />
==Where you can find Miranda information and code==<br />
<br />
This portal documents the human and technical development processes that made the Miranda project possible. The Miranda prototype was made public in fall 2017, with an alpha release in May 2018 and a beta launch in January 2019. The grant period concluded at the end of February 2020, and the platform will be retired in fall 2023. <br />
<br />
This portal contains information about what is currently available on the Miranda platform and outlines some of the work completed throughout the project. For technical (and technical-leaning) folks, there is also information on [[Technical Architecture| how the platform itself works,]] how to interact with the platform's [[The Miranda API| APIs]], and the platform's [[Data model| data model.]] <br />
<br />
The code repository for Miranda as well as the 2017 Miranda prototype is [https://github.com/parsonstko/ available on Github] under the MIT License. <br />
<br />
Our technical partners for this project were ParsonsTKO and Aplyca Technologia. The Miranda project was made possible with generous support from the Andrew W. Mellon Foundation. <br />
<br />
==Table of contents==<br />
* [[Introduction to the platform]]<br />
* [[What's in Miranda: Content Types|Platform contents]]<br />
* [[International Image Interoperability Framework|International Image Interoperability Framework (IIIF)]]<br />
* [[My Shelf]]<br />
* [[Topics and Stories]]<br />
* [[Taxonomies]]<br />
* [[Data model]]<br />
* [[The Miranda API]]<br />
* [[Advanced search]]<br />
* [[Technical Architecture]]<br />
* [[Licensing Agreements]]<br />
* [[Team]]<br />
* [[Advisory committee]]</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Main_Page&diff=259Main Page2024-02-28T15:41:34Z<p>StaceyRedick: /* Where you can find Folger resources */ Changed Luna to Digital Collections</p>
<hr />
<div>__NOTOC__<br />
Welcome to the <strong>Behind-the-Scenes Portal </strong>for the Miranda Digital Asset Platform<strong>.</strong> To explore Miranda, visit '''[https://collections.folger.edu collections.folger.edu]'''. <br />
<br />
=Notice: Miranda retirement=<br />
<br />
Miranda will be retired in March 2024. While information about the project and the platform code repository will remain available after retirement, the platform itself will no longer be publicly available. <br />
<br />
==What this means for you==<br />
<br />
Before March 2024, you can still: <br />
<br />
*download material in your MyShelf account. [[Download MyShelf data|See this link for download instructions.]] <br />
*redirect Miranda links to other Folger resources. <br />
<br />
This page will be updated with further information about retirement deadlines and additional resources. Please direct questions about Miranda's retirement to miranda@folger.edu. <br />
<br />
==Where you can find Folger resources==<br />
<br />
The Folger’s [https://www.folger.edu/podcasts/shakespeare-unlimited/ Shakespeare Unlimited podcasts] are available on the Folger’s website. <br />
<br />
The [https://catalog.folger.edu/ Folger's library catalog] has bibliographic data and collections materials information. <br />
<br />
For digital collection images and media, visit the [https://digitalcollections.folger.edu Folger's Digital Collections] website.<br />
<br />
An [[Introduction to the platform| introduction to the Miranda platform]] shares specific information about the platform components and the project goal. <br />
<br />
The Folger’s [https://findingaids.folger.edu/ Finding Aids database] shares information about our manuscript collections and institutional archives. <br />
<br />
Miranda [https://stories.folger.edu/ Stories websites] feature items from our collection and the collections of global institutional partners. <br />
<br />
More [https://folger.edu/research/online-resources/ online resources] offered by the Folger can be found on the Folger’s website. <br />
<br />
Contact miranda@folger.edu if you have any questions or are looking for other resources not listed above. <br />
<br />
==Where you can find Miranda information and code==<br />
<br />
This portal documents the human and technical development processes that made the Miranda project possible. The Miranda prototype was made public in fall 2017, with an alpha release in May 2018 and a beta launch in January 2019. The grant period concluded at the end of February 2020, and the platform will be retired in fall 2023. <br />
<br />
This portal contains information about what is currently available on the Miranda platform and outlines some of the work completed throughout the project. For technical (and technical-leaning) folks, there is also information on [[Technical Architecture| how the platform itself works,]] how to interact with the platform's [[The Miranda API| APIs]], and the platform's [[Data model| data model.]] <br />
<br />
The code repository for Miranda as well as the 2017 Miranda prototype is [https://github.com/parsonstko/ available on Github] under the MIT License. <br />
<br />
Our technical partners for this project were ParsonsTKO and Aplyca Technologia. The Miranda project was made possible with generous support from the Andrew W. Mellon Foundation. <br />
<br />
==Table of contents==<br />
* [[Introduction to the platform]]<br />
* [[What's in Miranda: Content Types|Platform contents]]<br />
* [[International Image Interoperability Framework|International Image Interoperability Framework (IIIF)]]<br />
* [[My Shelf]]<br />
* [[Topics and Stories]]<br />
* [[Taxonomies]]<br />
* [[Data model]]<br />
* [[The Miranda API]]<br />
* [[Advanced search]]<br />
* [[Technical Architecture]]<br />
* [[Licensing Agreements]]<br />
* [[Team]]<br />
* [[Advisory committee]]</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Main_Page&diff=258Main Page2024-02-28T15:39:11Z<p>StaceyRedick: /* Notice: Miranda retirement */ Date updated to March 2024</p>
<hr />
<div>__NOTOC__<br />
Welcome to the <strong>Behind-the-Scenes Portal </strong>for the Miranda Digital Asset Platform<strong>.</strong> To explore Miranda, visit '''[https://collections.folger.edu collections.folger.edu]'''. <br />
<br />
=Notice: Miranda retirement=<br />
<br />
Miranda will be retired in March 2024. While information about the project and the platform code repository will remain available after retirement, the platform itself will no longer be publicly available. <br />
<br />
==What this means for you==<br />
<br />
Before March 2024, you can still: <br />
<br />
*download material in your MyShelf account. [[Download MyShelf data|See this link for download instructions.]] <br />
*redirect Miranda links to other Folger resources. <br />
<br />
This page will be updated with further information about retirement deadlines and additional resources. Please direct questions about Miranda's retirement to miranda@folger.edu. <br />
<br />
==Where you can find Folger resources==<br />
<br />
The Folger’s [https://www.folger.edu/podcasts/shakespeare-unlimited/ Shakespeare Unlimited podcasts] are available on the Folger’s website. <br />
<br />
The [https://catalog.folger.edu/ Folger's library catalog] has bibliographic data and collections materials information. <br />
<br />
For collection images and media, visit [https://luna.folger.edu/ Luna].<br />
<br />
An [[Introduction to the platform| introduction to the Miranda platform]] shares specific information about the platform components and the project goal. <br />
<br />
The Folger’s [https://findingaids.folger.edu/ Finding Aids database] shares information about our manuscript collections and institutional archives. <br />
<br />
Miranda [https://stories.folger.edu/ Stories websites] feature items from our collection and the collections of global institutional partners. <br />
<br />
More [https://folger.edu/research/online-resources/ online resources] offered by the Folger can be found on the Folger’s website. <br />
<br />
Contact miranda@folger.edu if you have any questions or are looking for other resources not listed above. <br />
<br />
==Where you can find Miranda information and code==<br />
<br />
This portal documents the human and technical development processes that made the Miranda project possible. The Miranda prototype was made public in fall 2017, with an alpha release in May 2018 and a beta launch in January 2019. The grant period concluded at the end of February 2020, and the platform will be retired in fall 2023. <br />
<br />
This portal contains information about what is currently available on the Miranda platform and outlines some of the work completed throughout the project. For technical (and technical-leaning) folks, there is also information on [[Technical Architecture| how the platform itself works,]] how to interact with the platform's [[The Miranda API| APIs]], and the platform's [[Data model| data model.]] <br />
<br />
The code repository for Miranda as well as the 2017 Miranda prototype is [https://github.com/parsonstko/ available on Github] under the MIT License. <br />
<br />
Our technical partners for this project were ParsonsTKO and Aplyca Technologia. The Miranda project was made possible with generous support from the Andrew W. Mellon Foundation. <br />
<br />
==Table of contents==<br />
* [[Introduction to the platform]]<br />
* [[What's in Miranda: Content Types|Platform contents]]<br />
* [[International Image Interoperability Framework|International Image Interoperability Framework (IIIF)]]<br />
* [[My Shelf]]<br />
* [[Topics and Stories]]<br />
* [[Taxonomies]]<br />
* [[Data model]]<br />
* [[The Miranda API]]<br />
* [[Advanced search]]<br />
* [[Technical Architecture]]<br />
* [[Licensing Agreements]]<br />
* [[Team]]<br />
* [[Advisory committee]]</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Taxonomies&diff=161Taxonomies2019-01-11T23:19:41Z<p>StaceyRedick: Added real changes that had already been made to taxonomies. Changes are in italics.</p>
<hr />
<div>Through the Miranda project, we adapted the Folger's current taxonomies to best describe our collections for our users. We came up with [[:File:Taxonomies Draft: Folger Shakespeare Library.xlsx|unified taxonomies]] which we employed in Miranda. We continue to refine and adjust them as the project moves forward. We will make every effort to keep this page up to date, but there may be slight differences between this list and what is available on the Miranda platform. The latest updates and rationale have been included in ''italics.'' <br />
<br />
Below, we have included definitions for our genre and format taxonomy terms.<br />
<br />
'''Genre Taxonomy''' <br />
<br />
Categories in this taxonomy describe the intellectual content of items, as opposed to their format or structure. We are working through places where there are gaps or overlaps in categories with the Format taxonomy. <br />
<br />
* Art: Visual (artistic) materials, including architectural drawings, historical art, landscapes, art related to performances or other events, portraits, and prints and printmaking materials <br />
* Commentary: Treatises or series of comments that explain or annotate another work. <br />
* Communications: Items intended to convey awareness, knowledge, or information to others. Including but not limited to: cards, telegrams, letters. <br />
* Derivative works: Works that are based on one or more pre-existing works, such as a translation, musical arrangement, dramatization, fictionalization, motion picture version, sound recording, art reproduction, abridgment, condensation, or any other form in which a work may be recast, transformed, or adapted. <br />
* Humor: Comical works intended to provoke laughter and provide amusement <br />
* Literary: ''Previously "literary and performing art."'' Works of drama, dance, music, prose, poetry, cinema, television, etc. ''This term was shortened for simplicity while remaining descriptive of the content included in this category.'' <br />
<br />
* ''Music:'' ''This is a new term in the taxonomy.'' ''An artistic composition that combines vocal and/or instrumental sounds to produce an audio piece, which may or may not have been intended for performance.'' <br />
* News: Letters, reports, serials, newsbooks, corantos, or other written communications that communicate news. May be published at stated, frequent, or regular intervals and contain news, articles, editorials, features, advertisements, and/or other items of current interest. This category also includes news clippings: illustrations, pages, articles, or columns of text removed from books, newspapers, journals, or other printed sources and kept for their informational content. <br />
* Official Documents: Records, in law, having the legally recognized and judicially enforceable quality of establishing some fact (from AAT, "official documents"). May be related to financial, legal, government or personal official documents. May include deeds, licenses, legal notices, or official documents of a personal nature <br />
* Performance materials: Documents or materials used in or related to a performance. May be used by performers, or ephemera that results from a performance, intended for audiences. Examples include playbills, prompt books. <br />
* Promotional materials: Printed matter or objects devised to advertise or promote products, causes, or other concerns, especially those items given away to prospective consumers, clients, or contributors. <br />
* Recreational material: ''Previously known as "Realia."'' Physical objects (not books or audio-visual materials) that were produced for use, decoration, or entertainment. ''This term was changed in order to be more descriptive of the contents and purpose of the items that fit into this category.'' <br />
* Reference: Works intended primarily for consultation rather than for continuous reading. <br />
* ''Religious works:'' ''This category is new. Works related to religion, sacred or religious beliefs and practices, including religious texts, sermons, and devotional literature.'' <br />
<br />
<br />
'''Format Taxonomy'''<br />
<br />
These categories describe the original format of an item, not the format of its digital representation. They describe the structure or format of an item, not its intellectual content. We are working through gaps and overlaps in these two taxonomies.<br />
<br />
* Text: a manuscript or printed document, including books and letters. ''WE are currently using the two terms on the second level of the hierarchy: "Manuscript text" and "Printed text."'' <br />
** ''Printed text: a document of any kind created through the process of printing, including books or music scores.'' <br />
** ''Manuscript text: a document of any kind, written entirely by hand. May include books, letters, or official documents.''<br />
* Audio: ''Previously labeled "sound."'' Refers to sound recordings, stored electronically, in any media. May include items such as podcasts or audiobook recordings, or recordings of lectures or performances<br />
* Image: Refers to images, in any medium but usually referring to paintings, drawings, prints, photography, or digital works<br />
* ''Notated Music: A new addition to this taxonomy, indicates visual representation of musical works where components of musical sound are expressed using a system of symbols and/or words. These can be in manuscript, print, or electronic form.''<br />
* Object: ''Previously labeled "3D Object."'' Refers to items that have, or appear to have, the three dimensions of length, width, and height. May include ceramics, human hair, statues, a bust of Shakespeare carved in salt<br />
* Data[set]: a set of data or information that can be interpreted and reinterpreted in quantitative analysis of a subject<br />
* Interactive resource, ''also known as "online resource"'': These are online tools that are characterized by an interaction between the user (interactor) and the tool (resource), in which the interactor performs actions that the computer code of the resource responds to appropriately. Items in this category may include a map with information on specific cities that pops up when clicked, or a chart whose data can be manipulated through menu selections. <br />
* Video: Refers to manifestations of motion pictures, stored electronically, in any media</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Stories_and_Topics&diff=160Stories and Topics2019-01-11T22:41:56Z<p>StaceyRedick: </p>
<hr />
<div>As Miranda develops, we are integrating curated content and multimedia-driven narratives as means of navigating Miranda and the Folger's collections. These are our Topics and Stories sites. <br />
<br />
Both sets of sites are built in a WordPress multi-site environment that has been customized for this purpose, with our partner Sites by Coop. The template is modular, composed of modules for a variety of formats of text blocks and media elements. With the multi-site capabilities, we can make it easier for Folger staff to share knowledge in a technically sustainable and efficient manner, and to ensure we can maintain these sites over time.<br />
<br />
'''Topics'''<br />
[[File:Screen Shot 2019-01-09 at 1.43.23 PM.png|right|frameless]]<br />
Topics briefly introduce readers to an area of the collection, and to items which can spur a user on their quest for information. We begin with an initial set of short Topic pages on popular Shakespeare plays. We will expand the Topic pages beyond Shakespeare's works and into different aspects of the Folger's holdings, common reference questions, and more.<br />
<br />
[[File:Screen Shot 2019-01-09 at 1.44.27 PM.png|left|frameless]]<br />
'''Stories'''<br />
<br />
Stories contain longer narratives that offer a thematic tour of subjects related to the Folger's collection and sometimes with the collections of other cultural institutions. Stories sites can either stand alone or complement physical exhibitions presented on the Folger's campus. <br />
<br />
'''Featured Results'''<br />
<br />
Featured Results promote certain Folger content pages to the top of broad search results. Searches for "king john" or "king john shakespeare," for example, will lead to a first-ranked Featured Result that leads users to the Topic page for Shakespeare's play ''King John''. As we build more Topic pages over time, we aim to expand Featured Results to orient online visitors to information that may be interesting to them.<br />
<br />
'''WordPress Plugin'''<br />
<br />
We are in the process of completing a Miranda WordPress plugin, using the IIIF-produced [https://universalviewer.io/ Universal Viewer]. Once it is installed on WordPress-powered sites, the plugin allows Wordpress site managers to insert digital images from Miranda along with their descriptive metadata using a simple shortcode and the alphanumeric Miranda ID. We will be installing the plugin first on Topics and Stories sites, and then will release it to the public by the time the project concludes.</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Main_Page&diff=147Main Page2019-01-11T22:04:20Z<p>StaceyRedick: </p>
<hr />
<div>Welcome to the <strong>Behind-the-Scenes Portal </strong>for the Miranda Digital Asset Platform<strong>.</strong> This portal documents the human and technical development processes that make the Miranda project possible. The Miranda prototype was made public in fall 2017, with an alpha release in May 2018 and a beta launch in January 2019. We will continue to update the platform throughout 2019 and beyond. <br />
<br />
This portal contains information about what is currently available on the Miranda platform (beta) and outlines some of the work we will be doing in the concluding phase of the project. For technical (and technical-leaning) folks, there is also information on how the platform itself works, how to interact with the platform's APIs, and how data imports are processed. <br />
<br />
All of the platform code will be linked here by the project's conclusion. However, we regret that we cannot provide support for other installations of the platform outside of [http://collections.folger.edu the official site]. The code repository for the 2017 Miranda [https://github.com/ParsonsTKO/FolgerMirandaClient prototype client] and the [https://github.com/ParsonsTKO/FolgerMirandaServer prototype server] is hosted on Github. Our primary technical partner is [https://parsonstko.com ParsonsTKO]. The Miranda project is made possible with generous support from the [https://www.mellon.org Andrew W. Mellon Foundation]. <br />
<br />
Miranda is a work in progress. We would love to hear your comments, questions, and ideas. Send us a note at miranda@folger.edu - we look forward to speaking with you. <br />
<br />
== Table of contents ==<br />
* [[Introduction to the platform]]<br />
* [[What's in Miranda: Content Types|Platform contents]]<br />
* [[International Image Interoperability Framework|International Image Interoperability Framework (IIIF)]]<br />
* [https://wiki.folger.edu/collections-architecture-portal/The_%22My_Shelf%22_Feature "My Shelf"]<br />
* [[Topics and Stories]]<br />
* [[Taxonomies]]<br />
* [[Data model]]<br />
* [[The Miranda API]]<br />
* [[Advanced search]]<br />
* [[Technical Architecture]]<br />
* [https://wiki.folger.edu/collections-architecture-portal/Licensing_Agreements Licensing agreements]<br />
* [[Team]]<br />
* [[Advisory committee]]</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=International_Image_Interoperability_Framework&diff=145International Image Interoperability Framework2019-01-11T21:55:08Z<p>StaceyRedick: Added link to the IIIF website</p>
<hr />
<div>The Folger is a Founding Member of the International Image Interoperability Framework (IIIF) consortium, and seeks to use IIIF standards and tools as part of the Miranda platform project. <br />
<br />
In the Miranda alpha released in May 2018, we began integrating [http://universalviewer.io Universal Viewer] for digital images in our collection with a [https://medusa-project.github.io/cantaloupe/ Cantaloupe server] in place behind the scenes. <br />
<br />
[[File:Screen Shot 2019-01-07 at 2.57.09 PM.png|left|frameless]]<br />
In the beta version of Miranda launching in January 2019, we have added [http://projectmirador.org Mirador] as an option for users who wish to have a more in-depth look at Miranda images, and compare them to images from elsewhere in our platform or in other IIIF-compliant collections. <br />
<br />
We also have used the Universal Viewer in our WordPress plugin currently in development, which will be deployed to our Topics and Stories sites. <br />
<br />
Read more about the framework on the [https://iiif.io/about/ IIIF website].</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Taxonomies&diff=112Taxonomies2019-01-09T16:53:47Z<p>StaceyRedick: added more information about how this info might not be up to date, because it isn't.</p>
<hr />
<div>Through the Miranda platform prototype project, we worked to adapt the Folger's current taxonomies to best describe our collections for our users. We came up with [[:File:Taxonomies Draft - Folger Shakespeare Library.xlsx|unified taxonomies]] which we employed in Miranda, and which we will continue to refine and adjust our taxonomies as the project moves forward. We will make every effort to keep this page up to date, but there may be slight differences between this list and what is available on the Miranda platform. <br />
<br />
Below, we have included definitions for our genre and format taxonomy terms.<br />
<br />
'''Genre Taxonomy''' <br />
<br />
Categories in this taxonomy describe the intellectual content of items, as opposed to their format or structure. We are working through places where there are gaps or overlaps in categories with the Format taxonomy. <br />
<br />
* Art - Visual (artistic) materials, including architectural drawings, historical art, landscapes, art related to performances or other events, portraits, and prints and printmaking materials <br />
* Commentary - Treatises or series of comments that explain or annotate another work. <br />
* Communications - Items intended to convey awareness, knowledge, or information to others. Including but not limited to: cards, telegrams, letters. <br />
* Derivative works - Works that are based on one or more pre-existing works, such as a translation, musical arrangement, dramatization, fictionalization, motion picture version, sound recording, art reproduction, abridgment, condensation, or any other form in which a work may be recast, transformed, or adapted. <br />
* Humor - Comical works intended to provoke laughter and provide amusement <br />
* Literary and performing arts - Works of drama, dance, music, prose, poetry, cinema, television, etc... <br />
<br />
* News - Letters, reports, serials, newsbooks, corantos, or other written communications that communicate news. May be published at stated, frequent, or regular intervals and contain news, articles, editorials, features, advertisements, and/or other items of current interest. This category also includes news clippings: illustrations, pages, articles, or columns of text removed from books, newspapers, journals, or other printed sources and kept for their informational content. <br />
* Official Documents - Records, in law, having the legally recognized and judicially enforceable quality of establishing some fact (from AAT, "official documents"). May be related to financial, legal, government or personal official documents. May include deeds, licenses, legal notices, or official documents of a personal nature <br />
* Performance materials - Documents or materials used in or related to a performance. May be used by performers, or ephemera that results from a performance, intended for audiences. Examples include playbills, prompt books. <br />
* Promotional materials - Printed matter or objects devised to advertise or promote products, causes, or other concerns, especially those items given away to prospective consumers, clients, or contributors. <br />
* Realia - Physical objects (not books or audio-visual materials) that were produced for use, decoration, or entertainment. <br />
* Reference - Works intended primarily for consultation rather than for continuous reading. <br />
<br />
<br />
'''Format Taxonomy'''<br />
<br />
These categories describe the Original Format of an item, not the format of its digital surrogate/facsimile. They describe the structure or format of an item, not its intellectual content. We are working through gaps and overlaps in these two taxonomies.<br />
<br />
* Text - a manuscript or printed document, including books and letters.<br />
* Sound - Refers to sound recordings, stored electronically, in any media. May include items such as podcasts or audiobook recordings, or recordings of lectures or performances<br />
* Image - Refers to images, in any medium but usually referring to paintings, drawings, prints, photography, or digital works.<br />
* 3D object - Items Having, or appearing to have, the three dimensions of length, width, and height. May include ceramics, human hair, statues, a bust of Shakespeare carved in salt<br />
* Dataset - a set of data or information that can be interpreted and reinterpreted in quantitative analysis of a subject<br />
* Interactive resource - Use to describe two-way systems involving feedback from a viewer or user, to obtain data or commands and to give immediate results or updated information. <br />
* Video - Refers to manifestations of motion pictures, stored electronically, in any media.</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Taxonomies&diff=111Taxonomies2019-01-09T15:31:33Z<p>StaceyRedick: </p>
<hr />
<div>Through the Miranda platform prototype project, we worked to adapt the Folger's current taxonomies to best describe our collections for our users. We came up with [[:File:Taxonomies Draft - Folger Shakespeare Library.xlsx|unified taxonomies]] which we employed in Miranda, and which we will continue to refine and adjust our taxonomies as the project moves forward. <br />
<br />
Below, we have included definitions for our genre and format taxonomy terms.<br />
<br />
'''Genre Taxonomy''' <br />
<br />
Categories in this taxonomy describe the intellectual content of items, as opposed to their format or structure. We are working through places where there are gaps or overlaps in categories with the Format taxonomy. <br />
<br />
* Art - Visual (artistic) materials, including architectural drawings, historical art, landscapes, art related to performances or other events, portraits, and prints and printmaking materials <br />
* Commentary - Treatises or series of comments that explain or annotate another work. <br />
* Communications - Items intended to convey awareness, knowledge, or information to others. Including but not limited to: cards, telegrams, letters. <br />
* Derivative works - Works that are based on one or more pre-existing works, such as a translation, musical arrangement, dramatization, fictionalization, motion picture version, sound recording, art reproduction, abridgment, condensation, or any other form in which a work may be recast, transformed, or adapted. <br />
* Humor - Comical works intended to provoke laughter and provide amusement <br />
* Literary and performing arts - Works of drama, dance, music, prose, poetry, cinema, television, etc... <br />
<br />
* News - Letters, reports, serials, newsbooks, corantos, or other written communications that communicate news. May be published at stated, frequent, or regular intervals and contain news, articles, editorials, features, advertisements, and/or other items of current interest. This category also includes news clippings: illustrations, pages, articles, or columns of text removed from books, newspapers, journals, or other printed sources and kept for their informational content. <br />
* Official Documents - Records, in law, having the legally recognized and judicially enforceable quality of establishing some fact (from AAT, "official documents"). May be related to financial, legal, government or personal official documents. May include deeds, licenses, legal notices, or official documents of a personal nature <br />
* Performance materials - Documents or materials used in or related to a performance. May be used by performers, or ephemera that results from a performance, intended for audiences. Examples include playbills, prompt books. <br />
* Promotional materials - Printed matter or objects devised to advertise or promote products, causes, or other concerns, especially those items given away to prospective consumers, clients, or contributors. <br />
* Realia - Physical objects (not books or audio-visual materials) that were produced for use, decoration, or entertainment. <br />
* Reference - Works intended primarily for consultation rather than for continuous reading. <br />
<br />
<br />
'''Format Taxonomy'''<br />
<br />
These categories describe the Original Format of an item, not the format of its digital surrogate/facsimile. They describe the structure or format of an item, not its intellectual content. We are working through gaps and overlaps in these two taxonomies.<br />
<br />
* Text - a manuscript or printed document, including books and letters.<br />
* Sound - Refers to sound recordings, stored electronically, in any media. May include items such as podcasts or audiobook recordings, or recordings of lectures or performances<br />
* Image - Refers to images, in any medium but usually referring to paintings, drawings, prints, photography, or digital works.<br />
* 3D object - Items Having, or appearing to have, the three dimensions of length, width, and height. May include ceramics, human hair, statues, a bust of Shakespeare carved in salt<br />
* Dataset - a set of data or information that can be interpreted and reinterpreted in quantitative analysis of a subject<br />
* Interactive resource - Use to describe two-way systems involving feedback from a viewer or user, to obtain data or commands and to give immediate results or updated information. <br />
* Video - Refers to manifestations of motion pictures, stored electronically, in any media.</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=Taxonomies&diff=110Taxonomies2019-01-09T15:31:09Z<p>StaceyRedick: Added and updated descriptions of each taxonomy; updated the unified taxonomies to the one we sent Parsons, which only has 2 levels.</p>
<hr />
<div>Through the Miranda platform prototype project, we worked to adapt the Folger's current taxonomies to best describe our collections for our users. We came up with [[:File:Taxonomies Draft - Folger Shakespeare Library.xlsx|unified taxonomies]] which we employed in Miranda, and which we will continue to refine and adjust our taxonomies as the project moves forward. <br />
<br />
Below, we have included definitions for our genre and format taxonomy terms.<br />
<br />
'''Genre Taxonomy''' <br />
<br />
Categories in this taxonomy describe the intellectual content of items, as opposed to their format or structure. We are working through places where there are gaps or overlaps in categories with the Format taxonomy. <br />
<br />
* Art - Visual (artistic) materials, including architectural drawings, historical art, landscapes, art related to performances or other events, portraits, and prints and printmaking materials <br />
* Commentary - Treatises or series of comments that explain or annotate another work. <br />
* Communications - Items intended to convey awareness, knowledge, or information to others. Including but not limited to: cards, telegrams, letters. <br />
* Derivative works - Works that are based on one or more pre-existing works, such as a translation, musical arrangement, dramatization, fictionalization, motion picture version, sound recording, art reproduction, abridgment, condensation, or any other form in which a work may be recast, transformed, or adapted. <br />
* Humor - Comical works intended to provoke laughter and provide amusement <br />
* Literary and performing arts - Works of drama, dance, music, prose, poetry, cinema, television, etc... <br />
<br />
* News - Letters, reports, serials, newsbooks, corantos, or other written communications that communicate news. May be published at stated, frequent, or regular intervals and contain news, articles, editorials, features, advertisements, and/or other items of current interest. This category also includes news clippings: illustrations, pages, articles, or columns of text removed from books, newspapers, journals, or other printed sources and kept for their informational content. <br />
* Official Documents - Records, in law, having the legally recognized and judicially enforceable quality of establishing some fact (from AAT, "official documents"). May be related to financial, legal, government or personal official documents. May include deeds, licenses, legal notices, or official documents of a personal nature <br />
* Performance materials - Documents or materials used in or related to a performance. May be used by performers, or ephemera that results from a performance, intended for audiences. Examples include playbills, prompt books. <br />
* Promotional materials - Printed matter or objects devised to advertise or promote products, causes, or other concerns, especially those items given away to prospective consumers, clients, or contributors. <br />
* Realia - Physical objects (not books or audio-visual materials) that were produced for use, decoration, or entertainment. <br />
* Reference - Works intended primarily for consultation rather than for continuous reading. <br />
<br />
'''Format Taxonomy'''<br />
<br />
These categories describe the Original Format of an item, not the format of its digital surrogate/facsimile. They describe the structure or format of an item, not its intellectual content. We are working through gaps and overlaps in these two taxonomies.<br />
<br />
* Text - a manuscript or printed document, including books and letters.<br />
* Sound - Refers to sound recordings, stored electronically, in any media. May include items such as podcasts or audiobook recordings, or recordings of lectures or performances<br />
* Image - Refers to images, in any medium but usually referring to paintings, drawings, prints, photography, or digital works.<br />
* 3D object - Items Having, or appearing to have, the three dimensions of length, width, and height. May include ceramics, human hair, statues, a bust of Shakespeare carved in salt<br />
* Dataset - a set of data or information that can be interpreted and reinterpreted in quantitative analysis of a subject<br />
* Interactive resource - Use to describe two-way systems involving feedback from a viewer or user, to obtain data or commands and to give immediate results or updated information. <br />
* Video - Refers to manifestations of motion pictures, stored electronically, in any media.</div>StaceyRedickhttps://wiki.folger.edu/collections-architecture-portal/_mw/index.php?title=File:Taxonomies_Draft_-_Folger_Shakespeare_Library.xlsx&diff=109File:Taxonomies Draft - Folger Shakespeare Library.xlsx2019-01-09T15:25:41Z<p>StaceyRedick: StaceyRedick uploaded a new version of File:Taxonomies Draft - Folger Shakespeare Library.xlsx</p>
<hr />
<div>Draft last updated May 2017 of Folger's genre and format taxonomies.</div>StaceyRedick