[sword-devel] MinimumVersion property in module.conf files
dmsmith at crosswire.org
Tue Aug 6 08:41:09 MST 2013
The pre-verse div should be ignored as a div. It probably should have been a <milestone> element. It should not confuse the SWORD engine.
osis2mod 1.6.1 had the pre-verse div. It is not new w/ 1.7.0. It was supposed to work with SWORD 1.6.1, but it did not. From what I can tell 1.7.0 does work properly.
The form of OSIS in the module should be thought of as proprietary and intermediate, understandable by the SWORD engine. That you can see it via mod2imp is helpful in debugging osis2mod and the SWORD engine. It certainly is not our recommended best practice for writing an OSIS file, which should avoid milestoned elements as much as possible.
The <div sID="pv1" type="x-milestone" subType="x-preverse"/> indicates the start of the content that is stored in the index as part of the verse but should come before the verse.
The <div eID="pv1" type="x-milestone" subType="x-preverse/> indicates the end of the content that should come before the verse. This is the important element as it indicates the position that a verse number should appear.
These preverse markup is only needed for canonical verses, and not for verse 0.
Hope that helps.
On Aug 6, 2013, at 11:20 AM, David Haslam <dfhmch at googlemail.com> wrote:
> Thanks DM for the further clarification.
> So, if my understanding is correct, osis2mod version 1.7.0 transforms the
> OSIS such that because at least one instance of "preverse" content must use
> the milestone form of the div element, then all div elements in the module
> must also be the milestone form rather than the container form.
> This raises a further issue, which is whether the identifiers for such
> milestone pairs can have (in effect) a quasi-nesting problem, due to how
> osis2mod applies its transformations.
> What I mean is this:
> *Is this a correct outcome?*
> <div type="x-milestone" subType="x-preverse" sID="pv1"/>
> <div sID="gen2" type="paragraph"/>
> <div type="x-milestone" subType="x-preverse" eID="pv1"/>
> <div eID="gen2" type="paragraph"/>
> (where the semantic title & text content I have replaced by ".....")
> As you will readily observe here, these milestone div element pairs now
> Does this confuse the SWORD engine?
> The above observation was made by examination of the output from mod2imp
> (same build).
> Best regards,
> View this message in context: http://sword-dev.350566.n4.nabble.com/MinimumVersion-property-in-module-conf-files-tp4652983p4652996.html
> Sent from the SWORD Dev mailing list archive at Nabble.com.
> sword-devel mailing list: sword-devel at crosswire.org
> Instructions to unsubscribe/change your settings at above page
-------------- next part --------------
A non-text attachment was scrubbed...
Size: 4145 bytes
Desc: not available
More information about the sword-devel