Difference between revisions of "List of eXtensions to OSIS used in SWORD"

From CrossWire Bible Society
Jump to: navigation, search
m (x-preverse: correction to sID and eID in usage rule)
(x-added: added description and link)
Line 18: Line 18:
  
 
=== x-added ===
 
=== x-added ===
 +
This can be useful as a workaround for places where the text added by the translator is within a '''w''' element. It's designed as a value of the attribute '''subType''' within the '''seg''' element. See note in [[OSIS Bibles#Recommended_approach|OSIS Bibles]].
  
 
=== x-glossary ===
 
=== x-glossary ===

Revision as of 15:43, 27 April 2012

New page under construction.

Purpose

This page is intended to be a one-stop reference which lists all the extensions to OSIS recognized by the SWORD API.

Introduction

The OSIS reference standard permits custom extensions to XML elements in the form of attribute values with the prefix x-. [1]

Several such extensions are already in use by the SWORD API and are designed to facilitate solutions (or workarounds) to particular requirements that arise in the course of module creation.

Note:

  1. In rarer cases, the x-prefix has been used to define an attribute name or even an element name.

The list

When documenting these extensions in this page, please keep them in alphabetical order.
State clearly which OSIS element and attribute they apply to, and most importantly, include any rules that govern their proper use.

x-1, x-2, etc

x-added

This can be useful as a workaround for places where the text added by the translator is within a w element. It's designed as a value of the attribute subType within the seg element. See note in OSIS Bibles.

x-glossary

x-intro

x-preverse

This can be used within the title element as a value of the attribute subType.

It provides a means to correctly display a title just before the current verse. For proper use, the title element must occur within the verse element, or (for milestoned OSIS) after the verse sID milestone and before the eID milestone for the same verse or verse range. Failure to adhere to this rule can have the adverse effect of making the title display before the previous verse, or (worse still) in the previous chapter.

x-testament

x-transChange

x-Strongs:...

x-unit

The div attribute x-unit provides a level of division between book and chapter. It is sometimes used in GenBook modules.

x-variant