[sword-devel] Scope

Thu Jan 8 07:15:13 MST 2015

I think there's a bit of confusion here.

JSword is enhanced to automatically populate a new "side conf file" which
sits along side the existing SWORD conf file that the user downloads. The
two fields are to record the list of books (OSIS Book abbreviations space
separated) and list of verses (OSIS ref format).

The fields get populated by the JSword engine as soon as the frontend
develop calls that method (lazily populated)

As an example, the following information is stored for the ESV module under
~/.jsword/jsword-mods.d/esv.conf

[ESV]
Scope=Intro.OT-Mal.4.5 Intro.NT-Matt.12.46 Matt.12.48-Matt.17.20
Matt.17.22-Matt.18.10 Matt.18.12-Matt.23.13 Matt.23.15-Mark.7.15
Mark.7.17-Mark.9.43 Mark.9.45 Mark.9.47-Mark.11.25 Mark.11.27-Mark.15.27
Mark.15.29-Luke.17.35 Luke.17.37-Luke.23.16 Luke.23.18-John.5.3
John.5.5-Acts.8.36 Acts.8.38-Acts.15.33 Acts.15.35-Acts.24.6
Acts.24.8-Acts.28.28 Acts.28.30-Rom.16.23 Rom.16.25-Rev.12.17
Rev.13-Rev.22.19
BookList=Gen Exod Lev Num Deut Josh Judg Ruth 1Sam 2Sam 1Kgs 2Kgs 1Chr 2Chr
Ezra Neh Esth Job Ps Prov Eccl Song Isa Jer Lam Ezek Dan Hos Joel Amos Obad
Jonah Mic Nah Hab Zeph Hag Zech Mal Matt Mark Luke John Acts Rom 1Cor 2Cor
Gal Eph Phil Col 1Thess 2Thess 1Tim 2Tim Titus Phlm Heb Jas 1Pet 2Pet 1John
2John 3John Jude Rev

Hope this helps.
Chris

On 8 January 2015 at 14:09, Jonathan Morgan <jonmmorgan at gmail.com> wrote:

> Hi DM,
>
> Thanks for the comment.
> I think caching brings us back to the question "Do we expect it to be at
> chapter level or at book level"?
> I think there are good arguments for chapter level being theoretically
> helpful, but it could make a cached conf string much more unwieldy.
> Which is JSword doing?
>
> Jon
>
> On Fri, Jan 9, 2015 at 12:49 AM, DM Smith <dmsmith at crosswire.org> wrote:
>
>> It is not fast, but is reasonably fast. It takes a look at the index file
>> (not the data file) to see what verses have size. If size is 0, then that
>> verse is not in the v11n. A book is present if all the verses have size 0.
>>
>> I’m pretty sure that both AndBible and STEP have this woven in.
>> BibleDesktop needs to be released soon.
>>
>> I think that *some* frontends cache that in the module’s conf as an
>> osisRef. BTW, cached in the module’s conf means it never gets out of date
>> or specified wrongly.
>>
>> I think that Scope (and BookList) should be handled like InstallSize.
>> That is, not specified by the module maker but computed and maintained on
>> the server.
>>
>> — DM
>>
>> On Jan 8, 2015, at 8:39 AM, Jonathan Morgan <jonmmorgan at gmail.com> wrote:
>>
>> Hi Peter,
>>
>> If I read Chris' comment correctly, you wouldn't need to do put anything
>> in the conf file.  It will automatically figure it out based on which books
>> (and possibly chapters?) are in the Bible.
>> This roughly matches the direction discussion took in the original
>> thread, as enough people found enough problems with having a scope
>> specifier in the conf file.
>>
>> So long as this performs OK I think it's a great solution, because it
>> tells you exactly what is in the Bible, and won't get specified wrongly or
>> fall out of date.
>> Main advantage: Module maker doesn't have to specify the scope.  It "just
>> works".
>> Main disadvantage: Frontend developers have to implement it :(
>>
>> Hope that makes sense.
>>
>> Jon
>>
>> On Thu, Jan 8, 2015 at 11:49 PM, Peter Von Kaehne <refdoc at gmx.net> wrote:
>>
>>> Ah brilliant.
>>>
>>> So something in Jsword but not yet in Sword?
>>>
>>> What is the exact syntax a conf file entry should have? I would try this
>>> out immediately.
>>>
>>> Peter
>>>
>>> *Gesendet:* Donnerstag, 08. Januar 2015 um 10:58 Uhr
>>> *Von:* "Chris Burrell" <chris at burrell.me.uk>
>>> *An:* "SWORD Developers' Collaboration Forum" <sword-devel at crosswire.org
>>> >
>>> *Betreff:* Re: [sword-devel] Scope
>>>  Hi David
>>>
>>> The discussion did result into code on the JSword project. We now have
>>> JSword specific configuration that is populated automatically by examining
>>> content (as well as front-end specific configuration).
>>>
>>> We have a 'scope' and a 'book list'
>>>
>>> Cheers
>>> Chris
>>>
>>>
>>> On 8 January 2015 at 10:51, David Haslam <dfhmch at googlemail.com> wrote:
>>>>
>>>> In another thread from 2008, Chris made an important observation about
>>>> OSIS
>>>> Scope.
>>>>
>>>> It's also a little ambiguous.
>>>> How many books are included in the scope Gen-Rev? 66? 73?
>>>> It's always depended on context.
>>>>
>>>> But as we have added av11n since then, this worry may no longer be
>>>> critical.
>>>>
>>>> Regards,
>>>>
>>>> David
>>>>
>>>>
>>>>
>>>> --
>>>> View this message in context:
>>>> http://sword-dev.350566.n4.nabble.com/Scope-tp4654525p4654527.html
>>>> Sent from the SWORD Dev mailing list archive at Nabble.com.
>>>>
>>>> _______________________________________________
>>>> 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
>>>>
>>>  _______________________________________________ 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
>>>
>>> _______________________________________________
>>> 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
>>>
>>
>> _______________________________________________
>> 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
>>
>>
>>
>> _______________________________________________
>> 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
>>
>
>
> _______________________________________________
> 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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.crosswire.org/pipermail/sword-devel/attachments/20150108/1ab73135/attachment.html>