COMPLETED TASK: Another minor rendering issue
In the metadata rendering for the XHTML output,
<biblStruct> elements in the
<sourceDesc> tag were not fully rendered. This example shows only "Birgitta Steen" (name of the author whose book is being reviewed), instead of the full title of the article, which also includes the title of the book being reviewed. This may be because the latter is inside a title tag itself.
It turned out this was caused by a combination of factors. First, the processing of the
<biblStruct> tag fell through to the bibliography processing code in
tei_scancan_xhtml_mla_bibliography.xsl. That code has processing to handle one specific oddity: cases where there is no author or editor, and so the title of a document actually becomes its first component, and its sort key. Such cases were distinguished by wrapping the contents of the title in a
<name> tag. I've now added code which distinguishes between that situation (where the only content of a title tag is a name tag), and the situation in the
<sourceDesc> for a review, where the
<name> tag is only a component of the article title, and is followed by another title tag for the book being reviewed.
All this is a little flimsy, and we should bear this issue in mind for the teiJournal project. I'm coming to the conclusion that the safest way to handle this for teiJournal is to have an inventory of biblStruct types (distinguished by the type attribute), each of which can then have its own distinct processing. This seems redundant, but in fact the rules for formatting are a) almost arbitrary, b) completely dependent on the type of document, and c) catalogued and explained in just such as way in style guides such as Chicago; our processing may as well follow the approach of the style guides it's implementing, and it will certainly be easier to find, diagnose and fix a problem, not to mention add another type with its own peculiar requirements. Finally, explaining to users how to do things will clearly be easier if it's based on the same kind of inventory as they're used to finding in style guides.