ubsicap / usfm

Unified Standard Format Markers
39 stars 18 forks source link

Expand definition of \toc tags #143

Open cmahte opened 1 year ago

cmahte commented 1 year ago

\toc3 is widely used and expected for "ebook" or "app" listing usage. It is good to include it even on sections which paper output won't get a listing, like the 'title' and 'Illustrations'... etc. Some sort of recognition of that here in the spec would be useful for all coders, and designers, and translators.

In addition consider these expanded items (all used in many Bibles.): \toc0 Testament title page, Introductory items (allow for multiple levels of TOC) \toc4 number of chapters to be published. \toc5 index entry for inclusion at the start of each chapter. (see below) \toc6 Illustration index mark. \toc7 map index mark.

\toc5 :

\mt3 The First Book of Moses: Called
\mt1 Genesis
\c 1
\cd 
\m
\toc5 1 The creation of Heaven and Earth, 
\v 1 In the beginning God created the heaven and the earth.
\p
\v 2 And the earth was without form, and void; and darkness was on the face of the deep. And the Spirit of God moved on the face of the waters.
\p
\toc5 3 of the light, 
\v 3 And God said, Let there be light: and there was light.
\v 4 And God saw the light, that it was good: and God divided the light from the darkness.
\toc5 6 of the firmament, 
\v 5 And God called the light Day, and the darkness he called Night. And the evening and the morning were the first day.
\p ¶
\v 6 And God said, Let there be a firmament in the middle of the waters, and let it divide the waters from the waters.
\v 7 And God made the firmament, and divided the waters which were under the firmament from the waters which were above the firmament: and it was so.
\v 8 And God called the firmament Heaven. And the evening and the morning were the second day.
\p ¶
\toc5 9 of the earth separated from the waters, 
\v 9 And God said, Let the waters under the heaven be gathered together to one place, and let the dry land appear: and it was so.

Screenshot from 2022-12-22 08-19-32