Verse parsing - eliranwong/UniqueBible GitHub Wiki

There are two methods UBA uses for verse parsing. It is controlled by the useFastVerseParsing config flag. By default it is set to False.

When useFastVerseParsing is False, it uses standard verse parsing. When true, it uses fast verse parsing.

Standard verse parsing is a very flexible way to parse, but at the cost of speed. Fast verse parsing is not as flexible, but processing verses more quickly.

Standard verse parsing

Book references must start with a capital letter, but supports all common abbreviations. Verses can be a range and multiple verses can be separated by a comma.

Gen. 1:1-15 Jn 3:16, Rm 5:8

It can process verse references anywhere in the string.

randometext abc Jn 3:16, randometext abc Rm 5:8 randometext abc

Right-click context menu "Run as Command" works with standard verse parsing.

Fast verse parsing

Book references can start with a lowercase letter and supports all common abbreviations. Can be a range and have multiple verses.

gen 1:15 jn 3:16, rm 5:18

Does not support verses located anywhere in the string.

Remarks:

Standard verse parsing is preferable to work with the following context menu features, as fast verse parsing does not parse mixed text.

  • Open Verses with

  • Compare Verses with

  • Parallel Verses with

  • Plugins > Interlinear Data

  • Plugins > Run as Command

Standard verse parsing works perfectly with the features above. If users want to use fast verse parsing with these features, text selection have to be very precise including bible verse reference only without mixed text.