usfm-bible / tcdocs

Technical Committee Documents
Other
9 stars 9 forks source link

Clear, backward-compatible syntax definition for USFM is required. #17

Closed kahunapule closed 6 months ago

kahunapule commented 2 years ago

I recently encountered some strange USFM produced in Paratext that broke my USFM parser. It was something like \v 1\f + \ft note\f*Bible text Note the missing space after the verse number. Until seeing this, and verifying that it was not flagged in any Paratext marker checks, it seems that I now need to adjust my USFM parser to accept this as normal. Is that the desired response?

KentSpiel commented 2 years ago

I would think this should be ruled out as not acceptable unless we actually want to support footnotes on verse numbers. Is that what was intended? Is the footnote about the verse number, versification, or perhaps the verse as a whole? If it is then perhaps it should be allowed, along with \c 1\f + \ft note\f*

The NIV has footnotes on chapter numbers for notes about versification and whole chapters. We currently use \c 1 \p \f + \ft note\f* \v 1 for such footnotes. \c 1\f + \ft note\f* would be a cleaner solution.

kahunapule commented 2 years ago

In the cases I observed, the footnotes were not supposed to be on or about the verse number. They were all about a phrase at the beginning of the verse.

On 5/10/22 09:30, Kent Spielmann wrote:

I would think this should be ruled out as not acceptable /unless/ we actually want to support footnotes on verse numbers. Is that what was intended? Is the footnote about the verse number, versification, or perhaps the verse as a whole? If it is then perhaps it should be allowed, along with |\c 1\f + \ft note\f*|

The NIV has footnotes on chapter numbers for notes about versification and whole chapters. We currently use |\c 1 \p \f + \ft note\f \v 1| for such footnotes. |\c 1\f + \ft note\f| would be a cleaner solution.

— Reply to this email directly, view it on GitHub https://github.com/usfm-bible/tcdocs/issues/17#issuecomment-1122782381, or unsubscribe https://github.com/notifications/unsubscribe-auth/AATEO236ZP6FNN5QJQWZ7ALVJK2PBANCNFSM5VLISMAA. You are receiving this because you authored the thread.Message ID: @.***>

-- signature

Aloha, */Michael Johnson/* 26 HIWALANI LOOP • MAKAWAO HI 96768-8747• USA mljohnson.org https://mljohnson.org/ • eBible.org https://eBible.org • WorldEnglish.Bible https://WorldEnglish.Bible • PNG.Bible https://PNG.Bible Signal/Telegram/WhatsApp/Telephone: +1 808-333-6921 Skype: kahunapule • Telegram/Twitter: @kahunapule • Facebook: fb.me/kahunapule https://www.facebook.com/kahunapule

KentSpiel commented 2 years ago

NM w CB m

KentSpiel commented 2 years ago

MA nbbn KmartS may sink e@ on

mhosken commented 6 months ago

That's what this release is about