Documentation

Team

This project is a collaboration between Peter Andorfer and Ksenia Zaytseva of the Austrian Centre for Digital Humanities (ACDH, Vienna) and Greta Franzini of the UCL Centre for Digital Humanities (UCLDH, London). Peter and Ksenia develop the web application while Greta curates the data.

Duration

The Catalogue of Digital Editions began collecting digital editions in 2012. Development on the web application began in the summer of 2016 and kick-started the collaboration. The project will continue as long as the team's means allow.

Funding

This project receives no funding. Peter Andorfer and Ksenia Zaytseva are supported as ACDH staff, and Greta Franzini's contribution is entirely voluntary.

Components and repositories

The Catalogue of Digital Editions Web Application is made-up of two interacting components, each stored in its own GitHub repository: 1) the data, and 2) the web application to display the data to the user. The two components are connected via a custom script that regularly fetches the latest updates from the data repository and delivers them to the web application.

Data component

The digital editions present in the Catalogue come from numerous sources and their selection follows basic criteria: the electronic texts can be ongoing or complete projects, born-digital editions as well as electronic reproductions of print volumes. They're gathered from online lists (e.g. Projects using the TEI), conferences, publications, social media, word of mouth, web browsing and chaining.
The data is collected across two .csv (Comma Separated Value) files: the "master" digEds_cat.csv file contains the digital editions, while the institutions_places_enriched.csv file contains geographical information associated with the institutions contained in the master file (including DNB and GeoNames IDs). This second file allows us to place digital editions on a map.
The data's GitHub repository is: https://github.com/gfranzini/digEds_cat

Web application component

The application is a Django web framework designed to be simple and pragmatic.
Some fields in the Catalogue's data file contain decimal numbers as values to measure the degree of compliance of a project to a particular feature: 0 stands for 'no compliance', 0.5 for 'somewhat/partially compliant', 1 for 'fully compliant'. Numbers make it easier to run calculations and statistical analyses over the data-set. When fetching data updates, the web application transforms these values into human-readable information: 0 becomes 'no', 0.5 becomes 'partial/somewhat' and 1 becomes 'yes'.
The web application's default view of the Catalogue data is a searchable table, but it also provides bar and pie charts to better visualise statistical information.
The web application's GitHub repository is: https://github.com/acdh-oeaw/dig_ed_cat

Progress

As of early 2017, the web application is still in its beta phase and despite a few bugs we're making good progress on both data accuracy and front/back-end development.

Limitations

Users might have noticed from the Catalogue that projects from Asian and African countries are underrepresented if not completely absent. The only reason for this large gap in the data is the language barrier. A Japanese project and website can only be correctly catalogued by someone who can read Japanese. Browser plugins to automatically translate webpages exist but we hesitate to use them as any machine-translation errors would go unnoticed and possibly lead to incorrect cataloguing. This is where user contributions become necessary to help paint a global, rather than a Western-centric, picture of digital edition initiatives.

How to contribute to the Catalogue

If you wish to contribute a digital edition to the Catalogue or correct an existing entry, you can do so in one of three ways:

  • If you're familiar with GitHub, you can fork the data repository, edit the .csv file and create a pull request.
  • If you're not familiar with GitHub, you can create a GitHub issue with as much information about the edition as possible (see 'Data fields' here). The more information you provide, the sooner the edition will appear in the Catalogue.
  • If you'd rather not use GitHub at all, you can fill-in a Google Form at this address: https://goo.gl/forms/4Ya3jwRCBi0VSexx2. Your entry will be moderated and promptly added to the Catalogue.

The project you contribute will be exposed to 317 libraries in Germany thanks to its Datenbank-Infosystem (DBIS), which includes the Catalogue of Digital Editions in its list of scientific databases.

How to cite this project

There are two citations for this project. If you wish to cite the data only, please adapt the following according to your preferred referencing style:

Franzini, G. (2012-) Catalogue of Digital Editions. Web. <https://github.com/gfranzini/digEds_cat>

If you wish to cite the web application as a whole, please adapt the following:

Franzini, G., Andorfer, P., Zaytseva, K. (2016-) Catalogue of Digital Editions: The Web Application. Web. <https://dig-ed-cat.acdh.oeaw.ac.at/>

Web analytics

We monitor visits to the Catalogue with the Piwik Open Analytics platform. This allows us to improve the resource and, to some extent, understand user behaviour on the site.

Copyright

As per the Imprint page of this website, the data and code constituting this project are published under a Creative Commons Attribution Share-Alike International 4.0 License (CC-BY-SA 4.0). This means that you are free to reuse all contents as long as you make your copies or adaptations available under the same or a similar license.

Relevant reading

  • Franzini, G., Mahony, S., and Terras, M. (2016), 'A Catalogue of Digital Editions', In: Pierazzo, E. and Driscoll, M. J. (eds) Digital Scholarly Editing: Theories and Practices. Cambridge: Open Book Publishers. [describes an early version of the Catalogue of Digital Editions]
  • Krippendorf, K. (2004) Content Analysis: An Introduction to Its Methodology. 2nd edn. Thousand Oaks, CA: Sage.

Relevant resources


Feedback

For general comments and suggestions, please email Greta Franzini at g.franzini.11@ucl.ac.uk
For specific requests, bug reports or corrections, please create GitHub issues in the relevant repository.

We'd love to hear from you!