This project is the source code that I wrote as part of my doctoral dissertation: Expanding the Frame: Realising Engagement Through an Interactive, Visualisation-Based Search in Digital Humanities Research Environments. For more information on the project, its purpose, and the research used to support many of the design decisions, you can read my full dissertation hosted at Maynooth University Research Archive Library (MURAL).
As this code is related to my doctoral research, it will remain locked and will not accept collaborations or improvements. Should you be interested in using any of this work, in whole or in part, please contact me directly.
NOTE: This projects was created in 2018 and some parts may now be deprecated due to changes in libraries. For specific versions utilized, please see requirements.txt for information related to backend libraries and package.json for information related to frontend libraries.
See requirements.txt for a full list of third party libraries/components.
Before you begin, you will need to install the following:
This repository is broken into two sections: backend and frontend. The backend is a Python project utilizing Flask and acts as a webserver. All web requests are routed through server.py, which then routes to the appropriate class or package.
All data related to the Alcalá Record Books themselves (such as images, transcriptions and translations, etc.) are stored in eXist-db, an XML-based document database. This data is stored onsite at Maynooth University and is not available for public distribution. If you wish to have access to this data, please contact me, and I will get in touch with the copyright holder.
All other data (user logins, saved searches, boundary objects, and compilations) are stored in MongoDB.
The frontend of the project was written in Angular and follows the standard MVC (model-view-controller) pattern. Data visualizations are rendered through the NVD3 library—a javascript library that builds off d3.js.
- I would like to acknowledge the Irish Research Council who provided the funding that allowed me to undertake this work.
- I would like also like to thank my doctoral supervisor, John Keating, without whom I would never have completed my Ph.D. I will be forever grateful for the guidance and direction you provided!
- Additionally, I'd like to thank the Computer Science Department and the Arts and Humanities Institute at Maynooth University for their assistance during my studies.
- I would also like to thank the creator(s) of readme.so for providing an easy tool for generating ReadMe files.
- Finally, a special thanks to my amazing husband, Joshua D. Savage, who provided support and a lot of edits. I wouldn't be where I am today without you!