Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Linking attribute for \xt ...\xt* (add link-href as default) #41
The example in the User Reference documentation for \cd has several verse numbers within the chapter description.
Genesis 1 (Russian Synodal, Protestant Version)
Other historic Bible translations have the same feature.
For Bible software developers to take advantage of these verse numbers in order for the user to click on any one of them and jump straight to the corresponding verse, these should be marked at character level.
In mobile applications with small screens, this would be especially beneficial to skip scrolling once you've found the chapter in such translations.
I therefore propose that \cdt ...\cdt* be defined for this very purpose. The example would then become:
NB. The final letter 't' in the marker denotes 'target' by analogy with how the word is used in \xt
Please refer to #34 to gain the context for this comment.
As regards chapter-less verse references, especially when these occur without a prefix abbreviation (as some translators are wont in some footnotes), I wonder whether there should be a new character level marker defined for this purpose? i.e. Like \xt_...\xt* but just for verse numbers.
This would solve this issue too, as a general purpose \xv would make \cdt redundant.
Background: @klassenjm (email to yours truly)
referenced this issue
Dec 8, 2017
As David suggests, it would be redundant to add another marker to USFM to indicate a target reference.
Adding another type of target reference marker (
In the existing USFM 3.0 spec, if a project was only interest in marking the verse numbers, they could use
In order to specify a link at this location, it could be extended with
This is going to remain in the backlog for now. An update will be made to the official USFM stylesheet for Paratext to allow
This would make
@DavidHaslam It could look that way, but it's a matter of how you define the appearance of \vp.
The latter comment about \xt is the course I think makes more sense. It makes it possible to use \xt ...\xt* for pointing a scripture reference targets more flexibly. In the same way that a couple character level markers have a default attribute in USFM 3, the default attribute for \xt ...\xt* would be
or the other examples suggested earlier.
It would not need to be written in the longer form of