Frontends:URI Standard

From CrossWire Bible Society
Revision as of 04:21, 8 April 2010 by Tonny.kohar (talk | contribs) (Current situation)

Jump to: navigation, search

Some SWORD front-ends handle bible: or sword: as URIs. This necessitates having a standard for new and existing front-ends. A Bible URI standard is also necessary for Bookmarks Standard.

Current situation


Xiphos handles URIs in following format:

  • sword://KJV/Gen.1.1
  • sword:///Gen.1.1 -- an empty module between // and / (implies use of whatever Bible module is current, or default).
  • sword://NETnote/1Cor.7.2#n3 -- a mid-page anchor reference named "n3", typically used for footnotes; can use either ! (OSIS) or # (ThML).
  • sword://Josephus//The+Antiquities+of+the+Jews/Book+1/Chapter+1/Section+4 -- non-bible module. The 2nd double "//" is because keys for genbooks begin with /, so the first double slash is URL syntax, the 3rd / is the end of the module name, and the 4th / is the beginning of the genbook key.
  • sword://WebstersLinked/EPHEMERIS -- dictionary references, dictionary keys have no slashes.



PocketSword currently internally handles the standard sword://module/key URIs but doesn't yet register itself with the OS to handle links from other apps. This needs to happen at some point! Probably for v1.3.0, when I refactor more of the code...... As PocketSword doesn't yet handle genbooks, I haven't looked into what the URI would be for a genbook.


Alkitab currently internally handles URI, however it is not exposed to user and does not yet register itself with the OS. We handle URI in the following format:


  • scheme = sword,bible,commentary,...
  • path = name of the book eg: KJV, ESV
  • fragment/Reference = the key eg: GEN 1 1


  • bible://Gen 1 1 // open Gen 1:1 without care which bible (probable currently open or get from user preferences)
  • bible://KJV/Gen 1 1 // open Gen 1:1 in KJV bible
  • sword://KJV/Gen 1 1 // open Gen 1:1 in KJV book
  • #Gen 1 1 // this is local anchor/fragment

If the specified path (book) is not in the correct category, the behaviour is unspecified eg:

  • bible://Calvin Institute/

As we know that Calvin Institute is not a bible category, it is a General Book category, as for now the behaviour is unspecified (not forced by the API), do as you wish. However, it is recommended to silently ignore by do not display anything, or show an error/message dialog