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

From CrossWire Bible Society
Jump to: navigation, search
m (ESV module: level 3 heading)
(Why this page should prove useful: :Examination of existing modules for unsupported extensions may also suggest opportunities for further enhancements to the SWORD engine, especially if they are)
Line 6: Line 6:
  
 
:Further extensions were added by reference to <tt>usfm2osis.pl</tt> and to <tt>kjv.xml</tt>. [[User:David Haslam|David Haslam]] 05:30, 28 April 2012 (MDT)
 
:Further extensions were added by reference to <tt>usfm2osis.pl</tt> and to <tt>kjv.xml</tt>. [[User:David Haslam|David Haslam]] 05:30, 28 April 2012 (MDT)
 +
 +
:Examination of existing modules for unsupported extensions may also suggest opportunities for further enhancements to the SWORD engine, especially if they are used extensively, and when it would seem that their purpose was to affect how text is displayed. [[User:David Haslam|David Haslam]] 02:36, 1 May 2012 (MDT)
  
 
== Non-CrossWire OSIS eXtensions ==
 
== Non-CrossWire OSIS eXtensions ==

Revision as of 08:36, 1 May 2012

Why this page should prove useful

For a valid OSIS XML file to be "fit for purpose", it's necessary to know what to include in order to achieve the goal of making good SWORD modules. Though some of these extensions are already partially documented in existing wiki pages, there is no single place where they are all listed along with usage rules. As further pre-processing tools are being developed (such as USX to OSIS), having a one stop reference should be valuable to help developers ensure that they can take full advantage of existing solutions and workarounds. David Haslam 05:00, 27 April 2012 (MDT)

This page will be a 'work in progress' for a time. I have made a start by adding sections for extensions found by searching the wiki. the result of such a search is probably quite incomplete. Developers who work on the SWORD source code should be able to add further sections. David Haslam 05:11, 27 April 2012 (MDT)
Further extensions were added by reference to usfm2osis.pl and to kjv.xml. David Haslam 05:30, 28 April 2012 (MDT)
Examination of existing modules for unsupported extensions may also suggest opportunities for further enhancements to the SWORD engine, especially if they are used extensively, and when it would seem that their purpose was to affect how text is displayed. David Haslam 02:36, 1 May 2012 (MDT)

Non-CrossWire OSIS eXtensions

Please list any non-CrossWire OSIS eXtensions here in the talk page. David Haslam 11:45, 27 April 2012 (MDT)

SWORD and JSword

The page is intended to reflect what extensions are supported by the SWORD API. There is no guarantee that these extensions are also supported by JSword, albeit many of them are. David Haslam 05:26, 28 April 2012 (MDT)

Extensions no longer supported ...

If it turns out that I have listed any extension that is no longer supported by the latest release of the SWORD engine, please contact me before editing the main page. David Haslam 05:33, 28 April 2012 (MDT)

Likewise for any extension that was never supported. David Haslam 02:23, 1 May 2012 (MDT)

Extensions used in xulsword

Research here about OSIS extensions used in xulsword, but not yet implemented or adopted in SWORD.
For further details, see [1]. David Haslam 10:22, 28 April 2012 (MDT)

x-p-indent

This can be used within the milestone element as a value of the attribute type.

It's used to provide a poetry indentation as an alternative to using line elements with level attributes.
Currently, deeper indents are created by two or three <milestone type="x-p-indent" /> elements in series.

Extensions found in SWORD modules

Research here about OSIS extensions found in SWORD modules, for which the status of support by the SWORD engine is still unclear. Please remember to identify the particular module. David Haslam 02:26, 1 May 2012 (MDT)

ESV module

This is a list of all x-prefix extensions in the ESV module (along with a count in column 1):

05206	x-begin-paragraph
19805	x-br
00081	x-declares
05206	x-end-paragraph
00007	x-extra-space
11334	x-indent
00021	x-indent-2
02428	x-preverse
00001	x-psalm-book
00003	x-psalm-doxology
00179	x-same-paragraph
00074	x-selah
00001	x-speaker
00002	x-textual-note
00016	x-us-time