Draft preview. This draft factsheet remains excluded from formal publication outputs.
Factsheet
ZBZ-OCR-TEI: A Project-Specific OCR-to-TEI Pipeline for the Jeanne Hersch Digital Re-edition — A Self-Audit
Reviewed resource
People
Developer and contractor
- Christopher Pollin, Digital Humanities Craft OG
Commissioning institution and data authority
- Zentralbibliothek Zürich
Questionnaire
General information
Software type cf. Catalogue 0.1.1
What type of software is it?
Answer Software tool
Explanation
Software type
- Software tool — A “Tool” is broadly defined as a computational application to be used for accomplishing one task or a number of related tasks in the process of digital scholarly editing.
- Virtual Reseaerch Environment (VRE) — An “environment” is defined as a platform on which various tools (independent or not) are working as an integrated whole in order to perform a series of tasks or to cover the entire workflow.
Identification of the environment cf. Catalogue 1.4
On which platform runs the tool?
Answer Operating system, Web browser
Explanation
Identification of the environment
- Operating system — e.g. for stand-alone applications
- Web browser — for web-based applications, web-services, and APIs
- Another application — i.e., a plugin
Purpose cf. Catalogue 1.5
For what purpose was the tool developed?
Answer developed for a specific project or materials
Methods and implementation
Programming Language cf. Catalogue 2.3
Which programming languages and technologies are used?
Answer Python, Other: JavaScript, HTML, and CSS for the static viewer
Input format cf. Catalogue 2.4
Which input formats are supported?
Answer .xml, .xml/tei, .txt, .pdf, .json, Other: .xlsx metadata and PNG page images
Output format cf. Catalogue 2.4
Which output formats are supported?
Answer .xml, .xml/tei, .txt, .html, .json, Other: PAGE XML, METS XML, and JPEG/PNG derivatives
Encoding preprocessing
Is a pre-processing conversion included?
Answer Yes
Dependencies cf. Catalogue 3.2
Does the documentation list dependencies on other software, libraries or hardware?
Answer Yes
Dependencies installation
If yes, is the software handling the installation of dependencies during the general installation process (you don't have to install them manually before the installation)?
Answer Yes
Documentation and support
Documentation cf. Catalogue 3.4
Is documentation and/or a manual available? (tool website, wiki, blog, documentation, or tutorial)
Answer Yes
Documentation format cf. Catalogue 3.3
Which format has the documentation?
Answer readme, .html, Other: Markdown knowledge base and client report
Documentation parts cf. Catalogue 3.3
Which of the following sections does the documentation contain?
Answer ‘Getting Started’ section (installation and configuration), Step-by-step instructions, Examples, Troubleshooting (a selection of possible error messages and related solutions), Support
Documentation language cf. Catalogue 3.3
In what languages is the documentation available?
Answer English, German
Support cf. Catalogue 3.4
Is there a method to get active support from the developer(s) or from the community?
Answer Yes
From of support cf. Catalogue 3.4
Which form of support is offered?
Answer Other: Support within the commissioning relationship and a private repository issue tracker
Issue tracker cf. Catalogue 3.4
Is it possible to post bugs or issue using issue tracker mechanisms?
Answer Yes
Usability and sustainability
Build and install cf. Catalogue 3.6
Grade how straightforward it is to build or install the tool on a supported platform:
Answer tricky
Tests cf. Catalogue 3.7
Is there a test suite, covering the core functionality in order to check that the tool has been correctly built or installed?
Answer Yes
Portability and interoperability cf. Catalogue 3.8
On which platforms can the tool/software be deployed?
Answer Linux/BSD/Unix, Windows
Devices cf. Catalogue 3.8
On which devices can the tool/software be deployed?
Answer Desktop, Laptop
Browsers cf. Catalogue 3.8
If the tool is web-based: On which browsers can the tool/software be deployed?
Answer Google Chrome, Other: Chromium-based Microsoft Edge
Plugins cf. Catalogue 3.8
If the tool is web-based: Does the tool rely on browser plugins?
Answer No
Credits cf. Catalogue 3.9
Does the software make adequate acknowledgement and credit to the project contributors?
Answer Yes
Possible contribution
If yes, can you contribute to the software development via the repository/development platform?
Answer No
Analysability, extensibility, reusability of the code
Analysability cf. Catalogue 3.10
Can the code be analyzed easily (is it structured, commented, following standards)?
Answer Yes
Extensibility cf. Catalogue 3.10
Can the code be extended easily (because there are contribution mechanisms, attribution for changes and backward compatibility)?
Answer Unknown
Reusability cf. Catalogue 3.10
Can the code be reused easily in other contexts (because there are appropriate interfaces and/or a modular architecture)?
Answer No
Security and privacy cf. Catalogue 3.11
Does the software provide sufficient information about the treatment of the data entered by the users?
Answer No
Supportability and maintenance cf. Catalogue 3.12
Is there information available whether the tool will be supported currently and in the future?
Answer Yes
Citability cf. Catalogue 3.13
Does the tool supply citation guidelines (e.g. using the Citation File Format)?
Answer Yes
User interaction, GUI and visualization
User profile cf. Catalogue 4.1
What kind of users are expected?
Answer Humanities researcher, Computer scientist, Digital humanist, General public
User interaction cf. Catalogue 4.1
What kind of user interactions are expected?
Answer Reading, Text editing, Text analysis, Image editing, Searching, Visualization, Comparing, Compiling
User Interface cf. Catalogue 4.2 and 0.1.1
What kind of interface does the tool provide?
Answer Graphical User Interface (GUI), Command Line Interface (CLI)
Visualization cf. Catalogue 4.3
Does the tool provide a particular visualizations (in terms of analysis) of the input and/or the output data?
Answer Yes
User empowerment cf. Catalogue 4.4
Is the user allowed to customize the functioning of the tool and the output configuration?
Answer Yes
Accessibility cf. Catalogue 4.5
Does the tool provide particular features for improving accessibility, allowing „people with the widest range of characteristics and capabilities" to use it?
Answer No