[sword-devel] preverse divs

Thu Mar 1 13:56:26 MST 2012

Not sure if my initial email went through, but I will take up the task 
of creating an example OSIS document. I started one at 
http://www.crosswire.org/wiki/OSIS_Bibles/BCVExample. It probably does 
not validate yet, so don't jump on me yet. I need to go but will work 
more on it later. I will eventually add an example with the other 
structure.

Daniel

On 03/01/2012 02:18 PM, Troy A. Griffitts wrote:
> Patrick,
>
> Well, the KJV2003 project would have been my idea fore best practices 
> markup for OSIS, but it now lives at the KJV2006 and I would guess now 
> represents DM's idea of best practices for OSIS markup :)
>
> The tutorials also were meant to iterate the most used features of 
> OSIS to give an example of best practice markup for that feature.  We 
> should include a link to a concise, representative, validating OSIS 
> document which includes all of these features.
>
> Anyone up for the task?
>
> Troy
>
>
> On 02/29/2012 07:23 PM, Patrick Zimmermann wrote:
>> On Wednesday, 29. February 2012 15:29:31 Troy A. Griffitts wrote:
>>> On 02/29/2012 01:21 PM, Peter von Kaehne wrote:
>>>> Ok,
>>>>
>>>> Just my 2p to the matter:
>>>>
>>>> There are several versions of osis2mod about which produce different
>>>> results.
>>>>
>>>> I learned the hard way that other than by adding x-preverse to most
>>>> titles etc things do NOT work.
>>>
>>> Dear Peter,
>>>
>>> If you ever find that you need to manually add x-preverse to your OSIS
>>> text before importing then a bug should be raised either here or in 
>>> jira
>>> about what standard OSIS markup doesn't get imported correctly via
>>> osis2mod.
>>>
>>> I realize often you just need to get something to work quickly, but 
>>> this
>>> doesn't help us solve the core problem moving forward.
>>>
>>> The clear specification is OSIS.  You should never need to add any
>>> custom tags to your document.  Again, that's the goal in a perfect
>>> world.  I believe we have somewhere a 'best practices' document for 
>>> OSIS
>>> markup which is know to work with osis2mod.
>>
>>
>> Hello Troy,
>>
>> Do you know where that 'best practices' document is? I have been eagerly
>> searching for one in vain some time ago. I thus started my own 
>> showcase OSIS
>> module which produces terrible output for much of the syntax it tries 
>> to show.
>> If there is such a document already, I can gladly throw my miserable 
>> approach
>> away.
>>
>> Patrick
>>
>>
>>> We have about 5 OSIS
>>> tutorials floating around and I'm not sure what state they are all in,
>>> but they should probably be clean up to give you what you ask for 
>>> below,
>>> 'a clear specification to work to'.
>>>
>>> http://crosswire.org/osis/tutor.jsp
>>> http://crosswire.org/wiki/OSIS_Tutorial
>>> http://crosswire.org/wiki/OSIS_Bibles
>>> http://crosswire.org/wiki/OSIS_Commentaries
>>> http://crosswire.org/wiki/OSIS_Genbooks
>>>
>>>
>>> Troy
>>>
>>>> But recently things have become more broken and it has become a 
>>>> mess to
>>>> figure out.
>>>>
>>>> It is not all engine as modules produced in different times have
>>>> different level of "properness".
>>>>
>>>> It would be great if we as module makers had a clear specification to
>>>> work to - whatever that is - and then could dump the module into
>>>> osis2mod and get a working module.
>>>>
>>>> At the moment we do not.
>>>>
>>>> Peter
>>>>
>>>> -------- Original-Nachricht --------
>>>>
>>>>> Datum: Wed, 29 Feb 2012 12:39:19 +0100
>>>>> Von: "Troy A. Griffitts"<scribe at crosswire.org>
>>>>> An: SWORD Developers\' Collaboration Forum<sword-devel at crosswire.org>
>>>>> Betreff: Re: [sword-devel] preverse divs
>>>>>
>>>>> I don't know what's wrong except what I noted in the previous 
>>>>> post: that
>>>>> there is something wrong.
>>>>>
>>>>> I want to clear up one thing that seems to be a general
>>>>> misunderstanding:
>>>>>
>>>>> Module makers should never care or know about x-preverse.
>>>>> They should make their module how they think best conforms to the 
>>>>> OSIS
>>>>> specification.
>>>>> osis2mod will add the x-preverse div to the section it things 
>>>>> should be
>>>>> associated with a verse but display before the verse marker.
>>>>>
>>>>> .... in a perfect world anyway.  That's the goal, at least, and
>>>>> depending on who's reverted whom's revert, it might work that way 
>>>>> now.
>>>>>
>>>>> On 02/29/2012 11:09 AM, David Haslam wrote:
>>>>>> Hi Troy,
>>>>>>
>>>>>> I just tried wrapping the first "section title" for Matt.1.1 as
>>>>>> follows:
>>>>>>
>>>>>> <div type="section">
>>>>>> <div type="x-milestone" subType="x-preverse" sID="pv1"/>
>>>>>> <title>Lignez Jezuz</title>
>>>>>> <div type="x-milestone" subType="x-preverse" eID="pv1"/>
>>>>>> <verse sID="Matt.1.1" osisID="Matt.1.1"/>
>>>>>> Levr lignez Jezuz-Krist, Mab David, Mab Abraham.
>>>>>> <verse eID="Matt.1.1"/>
>>>>>>
>>>>>> After rebuilding the module, the title "Lignez Jezuz" had 
>>>>>> disappeared
>>>>>
>>>>> when
>>>>>
>>>>>> viewed with *Xiphos 3.1.5* (in Windows).  In its place there 
>>>>>> seemed to
>>>>>
>>>>> be an
>>>>>
>>>>>> extra space.
>>>>>>
>>>>>> It was there before, albeit displayed after the verse tag.
>>>>>>
>>>>>> So what's wrong?
>>>>>>
>>>>>> cf. In *BibleDesktop 1.6*, the same title is still displayed, and 
>>>>>> still
>>>>>> after the verse tag and a line break.
>>>>>>
>>>>>> The phrase "not yet supported" seems to be a considerable
>>>>>
>>>>> understatement.
>>>>>
>>>>>> Regards,
>>>>>>
>>>>>> David
>>>>>>
>>>>>> -- 
>>>>>
>>>>>> View this message in context:
>>>>> http://sword-dev.350566.n4.nabble.com/preverse-divs-tp4429131p4431114.ht 
>>>>>
>>>>> ml
>>>>>
>>>>>> 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
>