Another small note on DisplayLevel, which was apparently defined in 2002 
on the mailing list, but never really documented:

An implementation of DisplayLevel should count up from the finest 
grained level of the current key. This wasn't quite clear from Troy's 
definition, since, whether you count from the top (book + chapter) or 
bottom (verse + chapter), it's two levels.

If you request the key /book/chapter/section/paragraph/verse from a book 
(assuming it's a valid reference) and DisplayLevel=2, then all 
descendants of /book/chapter/section/paragraph should be printed 
(including those that may be deeper than 
/book/chapter/section/paragraph/verse in the tree).

This was specifically defined for books like Josephus where the depth of 
the finest grain of text varies from book to book.

Interestingly, I think this provides nice behavior for references into 
that oddly versified Croatian Bible with PrAzar embedded in Dan 3, 
assuming the module is marked up as I had described (with PrAzar at the 
same level as a Dan 3 verse, and all of its verses one level deeper). 
With DisplayLevel=2, a request for any verse in Dan 3 should result in 
the printing of Dan 3 & the embedded PrAzar. On the other hand, a 
request for any verse in PrAzar should only result in the printing of 
all of PrAzar (since it has only one chapter).

--Chris


Troy A. Griffitts wrote:
> DisplayLevel=2 seemed to have been added to EVERY general book, a while 
> ago.  While I still have no idea who added these, DisplayLevel is a very 
> useful property for general books.
> 
> The usage for DisplayLevel=2 is when a general book is so finely indexed 
> that the lowest level of indexing is not typically what a user desires 
> to see when viewing.  This includes books indexed down to the verse 
> level, the line level, etc.  All Bibles are considered DisplayLevel=2, 
> as we typically display them in chapter context.
> 
> Other modules which included DisplayLevel=2.
> 
> The Didache (prefer chapter display):
> http://crosswire.org/study/bookdisplay.jsp?mod=Didache&gbsEntry=%2FDidache%2F1%2Fpreface
> 
> Hesychius Greek Lexicon:
> http://crosswire.org/study/bookdisplay.jsp?mod=Hesychius&gbsEntry=%2F%CE%91%2F%CE%91%CE%94%2F%CE%91%CE%94%CE%91%2F%CE%91%CE%B4%CE%B1%CE%BC#
> 
> Duke Databank of Papyrii:
> http://crosswire.org/study/bookdisplay.jsp?mod=DDP&gbsEntry=%2FPBrook%2F0%2F8%2Fv%2F1
> 
> The LXXM:
> http://crosswire.org/study/bookdisplay.jsp?mod=LXXM&gbsEntry=%2F3Mac%2F7%2F1
> 
> The Book of Jubilees:
> http://crosswire.org/study/bookdisplay.jsp?mod=Jub&gbsEntry=%2FJub%2F15%2F1
> 
> Packard Humanities Institute Early Secular Inscription Database
> http://crosswire.org/study/bookdisplay.jsp?mod=PHI_INS&gbsEntry=%2FThessaly%2FHellenika%2F1%2F%5BNONE%5D%2Fcopy+%5Bcf+text%5D%2F1A%2F1p1
> 
> Packard Humanities Institute Early Christian Inscription Database
> http://crosswire.org/study/bookdisplay.jsp?mod=PHI_CHR&gbsEntry=%2FGreece+%5BChr%5D%2FThess%2F2%2F%5BNONE%5D%2F%5BNONE%5D%2Fr%2F1p1#cv
> 
> 
> 
> Though most of these modules are still in beta and currently only 
> available on SWORDWeb, they are all examples of the kind of work 
> intended for DisplayLevel=2
> 
> _______________________________________________
> sword-devel mailing list: sword-devel@crosswire.org
> http://www.crosswire.org/mailman/listinfo/sword-devel
> Instructions to unsubscribe/change your settings at above page

_______________________________________________
sword-devel mailing list: sword-devel@crosswire.org
http://www.crosswire.org/mailman/listinfo/sword-devel
Instructions to unsubscribe/change your settings at above page

Reply via email to