ScriptureGuide 1.3.1 (test release)

A test release. Two smaller changes that landed while finishing 1.3.0's
testing: importing a legacy plain-text reference list, and a bookmark
storage fix based on real end-user testing feedback.

Installing

Take the package — download the .hpkg below and:

pkgman install scriptureguide-1.3.1-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.3.1

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.

Import a plain-text reference list

File → Import Text List... in the verse list window reads a plain-text
file, one reference per line, no header, and creates a new collection
named after the file. Confirmed against a real sample from a QuickVerse/
Bible Research Systems export (EXO 4:14-style abbreviations) — SWORD's
own VerseKey already accepts that shape directly. A line that fails to
parse is skipped rather than aborting the whole import.

Bookmark storage: attributes are now the source of truth

Reference, versification and locale are read from SG:reference/
SG:versification/SG:locale attributes first — and, new this release,
all three show up as real Tracker columns, matching Position/Code/Tags.
The file's plain-text content survives as a clearly-labeled mirror,
regenerated on every save; it's only read back if the attributes
themselves are missing (e.g. a bookmark copied in from outside BFS), and
once that fallback runs, the recovered values are written back as
attributes so it only has to happen once per file.

Full detail in CHANGELOG.md.

Known limitations

• The binary QuickVerse .LIB format is still not reverse-engineered
  — not blocking now that the plain-text export path works, but a
  .lib file with no way to re-export it as text still can't be
  imported directly.
• The Go to List menu doesn't yet offer inline "new reference"/"new
  sub-collection" entries at each level — planned for 1.4.0.
• 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.

ScriptureGuide 1.3.0 (test release)

A test release. The headline feature is Verse Lists — building on real
end-user feedback about how a study/reading-plan tool should actually
work. Feedback welcome.

Installing

Take the package — download the .hpkg below and:

pkgman install scriptureguide-1.3.0-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.3.0

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.

Verse Lists

A standalone window (Program → Verse Lists) for building named
collections of references — a reading plan, a topical study, whatever
grouping makes sense. Clicking an entry navigates the reading pane
straight to that one verse.

Storage is one small plain-text file per reference, not one file per
list: a collection is just a folder. That buys a few things for free —
Tracker becomes a browser for a collection (sortable by Position, Code
and Tags, ordinary BFS attributes), copying a reference between
collections is a file copy, and double-clicking a bookmark file in
Tracker navigates the reading pane straight to it. Each bookmark records
the locale it was written in, so a German "Johannes 3:16" round-trips
correctly regardless of what locale later opens it.

• Rename in place. Double-clicking a collection's name renames its
  own folder, unlike Save As, which duplicates it elsewhere.
• Nested collections. Go to List cascades into sub-collections at
  any depth, not just the top level.
• Live sync. Changes made outside the app — in Tracker, from another
  instance, by hand — appear without reopening the window.

Search

The search window now offers every installed Bible and commentary, not
only the ones currently open as columns. Fixed: a double-click on a
result opened a new window instead of navigating the active chain, and
dragging multiple selected results onto a verse list did nothing.

Notable fixes

• Parallel columns of different versifications could silently drop
  verses.
• Dragging a reading-pane selection produced the wrong drag bitmap,
  including under German locale.

Documentation

The manual now covers Verse Lists, in both English and German.

Full detail in CHANGELOG.md.

Known limitations

• Importing the real end user's own legacy WORDsearch-style .LIB files
  isn't here yet — planned for 1.3.1.
• The Go to List menu doesn't yet offer inline "new reference"/"new
  sub-collection" entries at each level — planned for 1.4.0, alongside
  format conversion between the old and new verse-list storage shapes.
• 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.

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.

ScriptureGuide 1.0.0 RC1

First release candidate for 1.0.0.

Highlights

• Parallel columns: read any number of Bible translations, commentaries, or
  a personal-notes column side by side, kept aligned on the same verse
• Drag and drop selected verses between columns, to the Desktop, or to other
  apps -- drag a reference back in and every column jumps there
• A single "Go to / Search" field that jumps to a typed reference or opens
  a search, whichever it turns out to be
• Translated interface (German among others) with locale-aware verse
  references (e.g. "Johannes 3, 16" as well as "John 3:16")
• Book Manager integration (Program menu) for downloading Bibles and
  commentaries, with a network-access consent warning before any HTTP call

Installing

Download scriptureguide-1.0.0~rc1-1-x86_64.hpkg below, then either
double-click it in Tracker, or from a Terminal:

pkgman install ~/Downloads/scriptureguide-1.0.0~rc1-1-x86_64.hpkg

or just drag and drop it to /boot/system/packages/

Requires the sword library (pkgman install sword if not already
present -- it's in the standard HaikuDepot repositories).

Building it yourself

The HaikuPorts recipe used to build this package is included in this
repo's history/branches; see App/INSTALL.htm for building from source
directly.

ScriptureGuideManager fix

This Minor Release fixes the ScriptureGuideManager which broke recently

SGManager fixes, SearchWindow improvements and added Localisations

We now store the downloaded Bible books in /boot/home/config/settings/sword so that other bible software can acces it.

ScritpueGuideManager

• works now with the new path.
• improved the usabylity since you now can sort the books after language. this fixes #23

ScriptureGuide

• Added Localisation Support this fixes #6
• Search Window now supports selection of multiple search entrys and you can simply copy them buy pressing alt+c.
• If you select a found verse it will display the verses around the found verse so you can see the context of the found word.
• fixed the bug #18
• if you open a ScritptureGuid window from a found verse the verse where the word was found is now higlighted this fixes #19

Fixed the build on x86_64
This whole release should fix #21