There is a bug in osis2mod that places new testament introductory material at 
the end of Malachi rather than in the NT. There are at least 4 Jira issues on 
this.

I’m open to suggestions. Especially from the modules team.

Right now osis2mod does not handle module, OT and NT introductory material 
appropriately. Generally, everything before the first book of the module is 
prepended to the intro of that book and stuff between books is appended to the 
last verse seen. This is flawed logic.

Ultimately the issue is how to reliably determine when a testament begins and 
ends.

Details follow:

In SWORD, there is special support for module and testament intros. But OSIS 
does not have an OSIS ID for these. I’m wondering what the best way to specify 
this introductory material in OSIS. In SWORD, these are located in slot 0 for 
book intro and slot 1 for old testament intro in the OT dat file or equivalent 
and in slot 1 for new testament intro. These have special “keys” that SWORD 
uses to retrieve the info.
Module intro - [ Module Heading ]
OT intro - [ Testament 1 Heading ]
NT intro - [ Testament 2 Heading ]
Note, these are very rigid in their format, and require it exactly as given, 
including the [ and ].

Internally these are a tuple of the form [ T, B, C, V ] (respectively 
testament, book, chapter, verse) where
[ 0, 0, 0, 0 ] is the Module intro
[ 1, 0, 0, 0 ] is the OT intro
[ 2, 0, 0, 0 ] is the NT intro
[ T, B, 0, 0 ] is a book intro
[ T, B, C, 0 ] is a chapter intro

These have to be enable with setIntros(true). I’m not sure which frontends 
support these intros. osis2mod doesn’t support these at all, but rather places 
them inappropriately at the beginning of the first book in the file for the 
Module and OT intros or at the end of the last verse seen for the NT Intro 
(unless it is a NT only module).

A minimally specified OSIS file requires one or more <div> elements to surround 
the text of the document. By and large osis2mod tries to understand by context 
what goes where.
So osis2mod given the following would improperly place the following 
introductory material NT only module as a book intro into Matthew:
<div type=“coverPage">Module cover page</div>
<div type=“titlePage">Module title page</div>
<div type=“preface">Module preface</div>
<div type=“tableOfContents">Module table of content</div>
<div type=“introduction">NT Intro ...</div>
<div type=“book” osisID=“Matt”>
  <title>The Gospel according to Matthew</title>
  <chapter osisID=“Matt.1”>
    <title>Chapter 1</title>
      … verses
  </chapter>
  … more chapters
</div>
… more NT books

If it had the the OT as well it would have place the leading introductory 
material into the first book it encountered (e.g. Psalms for an Psalms and NT 
module). This is the same as with an NT only module. But the NT Intro would be 
appended to the last verse seen, which typically is the last verse of Malachi.
<div type=“coverPage">Module cover page</div>
<div type=“titlePage">Module title page</div>
<div type=“preface">Module preface</div>
<div type=“tableOfContents">Module table of content</div>
<div type=“introduction">OT Intro ...</div>
<div type=“book” osisID=“Ps”>
  <title>Psalms</title>
  <chapter osisID=“Ps.1”>
    <title>Chapter 1</title>
      … verses
  </chapter>
  … more chapters
</div>
<div type=“introduction">NT Intro ...</div>
<div type=“book” osisID=“Matt”>
  <title>The Gospel according to Matthew</title>
  <chapter osisID=“Matt.1”>
    <title>Chapter 1</title>
      … verses
  </chapter>
  … more chapters
</div>
… more NT books

Also, the Apocrypha is not a third testament. SWORD only has 2 testaments. So 
we want any intro to the Apocrypha to be a book Intro. With a versification the 
Apocrypha can appear in either the OT or the NT. It doesn’t need to be together 
and/or at the end of a testament.

OSIS recommends <div type=“bookGroup”> to surround a collection of books. But 
osis2mod does not require this. (Should it? Should it make any assumptions 
about a book group?)

In His Service,
        DM






_______________________________________________
sword-devel mailing list: sword-devel@crosswire.org
http://crosswire.org/mailman/listinfo/sword-devel
Instructions to unsubscribe/change your settings at above page

Reply via email to