New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Link text (add \jmp ...\jmp*) #30

Closed
klassenjm opened this Issue Jul 13, 2016 · 0 comments

Comments

Projects
None yet
1 participant
@klassenjm
Contributor

klassenjm commented Jul 13, 2016

Proposal

  • Add character marker pair \jmp …\jmp* for “link text”.
    • Optionally used for associating linking attributes to a span of text when no other character level markup is applied to the same span.

A companion USX 3.0 proposal exists at: ubsicap/usx#23

Details

The USFM 3.0 "syntax for assigning word-level linking attributes" (#25) proposal defines a set of 3 attributes which can be added to any character level element to define linking.

In some cases the text which requires linking attributes may not be otherwise marked. In these cases, the \jmp ...\jmp* marker pair can be applied.

Examples

Glossary entry including a link reference to an external URL

\jmp gracious|link-href="http://bibles.org/search/grace/eng-GNTD/all"\jmp*

Reference to named target in same project

\p \v 2-6a From Abraham to King David, the following ancestors are listed: Abraham, 
Isaac, Jacob, Judah and his brothers; then Perez and Zerah (their mother was Tamar*), 
Hezron, Ram, Amminadab, Nahshon, Salmon, Boaz (his mother was Rahab*), Obed (his 
mother was \jmp Ruth|link-href="#article-Ruth"\jmp*), Jesse, and King David. 

May require nested markup.

\ef - \fr 1.2-6a: \fq Ruth: \ft A Moabite (Ruth 1.4). Only outstanding 
women were normally included in Jewish genealogical lists. See also: 
Article on \+jmp Ruth|link-href="#article-Ruth"\+jmp*\ef*
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment