[osis-core] Re: div types in OSIS
Todd Tillinghast
todd at snowfallsoftware.com
Mon Jan 3 21:39:51 MST 2005
Jim,
If it is a commentary then the normal book chapter verse reference
system is sufficient for what you are commenting on ("annotating") but
is not sufficient for the commentary itself.
The commentary is not ITSELF a Bible and as such would not naturally
take on book/chapter/verse type values for ITS osisID values. Rather it
would specify the reference range(s) that it is talking about using the
annotateRef attribute.
This leaves the osisID of the commentary open for your own "reference
system" (not likely to be widely used externally but could be useful).
You are free to declare a reference system identical to the Bible and
use it for your commentary but I wouuld caution you that it is unlikely
to give you the results you want because the document you are working on
is not three levels (book/chapter/verse) but rather many more levels.
I would suggest something like [BookName].[section name or section
number].[paragraph/line group/list/table number].[fragment
number].[fragment number] etc...
That way you would have osisIDs like 2Tim.S1.P1.1.2 for the second
fragment in the first fragment in the first paragraph in the first
section in 2Tim.
Todd
Jim_Albright at wycliffe.org wrote:
> This is a commentary. The normal book chapter verse reference is
> sufficient.
>
> I don't see how annotateRef really helps me. My goal is to encode the
> commentary so that I have preserved all the logical divisions and then be
> able to round trip the OSIS document to Word ML.
>
> What I need is several sub levels to hold the verseFragment and
> verseFragment2, etc in.
>
> Jim Albright
> 704 843-0582
> Wycliffe Bible Translators
>
>
>
>
>
>
> Todd Tillinghast <todd at snowfallsoftware.com>
> 01/03/2005 04:33 PM
>
>
> To: Jim_Albright at wycliffe.org
> cc: Patrick.Durusau at sbl-site.org, Dennis Drescher <dennis_drescher at sil.org>,
> Jeff_Gayle at sil.org, Larry_Waswick at sil.org,
> osis-core at bibletechnologieswg.org, osis-user at whi.wts.edu, sderose at acm.org,
> todd at contentframeworks.com
> Subject: Re: div types in OSIS
>
>
> Jim,
>
> Is this a Bible or a Commentary (or a thing structurally like a
> Commentary) you are trying to encode? (Possibly, translators helps?)
>
> If it is the later you can use the annotateRef attribute (most likely
> with grain references) to precisely indicate not only the levels but
> also the exact portion of sub-text you are annotating. (You should be
> using annotateRef anyway if you are doing what I suspect you are doing.)
>
> Further if this is not a Bible you are free to define your own internal
> reference system and use osisID="A.A.1" then for its children
> osisID="A.A.1.1" and osisID="A.A.1.2", etc...
>
> Todd
>
> Jim_Albright at wycliffe.org wrote:
>
>>Here are the divs found in the wild in SIL commentary: Translator's
>
> Notes
>
>>on 2TI.
>>
>>name in TN level current working name
>
> OSIS
>
> ================================================================================
>
>>p-TitleCenterMedium a > main type="main"
>> b* > majorSection
>
> type="majorSection"
>
>>p-Box3Section c > section type="section"
>>p-Box4ParaNoSpace|p-Box4Paragraph d > paragraph
>
> type="paragraph"
>
>>p-VerseReference e > verseFragment
>
> type="???"
>
>>p-MarginSpaceB4[child::TextCited] f >
>
> verseFragment2 type="???"
>
>>p-IndentBlockSpaceB4[child::TextCited] g* >
>
> verseFragment3 type="???"
>
>>p-Indent1stSpaceB4[child::TextCited] h*>
>
> verseFramgent4 type="???"
>
>>* not in current work but projected to be found in other commentaries
>>based on style sheet info
>>
>>Here are my ponderings.
>>So I need to have a good OSIS name for the div's concerning
>>verseFramgments. I propose using "verseFragment" and then nesting
>>verseFragment to get the verseFragment2, verseFragment3, verseFragment4
>
>
>>as my first thought but I really don't like that solution.
>>
>>I considered using the 'n" attribute and using it to assign levels but
>>that is abusing the "n" attribute.
>>If there were a generic "level" attribute I could use that.
>>
>>The following might work:
>>
>>level current working name OSIS
>>==================================
>> a > main subtype="1"
>> b* > majorSection subtype="2"
>> c > section subtype="3"
>> d > paragraph subtype="4"
>> e > verseFragment subtype="5"
>> f > verseFragment2 subtype="6"
>> g > verseFragment3 subtype="7"
>> h*> verseFramgent4 subtype="8"
>>
>>I can't use just plain <div><div> and count how many level's are above
>
> it
>
>>as majorSection can be omitted. I guess I could use
>>a plain <div> for verseFragment and then nest <div>s for the other
>>verseFragments.
>>
>>level current working name OSIS
>>==================================
>> a > main div[@type="main"]
>> b* > majorSection div{@type="majorSection"]
>> c > section div[@type="section"]
>> d > paragraph div[@type="paragraph"]
>> e > verseFragment div[@type="paragraph"]/div
>> f > verseFragment2
>
> div[@type="paragraph"]/div/div
>
>> g > verseFragment3
>
> div[@type="paragraph"]/div/div/div
>
>> h*> verseFramgent4
>
> div[@type="paragraph"]/div/div/div/div
>
>>
> *********************************************************************************
>
> *********************************************************************************
>
> *********************************************************************************
>
>>I still would prefer:
>>level current working name OSIS
>>==================================
>> a > main div[@type="main"]
>> b* > majorSection div{@type="majorSection"]
>> c > section div[@type="section"]
>> d > paragraph div[@type="paragraph"]
>> e > verseFragment div[@type="verseFragment"]
>> f > verseFragment2
>
> div[@type="verseFragment2"]
>
>> g > verseFragment3 div[@type="verseFragment3"]
>> h*> verseFramgent4 div[@type="verseFragment4"]
>>
>
> *********************************************************************************
>
> *********************************************************************************
>
> *********************************************************************************
>
>>or possibly
>>level current working name OSIS
>>==================================
>> a > main div[@type="main"]
>> b* > majorSection div{@type="majorSection"]
>> c > section div[@type="section"]
>> d > paragraph div[@type="paragraph"]
>> e > verseFragment div[@subtype="verseFragment"]
>> f > verseFragment2
>
> div[@subtype="verseFragment2"]
>
>> g > verseFragment3 div[@subtype="verseFragment3"]
>> h*> verseFramgent4 div[@subtype="verseFragment4"]
>>but this seems a bit strange to me.
>>
>>Since there are so may div types I would prefer to add some more in
>
> order
>
>>to handle commentaries.
>>
>
> *********************************************************************************
>
>>I still would prefer:
>>level current working name OSIS
>>==================================
>> a > main div[@type="main"]
>> b* > majorSection div{@type="majorSection"]
>> c > section div[@type="section"]
>> d > paragraph div[@type="paragraph"]
>> e > verseFragment div[@type="verseFragment"]
>>Grace, mercy and peace from God the Father and Christ Jesus our Lord:
>>
>> f > verseFragment2
>
> div[@type="verseFragment2"]
>
>>Grace:
>>mercy:
>>peace:
>>God the Father:
>>
>> g > verseFragment3 div[@type="verseFragment3"]
>> h*> verseFramgent4 div[@type="verseFragment4"]
>>
>
> *********************************************************************************
>
>>
>>
>>Jim Albright
>>704 843-0582
>>Wycliffe Bible Translators
>>
>>
>>
>
>
>
>
>
More information about the osis-core
mailing list