On Nov 3, 2009, at 5:46 AM, <[email protected]> <[email protected]>
wrote:
Hi,
I'm trying to understand how to convert an osis file to a
functioning module
in a Sword frontend. I'm following the steps at the wiki
http://www.crosswire.org/wiki/DevTools:Modules, and using
sword-utilities-1.6.0-r2473.
John,
That page is not as useful as this one:
http://www.crosswire.org/wiki/Osis2mod
However, after 'importing' the osis file, or rather converting it to
four
files (ot.vss, ot, nt.vss, nt), I am not clear as to what to do
next. The
next step seems ambiguous:
"To compress a Bible, commentary, or LD module, use the mod2zmod
utility.
First you will need to install the module so that it can be accessed
using
the SWORD engine. Next, run:" and then gives the syntax for the
compression
executable mod2zmod. But does that mean that I should install the
module
before compressing it by running mod2zmod?
Don't use mod2zmod, rather use osis2mod to compress it.
Generally, I'll create the following folders in the same directory as
my xyz.xml file:
(where xyz is the lower case [name] of the module, in the conf.)
mods.d/
modules/texts/ztext/xyz/
In mods.d, I'll put my xyz.conf. Osis2mod does not need it, but it
makes a later step easier.
I'll then run the following:
osis2mod modules/texts/ztext/xyz xyz.xml -z
Then I'll package it as a "raw" zip file with:
(Note, XYZ is the exact casing of the [name] in the conf.)
zip -r XYZ.zip modules mods.d
During development it is useful to build an uncompressed module so you
can read the files. I generally will create a simple folder, say "raw"
for output (that way I don't have to dig down a long path for the
files). Since I am debugging, I'll often use the -d option on osis2mod
to mark each verse with it's reference:
osis2mod raw xyz.xml -d 2
If so, how do I install it? The
instructions later on for installing a module imply that a single
module or
folder with module files is produced. All I have is the four
files. I've
been unable to compress them, as mod2zmod is looking for a module
name,
which I don't have. Am I doing something wrong?
No you are not doing something wrong. Mod2zmod is very useful to
compress modules that are currently installed and not compressed. It
is awkward otherwise.
I think it will look for mods.d and modules in the current folder and
use mods.d/xyz.conf to find the module under modules/.
You might need to copy mod2zmod to the same folder as mods.d and
modules. (I think that is needed on Windows. It is not on the Mac or
on Un*x/Linux).
Hope this helps.
In Him,
DM
_______________________________________________
sword-devel mailing list: [email protected]
http://www.crosswire.org/mailman/listinfo/sword-devel
Instructions to unsubscribe/change your settings at above page
