scta / edf-schema

1 stars 1 forks source link

title vs short title vs long title vs. abbreviated short title #10

Open jeffreycwitt opened 6 years ago

jeffreycwitt commented 6 years ago

I think the EDF spec should declare the kind of "title" that goes in the <head> or <title> field.

Namely, I think we should specify that this should be the "short title"

By short title I mean just the title of the specific sections, e.g. "caput primus", "articulus primus", etc., as opposed to a long title, which might be "Sentences, Liber I, Distinctio 1, Caput 1".

By mandating that all <title> or <head> contain only a short title, processors can reliably construct the long title by concatenating all of the ancestor short titles together.

But if there is no specified practice here, then a processor cannot reliably construct the long title.

While on the subject we might also want to introduce a filed called "abbreviated short title", so that an "abbreviated long title" can also reliably be constructed. The abbreviated title for "articulus primus" might be "A. 1", this way a processor could construct a "long abbreviated title" like "Sent., L. 1, D. 1, C. 1" etc.

stenskjaer commented 6 years ago

This was discussed on the community meeting. A possible recommendation would be that every title should be only the short title. For example a "Liber 1, Distinctio 1, Capitulum 1" should just be "Capitulum 1" and all the higher level indications should be found from the parent div structure.

A structure like that would look something like this:

<div id="am-librum1" type="librum" subtype="librum1">
  <head>Liber I</head>
  <div id="am-l1d1" type="distinctio">
    <head>Distinctio I</head>
    <div id="am-l1d1pA" type="pars">
      <head>pars A</head>
      <item id="am-l1d1pAa1" type="articulus">
        <fileName filestem="am-l1d1pAa1">am-l1d1pAa1.xml</fileName>
        <title>Articulus 1</title>
        <questionTitle>Quomodo investigat subjectum Theologiae?</questionTitle>
      </item>
      <item>
         ...
      </item>
    </div>
  </div>
</div>

Any item could then hold the optional <longTitle> where an editor/encoder would indicate the long title if desired for some particular purpose. But be default it wouldn't be used for anything.