ScriptureGuide 1.2.2 (test release)

A test release, and the first since 1.0.0-rc1 — so this covers everything from the last 65 commits, not just the last few. Feedback welcome.

Installing

Take the package — download the .hpkg below and:

pkgman install scriptureguide-1.2.2-1-x86_64.hpkg

Or build one that fits your Haiku. A prebuilt package records the Haiku version it was built on and may refuse to install on another. Download package.sh and run:

sh package.sh v1.2.2

It needs nothing present but itself: it installs the build dependencies (including the devel: ones), fetches the source, builds both applications, writes the .hpkg into the current directory, and removes everything it created — including if you interrupt it. Add --install to install it straight away.

Reading

Column groups. Columns are joined into groups that scroll, align and navigate together — or split apart, so one group can sit in the Old Testament while another stays in the New. Each group keeps its own chapter, scroll position and alignment, and every column has its own scrollbar. Columns can be reordered by dragging their header, and the whole layout comes back the next time you start.

Notes beside the verse. The notes column is edited directly: click where you want to type and the cursor lands there, select and copy across verses, walk from one verse's note into the next with the arrow keys, press Return for a new line. Notes save themselves as you type. The column has a draggable splitter, and you can have several, in different groups.

Cross-references and Strong's numbers. References in commentary or note text became clickable. Strong's-tagged words open a dictionary window. Both, and verse numbers, can be switched off in the Options menu.

Back and forward, in the Navigation menu and the toolbar. Following a reference moves the group you were reading in, so this is how you get back — and it covers every kind of navigation, not just links.

Copy Comparison. Every open column's text for the current chapter, as a verse-by-verse table, on the clipboard as plain text, tab-separated, Markdown or HTML.

Book Manager

Rebuilt around two panels: available modules on the left, installed on the right, arrows between them. Moving a module starts the work — there is no Apply step; removal asks first, since it deletes downloaded data. Added a sortable module-type column and multiple selection, so a batch can be marked at once instead of double-clicking each row. It is also localized now, which it never was before.

Speed

Switching chapters with three columns open took 500–1500 ms. Two causes, both fixed: alignment was rebuilding every document from scratch just to adjust paragraph spacing, and every keystroke re-shaped the glyphs of every paragraph in the document — all 176 of them in a notes column on Psalm 119.

Translations

Both applications are translated into German, Spanish, French, Croatian, Dutch, Romanian and Russian. ScriptureGuide's catalogs had drifted well behind the source — six of the eight languages were missing a batch that had never been translated in any of them, and Spanish had 27 of 39 entries still in English. The Book Manager had no localization at all.

Notable fixes

• Strong's numbers showed the wrong entry. Any Greek word could produce the article for "alpha". Feature=GreekDef means "this defines Greek words", not "this is keyed by Strong's number" — a lemma-keyed lexicon answered every lookup because SWORD snaps to the nearest key rather than failing.
• Numbers are only drawn as links when a dictionary that can resolve them is installed. With only a Greek one present, the entire Old Testament looked clickable and led nowhere.
• The position the app reopens at is now the one you were actually reading; it used to save a key nothing kept in sync with the reading pane.
• A column group could be left scrolled somewhere it could not scroll back from.
• A column kept its neighbours' verse spacing after being disconnected from them.
• The Book Manager aborted on startup when its package list was missing, before its window ever appeared, and could list the same module twice.
• Commentary entries spanning several verses inflated the row height once per verse covered.
• A dangling pointer to the dictionary window could crash the app.

Documentation

The manual was rewritten, in English and German. Its pictures were seven full window shots at ~150 KB each; they are now crops of the part being described — 1.3 MB down to 156 KB.

Full detail in CHANGELOG.md.

Known limitations

• Strong's numbers need the matching dictionary installed: StrongsGreek for the New Testament, StrongsHebrew for the Old. Both are in the Book Manager.
• With several Strong's dictionaries installed, whichever comes first in the module list wins, regardless of interface language.
• The HaikuPorts recipe is not updated.
• Croatian, Romanian and Russian were extended from terminology earlier contributors established, but have not been checked by a native speaker.