/chgov-brprotokolle-ocr

Primary LanguageJavaScriptGNU Affero General Public License v3.0AGPL-3.0

chgov-brprotokolle-ocr

Context

A plugin for the mirador IIIF viewer project.

Architecture and components

This plugin shows a companion window with the transcription of the OCR text of the current page of the document. By interacting with the companion window, the user is able to identify the corresponding textline in the document and vice versa.

First steps

Preparations

Install

To work on the project, you need to select the right node version (e.g. via NVM) and then install all dependencies via npm.

nvm use
npm install

Customization

General

The watch process can be started as follows.

nvm use
npm run start

To create a new build and test it on your local machine, you have to:

  1. Create a new build
nvm use
npm run build
  1. Serve the build by using serve
nvm use
# Install serve if not already installed previously (optional)
npm i -g serve
# Serve the created build in demo/dist/ directory
serve demo/dist

Configuration

Property Description Type Default
enabled Enable plugin boolean true
visible Initially show the companion window boolean true
optionsRenderMode Render mode of the plugin options complex / simple complex
skipEmptyLines Ignore empty ocr-lines number true
opacity Default opacity of text overlay number 0.3
useAutoColors Try to automatically determine the text and background color boolean false
color Color of rendered boxes (used as a fallback if auto-detection is enabled and fails) string #00FF7B
correction.enabled If enabled, the user can submit corrections to the text via email boolean false
correction.emailRecipient Email address used as to parameter for mailto link string / null null
correction.emailUrlKeepParams Defines which existing url parameters need to be kept when generating the the entry url array []

Authors

License

GNU Affero General Public License (AGPLv3), see LICENSE

Contribute

This repository is a copy which is updated regularly - therefore contributions via pull requests are not possible. However, independent copies (forks) are possible under consideration of the AGPLV3 license.

Contact

  • For general questions (and technical support), please contact the Swiss Federal Archives by e-mail at bundesarchiv@bar.admin.ch.
  • Technical questions or problems concerning the source code can be posted here on GitHub via the "Issues" interface.