Difference between revisions of "Frontends:URI Standard"
From CrossWire Bible Society
m (anchor references in xiphos) |
|||
| Line 7: | Line 7: | ||
* '''sword://KJV/Gen.1.1''' | * '''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:///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://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. | * '''sword://WebstersLinked/EPHEMERIS''' -- dictionary references, dictionary keys have no slashes. | ||
Revision as of 21:06, 3 April 2010
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
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.
FireBible
PocketSword
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.
