jtauber / online-reader

framework and tools for statically-generated and dynamic online reading environments

NOTE: The vue.js-based online reading environment has been broken off as deep-reader. Early prototypes as well as static-generation code remain here.

online-reader

At the moment, this is mostly an attempt to generalise one-off prototypes of Greek New Testament reading environments I've previously built over the last 11 years or so into code for generating those prototypes with arbitrary text (appropriately annotated).

There are, however, also early experiments with vue.js for more dynamic, modular readers.

The best place to start is the various prototypes that statically generate HTML, demos of which are linked to below.

The goal is for this project to be the basis for lots of different types of online and mobile reading environments with multiple technology architectures. This ranges in feature scope from basic ebook-style reading to a rich, modular platform for parallel texts, linguistic annotation, and integrated language learning tools.

I'm working, in particular, with texts and annotations from https://github.com/biblicalhumanities and https://github.com/perseusdl but this project is potentially much more general than that, and I'm interested in collaborating with anyone interested in online reading environments.

Statically-generated prototypes

These are all programmatically generated so, even though the demos are sometimes only for a single verse, chapter, or book, they can be run on arbitrary texts with appropriate annotation.

Interlinears for arbitrary verse using Berean interlinear

Demo (John 3.16): plain hover toggle frequency

Code: /prototypes/berean-interlinear/

Paginated verses of MorphGNT with toggled interlinear analysis

Demo: John 2.1

Code: /prototypes/paginated-morphgnt-interlinear/

Complete MorphGNT SBLGNT with analysis, one page per book with chapter nav

Demo: MorphGNT SBLGNT

Code: /prototypes/sblgnt-web/

Paginated Perseus 4 (alternative pagination styling; no additional annotation)

Demo: Herodotus Book 2

Code: /prototypes/static-paginated-perseus4/

Toggle controls to change styling of text and morphology-based colouring

Demo: 2 John

Code: /prototypes/toggle-controls/

online-reader's Issues

support keyboard shortcuts to paginate

rewrite the interlinear demos with jquery

merge the text-controls and toggle-color-reader labs into the morphgnt-api-reader lab

pick a standalone grid solution

merge the text-controls and toggle-color-reader labs for a fixed text

implement infinite scroll variant of pagination

possibly could still be statically generated on disk, though

paginating to previous books doesn't update book

This is in vue-morphgnt-api.

For example, go to Mark in Book widget then go to previous page. Still says Mark even though you're on last paragraph of Matthew.

merge the text-controls and toggle-color-reader labs and statically generate

copy over interlinear experiments from old blog

convert sblgnt2html to use py-sblgnt

remove use of DTL in labs

convert statically-generated sites to mobile apps with Cordova

generate a static, paginated reader from a Perseus XML file

work happening on static-paginated-perseus4 branch

example of interlinear pulling in other information

from MorphGNT such as part-of-speech, parsing, or lemma

clean up text-controls.html

fully qualify font URLs to bring back Skolar (for now)

incorporate ideas from `greek-reader` repo

update sblgnt2html to Python 3.6

remove gauges and GA from pages

remove labs nav

remove font-feature-setting as Safari bug fixed

generate the interlinear demos for any passage using Berean interlinear

copy over labs from jktauber.com

go through the capability reference model to decide what it makes sense to implement next

make it easy to demo static prototypes with github pages

work out a way to potentially do the interlinear with a generic paginated reader

note if that would mean having to incorporate the interlinear data into MorphGNT API or do it with a standoff API or what

automate the generation of the static labs

All but the morphgnt-api-reader labs are static and were created as one-offs using a particular passage.

We should re-do some of them so they can be generated for any passage.

consider rewriting sblgnt2html using more generic templating

one possibility would be something like Mustache or Jinja.

copy over sblgnt-web static reader

clean up css for old interlinear demos