mvnForum Homepage


Posted by Osk at Oct 15, 2009 12:00:01 AM
Re: Total newbie here - any templates for making a commentary module?
I'm afraid we don't have any example commentaries in OSIS. I'm sure you've already spotted http://www.crosswire.org/wiki/OSIS_Commentaries, but as it shows, the fundamental difference between Bibles and commentaries is that Bibles use something like:

<verse osisID="Gen.1.1">Blah blah...</verse>


to contain the entries, while commentaries use something like:

<div type="section" annotateType="commentary" annotateRef="Gen.1.1"><p>Blah blah...</p></div>


The contents of these containers can be essentially the same. What makes commentaries significantly different from Bibles is that the basic Bible element (<verse>) takes an osisID to indicate its reference while a commentary's basic element (<div>) takes an annotateRef. OsisIDs must be either single verses or lists of verses, but annotateRefs can be single verses, verse ranges, or lists of verses or ranges. This gives the annotateRef a lot more versatility. It's also possible (in OSIS, though Sword couldn't currently take advantage of this) to have multiple <div>s carry annotateRefs that point to the same verse.