Isidore-Guild / statenvertaling

OSIS Statenvertaling (Dutch) with apocrypha
Creative Commons Zero v1.0 Universal
5 stars 2 forks source link

Shuffle footnotes #3

Open lemtom opened 4 years ago

lemtom commented 4 years ago

Currently, the footnotes are all at the end of the verse. This is because I spliced them in.

Ideally, they should be moved to appear right behind the relevant words (as repeated in bold in the actual footnote). At this point, I can't even begin to comprehend how/if such a thing would be feasible.

DavidHaslam commented 3 years ago

Rather than use <hi type="bold">...</hi> it would be preferable to make use of the OSIS catchWord element.

Semantic markup is always preferred instead of presentational markup in OSIS.

lemtom commented 3 years ago

I was completely unfamiliar with the catchWord element.

In case I get around to redoing some of my other modules: Is it only for notes, or would it also fit for commentary modules that start sections with the part of the phrase being commented on? It's not immediately obvious to me from the documentation.

DavidHaslam commented 3 years ago

Do you have a copy of the OSIS 2.1.1 Reference Manual ?

I can readily supply a copy of the PDF file. Meanwhile, here's what it has on page 75 for

13.3. catchWord Catchwords and catchphrases are those parts of notes that are copied from the main text, to orient the reader as to the note's precise applicability. Catchwords in notes must be marked when present. For example:

<verse osisID="NRSV:Ezek.19.5">When she saw that she was thwarted,
that her hope was lost, she took another of her cubs and made him a
young lion.</verse> <note>It is uncertain to which king <catchWord
osisRef="Ezek.19.5">another of her cubs</catchWord> refers....</note>

Users of XML markup software will note that catchWord is allowed in the p element. That is only because there can be paragraphs inside of notes. OSIS conformant documents must limit their use of catchWord to being within note elements only. The osisRef attribute on this element can be used to point to the exact word or set of words that are acting as the catchword or phrase. This will be useful when searching groups of texts for all the catchwords or phrases for particular terms. Use of this attribute is optional.

cf. Also CrossWire's own updated schema.