Join GitHub today
GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together.Sign up
ca cp | va vp : specification allows standalone usage? (va with no v?, etc) #95
In an open issue here:
The included example Includes a canonical introduction to esther where all preface text is marked with cp and va.
It is possible that the USFM specification should be enhanced to clarify that the cp and ca are subordinate modifiers to a c tag, and that the va and vp tags are subordinate modifiers to a v tag. That is, the ca, cp, va, vp tags should not be used without their parent tags, as happens in this example. The documentation should state this more clearly.
Second, I've previously suggested that the \c 0 be included as a way to allow for canonical introductions. This issue is real and present, as can be seen in the example.
Thanks for pointing to this example. It appears to be a file containing "Esther Greek" (ESG) (portions of Esther found in the Greek translation of the Hebrew book of Esther). In my experience, these texts potentially ordered with chapter and verse markup in multiple different ways depending on the audience and church tradition the text is being published for, and how the text is published with or separate from the other parts of Esther. It has always been somewhat difficult to understand how the portions fit together, for me.
As USFM did emerge and grew out of some of the practices developed in the Paratext application, there was a need for markup which could identify the chapters and verses to actually display in a published text, even though Paratext expected a sequential order of chapter and verse markers. Different projects have atempted to describe the structure of ESG within this Paratext constraint using \cp and \vp. \ca and \va are normally used for showing multiple (an alternate) versififcation schemes.
You referered to a canonical introduction. I think I understand why you have described the text this way. In an English text example (Good News), the current project markup is as follows
The \cp (as a Paragraph type) appears within a sequential chapter section on its own (like
As I mentioned, the pratice of marking up ESG is somewhat varied, and challenging. Does this alternative example help shed light on what others do and have done with this?