[jsword-devel] Key issues

Tonny Kohar tonny.kohar at gmail.com
Tue May 13 19:43:36 MST 2008


Hi,

+ 1 for the "/" (slash) separator than "." (dot) separator.
So it will be look like something like
sword://KJV/Gen.1 rathen than sword://KJV.Gen.1
bible://KJV/Gen.1 rathen than bible://KJV.Gen.1
aka
[scheme://][path/][#][fragment]
scheme = sword,bible,commentary,...
path = name of the book eg: KJV, ESV
fragment/Reference = the key eg: GEN.1.1

Any idea regarding protocol scheme conventions ?
sword:// -> generic scheme
bible:// -> bible scheme
dictionary:// or def:// -> dictionary scheme
daily:// -> daily devotions
glossary:// - > glossary
etc

Does the syntax already agreed among developer and become recommendation ?

Cheers
Tonny Kohar


On Wed, May 14, 2008 at 3:47 AM, DM Smith <dmsmith555 at yahoo.com> wrote:
> DM Smith wrote:
>  > Brian Fernandes wrote:
>  >
>  >>> Could you not make the URL bible://ESV.gen.1?  That way, you keep all
>  >>> the info you need to make the right choices, independent of what's in
>  >>> the combo.  I don't know how difficult it would be to rework the
>  >>> protocol handler, though...
>  >>>
>
> >>> Unfortunately, I do not have a better suggestion, but will try to think
>  >>> one up.
>  >>>
>  >>>
>  >
>  > I think you are on the right track that you want a simple separator
>  > character that the browser can handle.
>  >
>  > I'm going to ask on sword-devel for their input.
>  >
>  >
>  >>  > As you can guess, the key to a GenBook entry is the entire path from
>  >>  > the root. Sword reserves '/' as a path separator.
>  >>
>  >> Cool, I will give that a try, if JSword does not parse it already I can
>  >> easily build it myself. I assume this means keys may not have "/" in
>  >> their names? But / does seem like the kind of character which could make
>  >> an appearance in a page heading? (though I have not seen one yet).
>  >>
>  >>
>  >
>  > I'll also ask this too.
>
>  The direction given by sword-devel:
>  The protocol should be sword:// not bible:// to be follow the standard
>  that the other Sword projects follow.
>
>  bible:// indicates that we are working with a Bible, but is misleading
>  when using non-bible modules.
>
>  After the protocol the suggestion is to have the module name followed by
>  a / and then the reference, as in:
>
> sword://KJV/Gen.1.1
>
>  For parallel view, I suggested and several others thought well of the
>  idea that the module name is a comma separated list:
>  sword://KJV,ESV/Gen.1
>
>  For GenBooks, which have hierarchical keys, there were two suggestions:
>  1) Use '/' as a path separator and use URL encoding for the spaces.
>  2) Use url encoding for the '/' and for the spaces.
>
>  MacSword has a mechanism to pass features, prefixing them to the request:
>  sword://strongsNumbers&versePerLine@KJV/Gen.1
>
>  I think it would be better to use ? at the end and then have the list as
>  this follows the URL syntax, as in:
>  sword://KJV/Gen.1?strongsNumbers=Y&versePerLine=Y
>
>  I don't think there is a standard set of these. I think it really boil
>  down to what the UI provides.
>
>
>
>  -- DM
>
>
>  _______________________________________________
>  jsword-devel mailing list
>  jsword-devel at crosswire.org
>  http://www.crosswire.org/mailman/listinfo/jsword-devel
>



-- 
Citra FX Photo Effects
imagine, design, create ...
http://www.kiyut.com



More information about the jsword-devel mailing list