...
STEP has very strong support for versifications and supports a growing number of versifications. This is always done transparently. This means STEP can support searching across Bibles that are made of different versification. STEP can also display parallel views or interlinears and will transparently line up Psalm 3.1 in the Hebrew with Psalm 3.2 of the English text.
Options
Together with the search query (q=...), one can specify a set of options. These are used to adjust the display of search query. These are only used during Bible text retrievals and not during search results displays. In terms of the user interface, these are triggered by selecting the options from the 'cog menu'.
Note: Some options are defaulted if the options parameter is missing. Also some options (such as Words of Christ) are only available for some Bibles). If the option is not applicable, it will simply be ignored.
The following options are currently available:
| Initial | Meaning | Defaulted | Availability |
|---|---|---|---|
| H | Display headings | Y | All |
| V | Display verse numbers | Y | All |
| L | Display each verse on a separate line | N | All |
| R | Displays Jesus's words in red | N | Some modules only |
| E | Vocabulary in English interlinear | N | Strong-tagged Bibles If multiple Bibles are selected, all Bibles require strong tagging. |
| A | Ancient vocabulary interlinear | N | Strong-tagged Bibles If multiple Bibles are selected, all Bibles require strong tagging. |
| T | Transliterated vocabulary interlinear | N | Strong-tagged Bibles If multiple Bibles are selected, all Bibles require strong tagging. |
| D | Divides Hebrew words into colours for each segment (currently alternates between 2 colours) | N | OHB only |
| G | Displays all Greek accents | Y | Greek texts only |
| U | Displays all Hebrew vowels | Y | Hebrew texts only |
| P | Displays all Hebrew cantillation | N | Hebrew texts only |
| N | Displays notes and cross references | Y | Robinson-tagged texts only |
| M | Displays Grammar (morphology) as an interlinear | N | Robinson-tagged texts only |
| C | Colour code Grammar | N | Robinson-tagged texts only |
In order to obtain the currently available versions, there are two options, the first of which is preferred (though not always possible)
- Read the
step.keyedVersionsvariable from the browser's javascriptwindowcontext. - Until now, the only consumer of web services is STEP itself. The following call was used in a previous version and there are currently no consumers: http://<step-server>/rest/module/getAllModules/
It is usually recommended to leave the options out on the first call and allow the user to select the options through the cog menu.
Different display modes
STEP displays the Bible, commentaries and search results in different ways. There are 5 major ways of displaying these and all of them can be overridden through the 'cog menu'.
| Option | Meaning | Default conditions |
|---|---|---|
| NONE (or left blank) | A single version is displayed | A single Bible or commentary is selected |
| INTERLEAVED | Versions are displayed verse by verse in lines. ESV v1 a b c KJV v1 a b c -------------- ESV v2 a b c KJV v2 a b c | If two or more Bibles and/or commentaries are specified and at least one of them does not have strong tagging. (Commentaries never have strong tagging!). |
| INTERLEAVED_COMPARE | Similar to INTERLEAVED but highlights differences between versions. Where three or more versions are selected, the first version is compared to the other two. For three versions (A,B,C), the display will show A-B, A-C (i.e. 4 instances of each verse) | Never |
| COLUMN | Similar to INTERLEAVED but in a column/tabular format where each row is a verse and each column is a different version. | Never |
| COLUMN_COMPARE | Similar to INTERLEAVED_COMPARE and COLUMN. Displays in verses as rows and Bibles/commentaries as columns. Where three or more Bibles/commentaries are selected, the first resource is repeated. E.g. for 4 versions, A,B,C,D, 6 columns are displayed: A,B,A,C,A,D | Never |
| INTERLINEAR | Interlinear | If two or more Bibles are selected and all of them are tagged with strong numbers. |