Talk:OSIS Bibles

From CrossWire Bible Society
Revision as of 18:46, 24 April 2009 by Osk (talk | contribs) (Milestoned version of <chapter>)

Jump to: navigation, search

Display outside <verse>

Dowens just added the following comment: "Also, a quirk of the SWORD compilation process is that the only kind of content which reliably displays outside of <verse> elements are titles."

If this was the case, it may no longer be the case for osis2mod. I'm not familiar with a specific instance where this has been a problem, since I believe we maintain everything except <verse> elements themselves. That being said, if there is an issue, my guess would be that it is a frontend and/or filter issue--not an issue with the compilation process. Probably this needs some more investigation (and for bugs to be filed as appropriate). --Osk 00:50, 29 November 2008 (UTC)

Late response. Osis2mod takes all interverse material and either appends it to the prior verse or puts it into a x-preverse title. In doing this, it re-arranges the tags if needed. I am working on the implementation of a <div subType="x-preverse" sID="xxx"/>...<div subType="x-preverse" eID="xxx"/> to replace it. I hope to be done within the next week.--Dmsmith 11:33, 24 April 2009 (UTC)

Milestoned version of <chapter>

The section about milestones states, "There are a couple of instances where the milestoned version of <chapter> must be used. eg: when the paragraph is spanning over a chapter." IMHO, it would be helpful to cite both such instances, and give examples of Bible versions where this occurs. David Haslam 12:15, 22 April 2009 (UTC)

I gave the example of the Sermon on the Mount having a quote that spans several chapters. Osk removed it. One can naturally start the quote in chapter 5 and artificially end it at the end of 5, only to artificially start at the beginning of chapter 6 and also artificially end it at the end of the same chapter and thus to artificially start it at the beginning of chapter 7 and finally ending it at the natural place in chapter 7. This is unnecessary and current osis2mod does not require it. Just have the start quote in Matt 5 and the end in Matt 7, using milestoned chapters in between. Once milestoned chapters are used anywhere, OSIS "requires" that they are used everywhere. If quotes are not marked up, then this example, of course, does not pertain.--Dmsmith 01:18, 24 April 2009 (UTC)

I take that back. One can have a milestoned quote start in chapter 5 and a matching milestoned end in chapter 7. This was Osk's comment in removing it. Even chapter spanning paragraphs are not a necessary requirement for milestoned chapters. There is a milestoned version of the paragraph: <div type="paragraph" sID="xxx"/> ... <div type="paragraph" eID="xxx"/>. I was hesitant to mention this, but now SWORD supports this and osis2mod uses it instead of it's proprietary <lb> hack.--Dmsmith 11:15, 24 April 2009 (UTC)
Regarding milestoned paragraphs: Not quite.... There are a few instances of of unfortunate homonymy in OSIS. I think that the difference between <chapter> and
is fairly well understood. The former is meant for Bible chapters and the latter for any other type of chapter in any other type of book. Similarly


have different meanings. A <p> is the normal sense of paragraph (a block of one or more sentences without any linebreaks, probably relating to a single topic). A
is a text division equivalent to a section, sub-section, or chapter. It could very well contain one or more <p> elements. Or it might start with a <title> followed by <p>s or other
s for sub-paragraphs. It was specifically intended for documents that have "paragraphs" as a named division type. Law texts would be one example of a text using paragraphs in this sense. I believe the Catechism of the Catholic Church also uses paragraphs in this sense. So <p> really wasn't intended ever to be milestoned. --Osk 18:46, 24 April 2009 (UTC)
Small comment on my removal of your content from the article: I don't disagree that this is a good case for using milestoned chapters. That's quite possibly a better way to encode the Sermon on the Mount. But the text of the article, as worded, specifies instances where "milestoned version of <chapter> must be used" (emphasis mine), which this isn't. --Osk 18:29, 24 April 2009 (UTC)