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
Support milestones (add element ms) #26
Since the boundaries of the content being marked may cross one or more paragraph boundaries, a milestone is always an empty element and should be written using the self-closing syntax, like
This is the USX companion to USFM 3.0 proposal "Syntax for milestones". See: ubsicap/usfm#33 for detail.
Indicating Start and End Milestones
Milestones do not need to occur in pairs or require the use of start
Example: (note use of the
USX does not formally provide any specific standalone milestone types. This may change with future updates to USX 3.x, as use of milestones highlights specific needs.
The following optional attributes can be added to any USX milestone element.
<ms style="qt-s" id="qt123" who="Pilate"/>“Are you the king of the Jews?” <ms style="qt-e" id="qt123"/>
Additional attributes may be required by a specific milestone
As with USX
<para style="p"><verse number="22" style="v" />Paul stood up in front of the city council and said, <ms style="qt1-s" who="Paul"/>“I see that in every way you Athenians are very religious. <verse number="23" style="v"/>For as I walked through your city ... ... Yet God is actually not far from any one of us; <verse number="28" style="v"/>as someone has said,</para> <para style=q1><ms style="qt2-s who="someone"/>‘In him we live and move and exist.’ <ms style="qt2-e/> <para style="b"/> <para style="m">It is as some of your poets have said,</para> <para style="q1"><ms style="qt2-s" who="some poets"/>‘We too are his children.’ <ms style="qt2-e"/></para> ... <verse number="31" style="v"/>For he has fixed a day in which he will judge the whole world with justice by means of a man he has chosen. He has given proof of this to everyone by raising that man from death!”<ms style="qt1-e"/>
The unnumbered version may be used when only one level of marker exists within the project text. Numbers should always be included when more than one level of the marker exists within the project text.
3.0 Milestone Styles
Specific milestone @Style types may provide additional attributes for encoding additional properties.