mvnForum Homepage Welcome Guest  | Guest Setting  |  Register  |   Login
  Search  
Index  | Recent Threads  | Unanswered Threads  | Who's Online  | User List  | Help


»

No member browsing this thread
Thread Status: Active
Total posts in this thread: 8
Post new Thread
Author
Previous Thread This topic has been viewed 5776 times and has 7 replies Next Thread
Male hermeneutes
Regular



Poland
Joined: Feb 2, 2004
Post Count: 38
Status: Offline
Reply to this Post  Reply with Quote 
More help for utilities?

Hello from Poland!

Is there more help for the module making utilities in addition to the usage messages displayed when the command name is typed without parameters?

They are rather cryptic and I succeeded in making a Bible module only after a few trials and errors.

For example I don't know what 4 and 2 means as the last parameter of the imp2ld command.

Mor examples about markup would also be appreciated.

But I'm here not only to complain, I enjoy using the Sword project and already convinced a few other people to install it.

Best Regards,

Piotr
[Feb 2, 2004 2:32:08 AM] Show Printable Version of Post    View Member Profile    Send Private Message    Hidden to Guest    syntaxpb    217079784 [Link] Report threatening or abusive post: please login first  Go to top 
Male Osk
Developer
Member's Avatar


Joined: Sep 17, 2003
Post Count: 211
Status: Offline
Reply to this Post  Reply with Quote 
Re: More help for utilities?

Hello from Poland!

Is there more help for the module making utilities in addition to the usage messages displayed when the command name is typed without parameters?

You can find some more information in our Module Making Guide
They are rather cryptic and I succeeded in making a Bible module only after a few trials and errors.

For example I don't know what 4 and 2 means as the last parameter of the imp2ld command.

4 and 2 refer to the size (in bytes) of the record that holds the entry contents. If you use 2, your entries can never be larger than 64k.
Mor examples about markup would also be appreciated.

We leave markup decisions to outside standards. We recommend OSIS (and do not actively support any other markup standards). So the best places to look for markup help are the OSIS webpage and the BTG Portal.
But I'm here not only to complain, I enjoy using the Sword project and already convinced a few other people to install it.

Best Regards,

Piotr

We're glad you find the software useful and happy to help when you have questions.
[Feb 2, 2004 12:28:56 PM] Show Printable Version of Post    View Member Profile    Send Private Message [Link] Report threatening or abusive post: please login first  Go to top 
Male hermeneutes
Regular



Poland
Joined: Feb 2, 2004
Post Count: 38
Status: Offline
Reply to this Post  Reply with Quote 
Re: More help for utilities?


You can find some more information in our Module Making Guide

This guide is great and I would not be able to make a module without it, but it does not explain in detail how to use the utilities.
For example, I had a problem figuring out how vs2osisref works. When I typed:
vs2osisref John 3:16

the program returned:
<reference osisRef="John.1.1-John.21.25">John</reference>

i.e the range for the whole book
only when I eliminated the space and entered
vs2osisref John3:16

I got:
<reference osisRef="John.3.16">John3:16</reference>

But I had to find this out by trial and error.
Regards,

Piotr
[Feb 3, 2004 6:21:19 AM] Show Printable Version of Post    View Member Profile    Send Private Message    Hidden to Guest    syntaxpb    217079784 [Link] Report threatening or abusive post: please login first  Go to top 
Male Osk
Developer
Member's Avatar


Joined: Sep 17, 2003
Post Count: 211
Status: Offline
Reply to this Post  Reply with Quote 
Re: More help for utilities?


You can find some more information in our Module Making Guide

This guide is great and I would not be able to make a module without it, but it does not explain in detail how to use the utilities.
For example, I had a problem figuring out how vs2osisref works. When I typed:
vs2osisref John 3:16

the program returned:
<reference osisRef="John.1.1-John.21.25">John</reference>

i.e the range for the whole book
only when I eliminated the space and entered
vs2osisref John3:16

I got:
<reference osisRef="John.3.16">John3:16</reference>

But I had to find this out by trial and error.
Regards,

Piotr


In this case, the only documentation is that printed when you run vs2osisref with no arguments:
vs2osisref - a tool to convert verse references from English to OSIS
usage: vs2osisref <verse ref> [verse context]

Arguments within <> are required. Arguments withing [] are optional.

Your shell determines how arguments are handled and fed to our utility, and it could vary between shells. A space between John and 3:16 will probably indicate two arguments in any shell. So you're passing "John" as the verse reference and "3:16" as the verse context, which naturally results in return a reference to all of John.

Most shells (like bash) will allow you to pass arguments with spaces if you place them inside quotation marks, so
vs2osisref "John 3:16"

should return
<reference osisRef="John.3.16">John 3:16</reference>

[Feb 3, 2004 2:48:31 PM] Show Printable Version of Post    View Member Profile    Send Private Message [Link] Report threatening or abusive post: please login first  Go to top 
Male hermeneutes
Regular



Poland
Joined: Feb 2, 2004
Post Count: 38
Status: Offline
Reply to this Post  Reply with Quote 
Re: More help for utilities?

Speaking of bash, is there a Linux version of the module making utilities?

Regards,

Piotr
[Feb 4, 2004 3:15:41 AM] Show Printable Version of Post    View Member Profile    Send Private Message    Hidden to Guest    syntaxpb    217079784 [Link] Report threatening or abusive post: please login first  Go to top 
Male Osk
Developer
Member's Avatar


Joined: Sep 17, 2003
Post Count: 211
Status: Offline
Reply to this Post  Reply with Quote 
Re: More help for utilities?

Speaking of bash, is there a Linux version of the module making utilities?

Regards,

Piotr


Yes. Just download the latest version of the Sword source distribution and compile. You will find the utilities in the utilities directory.
[Feb 4, 2004 1:11:02 PM] Show Printable Version of Post    View Member Profile    Send Private Message [Link] Report threatening or abusive post: please login first  Go to top 
Male hermeneutes
Regular



Poland
Joined: Feb 2, 2004
Post Count: 38
Status: Offline
Reply to this Post  Reply with Quote 
Re: More help for utilities?

I'm not sure how to go about compiling on Linux.

Do you think you could post compiled utilities for Linux or send them to my e-mail address?

Or is compilation distribution dependent and you can't make utilities that will work on every distro?

Will appreciate. :)

Piotr
[Feb 18, 2004 3:03:42 PM] Show Printable Version of Post    View Member Profile    Send Private Message    Hidden to Guest    syntaxpb    217079784 [Link] Report threatening or abusive post: please login first  Go to top 
Male stryder144
Stranger




Joined: Mar 16, 2004
Post Count: 1
Status: Offline
Reply to this Post  Reply with Quote 
Re: More help for utilities?

I'm not sure how to go about compiling on Linux.

Do you think you could post compiled utilities for Linux or send them to my e-mail address?

Or is compilation distribution dependent and you can't make utilities that will work on every distro?

Will appreciate. :)

Piotr


Piotr,

You can try typing the following at the command line:
vi Makefile.cfg # make sure all user defined options are correct.
make
su
make install
make install_config

This would be from the directory that you untarred the source code for the sword project to. This link might help explain things a bit more.

Cheers
[Mar 19, 2004 2:50:54 PM] Show Printable Version of Post    View Member Profile    Send Private Message [Link] Report threatening or abusive post: please login first  Go to top 
Show Printable Version of Thread  Post new Thread