[sword-devel] A useful tip for building modules that include EsthAdd

[David Haslam]

Looking at how Xiphos behaves when trying to scroll up or down past a missing
verse or missing chapter, the following tip may be worth sharing.

The module I'm building includes the DC book we call EsthAdd, the Greek
additions to Eshther.
i.e. As defined in the KJVA versification scheme.

Rather than having missing records, this is what I did in the XML 
(ignore the inserted spaces before each ! comment line)

< !-- Main title moved to before chapter 10 -->
< !-- Esther (Hebrew) ends  at 10.3 -->
< !-- Greek additions begin at 10.4 -->
< !-- The 12 "empty verses" below each contain a horizontal ellipsis -->
< !-- This avoids navigation issues in front-ends such as Xiphos -->

Example:

<chapter osisID="AddEsth.2">
<verse sID="AddEsth.2.1" osisID="AddEsth.2.1"/>…<verse eID="AddEsth.2.1"/>
</chapter>

and leter:

<title short="Esther (Greek)" type="main">The Rest of the Chapters of the
Book of Esther</title>
<chapter osisID="AddEsth.10">
<verse sID="AddEsth.10.1" osisID="AddEsth.10.1"/>…<verse
eID="AddEsth.10.1"/>
<verse sID="AddEsth.10.2" osisID="AddEsth.10.2"/>…<verse
eID="AddEsth.10.2"/>
<verse sID="AddEsth.10.3" osisID="AddEsth.10.3"/>…<verse
eID="AddEsth.10.3"/>


There are thus no empty verses or chapters.

The chapter/verse scrollers in Xiphos can now move through the "almost
empty" sections of this book.

This may also help in some other front-ends, though I've yet to try in
PocketSword.

Similar scenarios exist even for some protocanonical editions, such as where
verse 1 is missing from a chapter for whatever reason.

Best regards,

David



--
View this message in context: http://sword-dev.350566.n4.nabble.com/A-useful-tip-for-building-modules-that-include-EsthAdd-tp4655969.html
Sent from the SWORD Dev mailing list archive at Nabble.com.