[tei-council] biblStruct madness

[Martin Holmes]

I suggest replacing all biblStructs with bibls in the bibliography of 
the Guidelines. No-one needs the misery of trying to render biblStructs. 
I've wasted weeks of my life on it.

Cheers,
Martin

On 14-09-19 07:15 AM, syd at paramedic.wwp.northeastern.edu wrote:
> Addressing bug 383 is a bit of shooting ourselves in the already
> bleeding foot.
>
> I have (in my working copy) updated BIB and the element specification
> for <biblStruct> to address this bug. All works fine.[1] However, now
> the actual HTML bibliography in the generated Guidelines looks worse,
> because the <idno> elements are showing up in the middle, not at the
> end. This is because our template for <biblStruct> just applies
> templates, it does not do anything intelligent with the order of
> elements. (I don't even know how the punctuation gets in there.)
>
> So I was inclined to try to fix the processing if <biblStruct> first.
> However, I realize
>
>   1. it's a sizable job just to do this one thing, let alone fix
>      what's listed below
>
>   2. <idno> isn't being processed well, anyway [2]
>
>   3. there quite a few other things that need to be fixed in the
>      processing of our bibliography, e.g.:
>      a) spacing is sometimes screwy (e.g., no space before year "1992"
>         in #KNUTH)
>      b) Series-level titles are renditionally undifferentiated -- but
>         I'm not sure they should be. See, e.g. #CH-eg-02. (Which is
>         just mis-encoded anyway, isn't it? TR23 is not a series.
>         That's probably a corrigible error. But it if it were a series
>         title, A- it looks icky, and B- shouldn't it have been done as
>         a <series>, anyway?)
>      c) the CSS for <q> generates ugly straight quotes, as opposed to
>         pretty curly ones
>      d) we are using <biblScope> instead of <citedRange>
>      e) we are completely inconsistent about whether or not there is
>         whitespace after the '.' of (e.g.) "p. 7" or "pp. 7-11".
>      f) The Princeton Band
>      e) we are completely inconsistent as to whether or not the "p."
>         or "pp." is included in the content of a <bibleScope> with
>         type="pp"
>      And I'm sure there are others
>
>   4. I'm running short on time right now
>
> So, my plan is to simply check-in the updated <biblStruct> (that has
> a manual constraint to flag a child <idno> as deprecated) and the
> matching BIB-Bibliography.html without doing anything (yet) to fix
> the stylesheets. The bibliography will just be a wee bit uglier for a
> while. I expect to attack the stylesheet and other problems in early
> October.
>
> Notes
> -----
> [1] One exception that is unrelated -- in my local build the em dash
>      that it part of the new deprecation message (in this case for
>      "deprecate-altIdentifier-child") is stored as an em dash in
>      Test/expected-results/detest.log, but is spit out as an octal
>      code when I build on my Mac. Thus the two don't match, and the
>      `diff` fails. This does not happen on Ubuntu. Have not tested
>      running on Mac in Terminal (instead of Emacs). I'm basically not
>      going to worry about this much, at least not now.
>
> [2] We have 30 <idno>s inside a <listBibl>:
>       23 inside <biblStruct> with type=DOI
>        5 inside <biblStruct> w/o @type
>        1 inside <biblStruct> with type=ISBN
>        1 inside <bibl> w/o @type
>      But as far as I can tell the stylesheets have no code to handle
>      "DOI" (only "doi") nor "ISBN". (They also handle "url", but that
>      doesn't occur.)
>
>