Talk:Converting SFM Bibles to OSIS
- 1 Paratext USFM stylesheet, version 2.2
- 2 Paratext export to XML
- 3 Who May Use Paratext
- 4 Converting OSIS to USFM
- 5 Broken links for UBS-ICAP
- 6 xreffix.pl
- 7 Converting files received in miscellaneous formats to USFM
- 8 Using SFMToOSIS
- 9 checkbible ?
- 10 The Every Tribe Every Nation initiative
- 11 Haiola?
Paratext USFM stylesheet, version 2.2
There has been an update to the Paratext USFM stylesheet, version 2.2, Updated October 17, 2008. See . This update post-dates the making of Go Bible Creator version 2.3.2 which was the first to provide some support for USFM as source text format. CrossWire programmers who make use of the USFM stylesheet standards will need to take note of the changelog. I have also flagged this to the SWORD Dev mailing list. David Haslam 14:37, 8 December 2008 (UTC)
- I suggest that CrossWire programmers who make reference to external standards make use of the excellent service provided by http://www.changedetection.com/ to be alerted by email when there are changes to websites like this. David Haslam 14:46, 8 December 2008 (UTC)
Paratext export to XML
The UBS page about Paratext includes this sentence, "Paratext also provides function for exporting text to RTF and XML formats." I have been informed that these XML export formats include OSIS in either the milestoned form (BSP) or the containerized form (BCV). Has anyone in CrossWire compared the direct Paratext export XML formats with what we can obtain using either the Snowfall software conversion tool or the CrossWire conversion script? David Haslam 13:07, 5 June 2009 (UTC)
- One of my contacts emailed me (2009-05-15) as follows, "I was talking with the UBS Paratext folks yesterday about OSIS output and they let me know that they can do that to a degree. I tried using Paratext 6.1's "Convert from USFM to OSIS (Best Practices)" facility, which is found under the "Checking=>Publishing" menu. That generated cleaner OSIS that validated and didn't require an intervening XSLT (it has an option to not do milestones)." The latter option is relevant in the context of using Go Bible Creator, which for OSIS requires BCV, rather than BSP with milestones. He continued, "... Inasmuch as the Paratext conversion facility seems to work better than SFMToOSIS, I'll stick with that for now. Paratext 7 will also support this.". David Haslam 16:00, 6 June 2009 (UTC)
Who May Use Paratext
The UBS page also states,
- The Paratext program and its associated text files have been developed by the United Bible Societies for use by its translations project teams. Paratext is also made available for use by other Bible agencies for whom a formal licensing arrangement with UBS has been established. Persons qualified to use Paratext will include translation consultants, translators, reviewers, and those directly engaged in the translation's production. Copyright restrictions, especially those determined by third party copyright holders, require that use and distribution of Paratext be strictly limited to those engaged in Bible translation (as outlined above).
Seeing as CrossWire could be properly classified under "other Bible agencies", has there been any move towards negotiating a formal licensing arrangement for CrossWire members? David Haslam 13:14, 5 June 2009 (UTC)
Converting OSIS to USFM
- Has anyone tried using it in this direction? David Haslam 12:04, 4 May 2010 (UTC)
- Description also includes, "A newer version is being developed with a graphical user interface for non-technical users that includes workflow tracking, keyboarding from scratch, and converting from formats other than USFM/SFM files." David Haslam 12:07, 4 May 2010 (UTC)
Please provide a link for xreffix.pl David Haslam 09:47, 11 December 2010 (UTC)
Converting files received in miscellaneous formats to USFM
Based on the experience of several CrossWire volunteers, it would be useful to start a new page with advice on converting files received in miscellaneous formats to USFM. David Haslam 20:14, 13 December 2010 (UTC)
- Do we have much experience in that? Even if so, is it really our place to provide this information or to encourage movement of data to USFM? --Osk 22:06, 13 December 2010 (UTC)
- Section being removed from main page - links to the software are now broken. David Haslam 02:14, 13 January 2012 (MST)
SFMToOSIS is a robust, but somewhat difficult to setup and use, program produced by Snowfall Software. The program requires that you install a Python interpreter and that the interpreter be within the system path. The program can also convert OSIS files back to SFM. SFMToOSIS more robust than usfm2osis.pl and more likely to produce valid OSIS files automatically. The program has been renamed as OSIS Conversion Utility but comes under the heading Scripture Preservation Utility.
The program also requires a Paratext .ssf file. If you do not have such a file, you can use the following sample and adjust it to the specifics of your own text:
<ScriptureText> <BooksPresent>111111111111111111111111111111111111111111111111111111111111111111000000000000000000000000000000000</BooksPresent> <Encoding>UTF-8</Encoding> <ChapterMarker>c</ChapterMarker> <Copyright></Copyright> <FileNameForm>41MAT</FileNameForm> <FileNamePostPart>.SFM</FileNamePostPart> <FileNamePrePart></FileNamePrePart> <FullName>The Bible in English</FullName> <Language>ENGLISH</Language> <LeftToRight>T</LeftToRight> <Name>EN</Name> <VerseMarker>v</VerseMarker> <Versification>4</Versification> </ScriptureText>
Next, update the run.bat file that came with SFMToOSIS to point to your SFM files and SSF file. Then run run.bat.
In Stage 1, the command checkbible is generally unknown and requires explaining. David Haslam 09:51, 14 January 2012 (MST)
- At a guess, it's the name of a script file that calls xmllint with command line parameters supplied to validate the specified OSIS XML file against the schema. David Haslam 09:56, 14 January 2012 (MST)
The Every Tribe Every Nation initiative
As there is a real prospect for CrossWire to eventually become an approved End-User-Ministry-Partner (EUMP) within the framework of the Every Tribe Every Nation initiative, it makes good sense to gain a better knowledge of how UBS & SIL are using OSIS. This is why I have just added further details about the OSIS files exported from Paratext. We need to learn more. David Haslam 01:25, 23 April 2012 (MDT)