Skip to content
This repository has been archived by the owner on Jun 23, 2022. It is now read-only.
/ open-oni Public archive
forked from open-oni/open-oni

Open ONI fork, our modifications are only in branches (e.g., romantik-zeitungen.de uses branch "amz")

License

Notifications You must be signed in to change notification settings

JULIELab/open-oni

 
 

Repository files navigation

JULIE Lab's fork of Open ONI

Changes to Open ONI for romantik-zeitungen.de and romanticode.de are maintained in this repository's branches other then master and dev (the forked branches from upstream). Currently there is only one project specific branch amz with changes to the template, a project description and a RUNBOOK with notes how we currently operate the online instance — which is probably totally useless to others and serves only as documentation (e.g. for maintenance, or for disaster recovery) for us.

The README from upstream begins here:

Open ONI

Open Online Newspaper Initiative (Open ONI) is a community-maintained project to make historic American newspapers browsable and searchable on the web. We aim to enable individual state and library-based newspaper collections to more easily provide these core capabilities, as well as develop new common features and improvements.

Read our About Open ONI web page for more information about the project's origins and history.

Open ONI-powered Sites

Visit sites currently powered by Open ONI:

View "Sites using Open ONI" in our wiki for links to the sites' source code.

Install

To evaluate the software, we recommend installing from the latest Open ONI release.

The 1.0 release includes upgrading Django to the latest LTS 2.2 release along with migrating to Python 3 and upgrading Solr and MariaDB to more recent releases. Note that release 0.11 and prior run Python 2 and Django 1.11 LTS which goes out of support in April 2020.

If you're interested in more recent changes, check out the dev branch.

Resource Requirements

This is a ballpark estimate of resources we recommend for running Open ONI in production. Open ONI is quite capable with minimal processing and memory resources.

CPU Memory Storage (with TIFFs) Storage (JP2s only)
Modern CPU with two (virtual) cores 6GB 1TB per ~25K pages 1TB per ~100K pages

We share more information on the Resource Usage page in our wiki, which may further inform your resource allocation.

Dependency Roadmap

We expect Open ONI's major components (aside from Bootstrap 3) to be supported until the next Django LTS release 3.2 in April 2021, at which point we will likely upgrade Open ONI's components between major releases again.

Component Version Supported Until Next Target Release Documentation
Python 3.6 2021-12 TBD https://www.python.org/dev/peps/pep-0494/#lifespan
Django 2.2 LTS 2022-04 3.2 LTS, 2021-04 https://www.djangoproject.com/download/#supported-versions
MariaDB 10.4 2024-06 TBD https://mariadb.com/kb/en/mariadb-server/
Solr 8.x Approx 2022, based on ~18 major release cycle TBD https://lucene.apache.org/solr/downloads.html#about-versions-and-support
jQuery 3.4.1 Unknown TBD https://github.com/jquery/jquery/wiki/Roadmap
Bootstrap 3.4.1 2019-07-24 TBD https://github.com/twbs/release
OpenSeadragon 2.4.1 Unkown TBD https://github.com/openseadragon/openseadragon
tablesorter 2.31.2 Unknown TBD https://github.com/mottie/tablesorter/

Documentation

Support

Note that maintainers can only provide a minimal amount of assistance while working on Open ONI part-time. Developers cannot be expected to provide extensive one-on-one support.

We are glad to provide support specifically related to Open ONI, but anyone wanting to work with Open ONI should begin with some foundational knowledge of Linux, Docker, Apache, Python, Django, Solr, MariaDB/MySQL, and IIIF. There are other resources and communities better suited to aid in getting started and familiar with those technologies, so general assistance with them falls outside the scope of what to expect Open ONI developers to provide.

We ask that bugs and feature requests be submitted to Open ONI on GitHub. Please confine other questions and conversation about Open ONI development and use to Open ONI's Slack. These guidelines are intended both to keep conversation in the open where it may benefit all of the Open ONI community and to protect developers' already limited time.

Contact Us

We prefer to communicate on the Open ONI Slack, but if you have trouble or prefer not to use Slack, email Greg Tunink (techgique [at] unl.edu).

Security

To report a security concern or vulnerability, please ask for a project maintainer to direct message you on the Open ONI Slack or email Greg Tunink (techgique [at] unl.edu). Maintainers will evaluate, discuss responsible disclosure and patching, and give many thanks and credit for your generous assistance.

Contribute

If you are interested in collaborating on the project, please review CONTRIBUTING.md for more details. Everyone interacting within the Open ONI community is expected to follow the Open ONI Community Code of Conduct

License

Licensed under the Apache License, Version 2.0

About

Open ONI fork, our modifications are only in branches (e.g., romantik-zeitungen.de uses branch "amz")

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Languages

  • Python 63.7%
  • HTML 32.4%
  • JavaScript 1.7%
  • Shell 1.1%
  • CSS 1.1%