[sword-devel] OSIS recommendations to SIL/JAARS

[DM Smith]

Michael,
It is good to hear from you again.

Couple of comments:
<p> does not have a milestoned form. These do cross verse boundaries  
and the semantics of <p> don't allow for it to simply be ended and  
restarted on verse boundaries. So I see several  options: 1) don't  
use <p> at all, 2) simulate <p> with something like <lb type="x-end- 
paragraph"/> and <lb type="x-start-paragraph"/> or 3) submit a change  
request against the OSIS spec or 4) always mark paragraphs between  
verses . I suggest 2 and 3, as 2 will allow a migration as the intent  
is clear. Having paragraphs start and end between verses is allowable  
in all cases.

You refer to XMLT. Is this a typo? Should it be XSLT?

With regard to quotes: Quotes frequently cross verse boundaries. This  
means with verses as containers that they need to be in the  
milestoned form: <q sID="xxx"/> and <q eID="xxx"/>. In your sample  
text you have </q marker="'"> This is improper.

When using milestoned elements it is easy to produce valid but poor  
OSIS with respect to overlapping elements. When considering just the  
milestoned sID/eID pairs, they should not overlap as in:
<div sID="xxx"/>....<q sID="aaa"/>.....<div eID="xxx"/>....<q  
eID="aaa"/>

Likewise, it is easy to produce the following which is also not  
recommended:
<div sID="xxx"/>....<verse>.....<div eID="xxx"/></verse>
Here a division element ends right before the verse end.

Having elements between verses is sometimes problematic for verse at  
a time processing. Such software needs to guess when looking at a  
single verse whether to append or prepend some or all of the  
interverse content. It should be used sparingly, and consistently.

Hope this helps.

In His Service,
	DM

On Jul 23, 2007, at 8:46 PM, Kahunapule Michael Johnson wrote:

> DM, I hope the following document accurately reflects the dialect of
> OSIS we discussed:
>
> http://ebible.org/translation/SaneOSIS.htm
>
> Any comments? Typos? Improvement suggestions?
>
> Yes, I know the dialect of OSIS documented above isn't what I generate
> with the WEB & HNV, yet, but I plan to make it so.
>
> I'll be hiding in the higlands of Papua New Guinea...
>
> Michael
>
>
>
> _______________________________________________
> sword-devel mailing list: sword-devel at crosswire.org
> http://www.crosswire.org/mailman/listinfo/sword-devel
> Instructions to unsubscribe/change your settings at above page