D2d "basic.deliverables", User's Manual

This module defines top-level containers of documents, i.e. certain structures which represent products as a whole, in a certain tradition of publishing.

(STR.title & subtitle? & STR.htmlTitle? & (BIB.author | 
                                           BIB.authors)? & 
 STR.metaContentsTag*  & date? & STR.abstract? & (X.lang | 
                                                  X.langs)?), 
(STR.FLOAT.tableOfContents | STR.FLOAT.listOf | STR.p | 
                                                STR.LINK.embed | 
                                                STR.PHY.hr | 
                                                STR.source | 
                                                STR.FLOAT.floating | 
                                                STR.BIB.biblist | 
                                                STR.LINK.treeInclude_PROVIS)* , 
(STR.h1+  | STR.part+ )?, STR.appendices?, STR.postappendices?

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | STR.BIB.cite | 
 STR.IM.image)* 

(STR.title & subtitle? & STR.htmlTitle? & (BIB.author | 
                                           BIB.authors)? & 
 STR.metaContentsTag*  & date? & STR.abstract? & (X.lang | 
                                                  X.langs)?), 
(STR.FLOAT.tableOfContents | STR.FLOAT.listOf | STR.p | 
                                                STR.LINK.embed | 
                                                STR.PHY.hr | 
                                                STR.source | 
                                                STR.FLOAT.floating | 
                                                STR.BIB.biblist | 
                                                STR.LINK.treeInclude_PROVIS)* , 
(STR.h1+  | STR.part+ )?, STR.appendices?, STR.postappendices?

A first small solution for bibliographic data, citation keys and bibliographic lists.
Its structure is based on "bibTeX" and our experiences in bib-style programming, but heavily trying to modernize and orthogonalize.
The grammar definition of the entries is (of course!-) independent of the "kind" of entry, because the complex requirements and implications on the semantical level cannot adequately be expressed by a regular expression. But we decided to coarsely reflect these requirements by grouping the components of an entry. Inside most groups the fields may be permutated.

1. First we require key(implicit), kind, title and one or more authors.
2. Additionally subtitle, latextitle (later:htmltitle !?!)
3. Then may follow references to copies of the text, which have formalized structure, namely url(s), isbn(s), issn(s), doi(s), etc.
4. Then follows either a simple crossref to the collection containing the article,
5. or the standard bibliographic co-ordinates in case of stand-alone publications (place, date, publisher, etc.)
6. At last there may follow abstracts and keywords in different languages, and a list of library signatures where a printed copy is available.

If there is only one single sub-document cited from a collection, its bibliographic co-ordinates may be inlined into the entry for the article. But in contrast to BibTex, we recommend the solution with two(2) separate entries. Nevertheless, we put the "formal references" in the middle of both groups, because in the single-entry case these may either describe just the article, i.e. the head of the entry, or the whole volume, i.e. the tail of the entry.

Please note that the items contained in editors are tagged with author, as the items in authors. Firstly, the code for rendering is inherited, and secondly editors are professional authors, in most cases.

Please note that the problem of a generic, standardized and widely accepted bib-entry format is still unsolved. We plan a whitepaper on this subject, and a preliminary link collection is found in metatools/doc/papers/recherche/recherche_biblio.html.

An abstract in one certain language.

Attention: The first tag is implicit, ie. may not appear in source text.

#implicit X.lang, (#chars | STR.PHY.bold | STR.PHY.ital | 
                            STR.PHY.ulin | STR.PHY.blink | 
                            STR.PHY.strikeout | STR.PHY.scaps | 
                            STR.PHY.hh | STR.PHY.larger | 
                            STR.PHY.smaller | STR.PHY.indexlo | 
                            STR.PHY.indexhi | 
                            STR.PHY.spanstyle | STR.PHY.src | 
                            STR.PHY.verbatimXml | STR.E.nl | 
                                                  STR.E.ldots | 
                                                  STR.E.label | 
                                                  STR.E.ref | 
                                                  STR.E.pers | 
                                                  STR.E.opus | 
                                                  STR.E.persop | 
                                                  STR.E.emph | 
                                                  STR.E.xemph | 
                   STR.E.xlang | STR.LINK.treeInclude | 
                   STR.LINK.link | STR.BIB.cite | STR.LI.list | 
                   STR.TA.table | STR.footnote | STR.footnotemark | 
                   STR.footnotetext | STR.p | STR.LINK.embed | 
                                      STR.source | 
                                      STR.FLOAT.floating | 
                                      STR.BIB.biblist | 
                                      STR.LINK.treeInclude_PROVIS)* 

If present, the abstracts will be invisible, and a visibility toggle will be added. A corresponding java-script procedure must be present, as well as the translations for the button texts.

Contents are defined as empty.

A list of language codes, determins the selection and sequential order of included abstracts. The list must be "self-structured", i.e. start and end with an arbitrary item separator character.

BIB.author+ 

Indication of one library where to printed text can be found, and the signature they use.

Attention: The first tag is implicit, ie. may not appear in source text.

#implicit STR.BIB.key, kind, (STR.BIB.title & STR.BIB.subtitle? & 
                              STR.BIB.latextitle? & 
                              X.lang? & (BIB.author | 
                                         BIB.authors)?), 
(STR.BIB.url | STR.BIB.isbn | STR.BIB.issn | 
 STR.BIB.doi)* , (STR.BIB.crossref, STR.BIB.pages? | 
                  ((STR.BIB.year, STR.BIB.month? | 
                    STR.BIB.date) & STR.BIB.booktitle? & 
                   STR.BIB.publisher? & STR.BIB.place & 
                   (STR.BIB.editor | 
                    STR.BIB.editors)? & (STR.BIB.series | 
                                         STR.BIB.journal)? & 
                   STR.BIB.volume? & STR.BIB.number? & 
                   STR.BIB.pages?)), (STR.BIB.abstract | 
                                      STR.BIB.note | 
                                      STR.BIB.available)* 

A list of bibliographic entries, rendered as a whole, e.g. concering sort order.
The "lang" attribute is taken as the default language for the contained bibentries. (See the other components for documentation!)

(X.lang? & sortMethod? & STR.BIB.abstractLangs? & STR.BIB.abstractHiding?), 
STR.BIB.bibentry+ 

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.BIB.cite | 
 STR.IM.image)* 

A citation is a reference to a bibliographic entry, plus possibly a location indication ("pg 12 to 13"). CURRENTLY both is free text, only excluding the delimiter "!".
Every cite is rendered as a xhtml link to the bibliographic entry. This is assumed to be in the same file, OR in the file given by the stylesheet parameter "$user.bibLocation".

STR.BIB.key ~ ('!' ~ [ locus (0x0001 .. 0xfffe - '!')~+ ] ~ 
               '!')?

STR.BIB.key ~ ('!' ~ [ locus (0x0001 .. 0xfffe - '!')~+ ] ~ 
               '!')?

Currently not yet parsed internally, but whenever the target format permits, rendered as a "clickable" link to some service provider.

BIB.author+ 

Currently not yet parsed internally, but whenever the target format permits, rendered as a "clickable" link to some service provider.

Currently not yet parsed internally, but whenever the target format permits, rendered as a "clickable" link to some service provider.

The identifier for a bibliographic entry.
This could be replaced by something more restricted, like "alpha~+ ~ digit~*". The key must appear in the bib entry and in all cite-elements. When using this standard rendering script it is also immediately the visible representation of the citation/link. This is a signficant difference to BibTex, and could of course be done differently by some more elaborated rendering script.

(STR.BIB.S.ascii_alpha U '-'U'_' U STR.LINK.S.decimalDigit)~+ 

The different kinds of publication, as historically introduced by "bibtex".
We added further alternatives.
Please note that in the default rendering there is no relation between this kind value and the syntax of entries or the format of the rendering. Nevertheless, indicating the "kind" is always required.

Characters only, intended for over-riding LaTeX-bibTex entries, because these are hard to synthesize automatically.

Additional remarks to a bib entry, eg. comments, protocols where it has been used, hints for a rendering process, etc.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | 
 STR.BIB.cite | STR.LI.list | STR.TA.table | STR.footnote | 
 STR.footnotemark | STR.footnotetext | STR.p | STR.LINK.embed | 
                                       STR.source | 
                                       STR.FLOAT.floating | 
                                       STR.BIB.biblist | 
                                       STR.LINK.treeInclude_PROVIS)* 

How the biblist will be sorted in rendering.
CURRENTLY there are two Fixmes with the chronological sort methods:
(a) only "year" and "month" are respected, since the internal structure of "date" is not defined.
(b) these dates do not carry over via "crossref"

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.BIB.cite | 
 STR.IM.image)* 

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.BIB.cite | 
 STR.IM.image)* 

Whenever the target format permits, the rendering is to a hyperlink. The visible text is determined by the stylesheet parameter $user.biblistHideUrl: When this is set, only the suffix is shown, intended to represent the document's type. Otherwise the whole URL is shown, what may cause inappropriate visual noise.
FIXME better make it parameter of the biblist structure !?
For the url value, and the displayed url in the latter case, the leading digits 0..9 will be replaced by the mount points in the stylesheet parameter $user.linkurlprefices and $user.linktextprefices, similar as with "base.interdocument:link" elements.

(STR.p | STR.LINK.embed | STR.PHY.hr | STR.source | 
 STR.FLOAT.floating | STR.BIB.biblist | 
 STR.LINK.treeInclude_PROVIS)* 

The headline for the "table of contents", or for any floating object.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | STR.BIB.cite | 
 STR.IM.image)* 

Attention: The first tag is implicit, ie. may not appear in source text.

#implicit STR.FLOAT.series, (STR.FLOAT.caption? & STR.FLOAT.shortCaption? & 
                             STR.E.label? & STR.FLOAT.floating.width? & 
                             STR.FLOAT.floating.height? & 
                             STR.FLOAT.floating.positioning? & 
                             STR.FLOAT.floating.body)

Contents are defined as empty.

Will be expanded to a list of the floating objects of a certain series.

Attention: The first tag is implicit, ie. may not appear in source text.

#implicit STR.FLOAT.series, (STR.FLOAT.caption & STR.FLOAT.numberingScope? & 
                             STR.FLOAT.switchOnText? & 
                             STR.FLOAT.switchOffText? & 
                             STR.FLOAT.initiallyHidden?)

Indication of the structure level (like "h1", "h2", ...) in which the numbering of the floatings will be based on.

"h" ~ '0' .. '9'

The series is NOT an identifier, but can contain arbitrary characters. This is usefule because it is visible to the end user. E.g. in the German language you want to include a list of "Gemälde" and floating objects called "Gemälde 1.2"

A shorter version of the caption of a floating object. Iff present, it replaces the longer caption in the "listOf" survey.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | STR.BIB.cite | 
 STR.IM.image)* 

A short text line. When clicked, it will hide/close the "listOf" survey. If a switchOff text is given, a switch will be installed and a switchOnText is required, or at least a "caption", which will be used as such.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.IM.image)* 

A short text line. When clicked, it will pop-up/open the "listOf" survey.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.IM.image)* 

Will be expanded to a complete table of contents, of the hierarchical structure of the whole document.

STR.FLOAT.caption? & STR.FLOAT.switchOnText? & STR.FLOAT.switchOffText?

This module contains semantic (and a few physical) elements/text particles. Most of them can appear in every context. This module must be instantiated with the contents for emphasizing.

Something emphasized.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | STR.BIB.cite | 
 STR.IM.image)* 

Such a label binds an identifier to that certain location of the text body where itself happens to appear.
By setting the swich $user.showlabels="yes", these labels and others will be printed in the output, for proof reading.
Putting a label is possible nearly anywhere. If it is in the middle of some text flow, it just marks this special text position. But if it is in a structured object, e.g. the caption of a diagram, its meaning is possibly referring to this diagram. This interpretation and the way a reference is generated may depend on the "ref" elements.

STR.LINK.S.ascii_lower U STR.LINK.S.ascii_upper ~ (STR.LINK.S.alpha U '_' U '-' U STR.LINK.S.decimalDigit)~* 

Draws three low dots surrounded by spaces.

Contents are defined as empty.

Forces a line break, but not a new paragraph.

Contents are defined as empty.

Title of an opus, a work of art, or any product, (This is a candidate for replacement with some more sophisticated, parser based definition.) Our standard to_xhtml_1_0 script renders it to a span/class=opus, which normally results in slanted small caps.

Personal name. (This is a candidate for replacement with some more sophisticated, parser based, but locale specific definition.) Our standard to_xhtml_1_0 script renders it to a span/class=pers, which normally results in small caps.

Name of its author and name of an opus. Behaves like the sequence of #pers and #opus. Any separation char must be appended to the former.

[ ppers (STR.SET.all - '!')* ] ~ "!" ~ [ popus (STR.SET.all - '!')* ] ~ 
"!"

Refering is possible nearly anywhere. Mostly it is to a label.
A hyper-ref link will be generated and its textual appearance will be constructed automatically. There are many different strategies, eg. generating text like "in this list" or "in section 2.1.2 (TITLE OF THE SECTION)". These strategies are selectable and respect the current base language of the text.
(This is achieved by calling the named template "muliDefault", which makes translations into the "default" language.)
The implementation of each rendering strategy starts always with the Xslt template matching "a:ref" and works as follows:

1. Identify the positional context of the reference, e.g. the innermost enclosing section, table, list, etc.
2. Find the label element referred to.
3. If not found, an error is generated and an alerting meta-element inserted in the output.
4. Otherwise, start a mode=getreftext visiting of the label, with the refering context stored to parameters.
5. This visiting traverses upward, up to a nearest common parent, while accumulating the text corresponding to the downward navigation so far.
6. In case of lists and tables as part of TEXT FLOW, the generation of navigation text is delayed, until the next hosting level is found and numbering/counting will be possible.

   The text for sections, chapters, parts etc. is constructed to

           Abschnitt  17.3.1 ("<title-of-the section>")
           ^                 ^ iff user.refTitle=='inline'
           ^                   (otherwise it may be rendered as toolTip)
           ^ translated to doc's default language
      

"floatings" are identified by their genuine reference mechanism.
"lists", "list points", "tables" and "table rows" by counting relative to the nearest "container", which is a list, a table, a floating, a section, etc.
Iff reference and label are in a common container (list, table, or lowest level section), this part of the reference text is abbreviated to "this list"/"this table"/"this section", etc.
There is currently NO further abbreviation implemented, like "next section" or "preceding chapter".

If you want to determine the refering text appearance freely by yourself, using all mark-up currently available, you can always use an explicit "#link" construct, using only the local part of the link target ("fragment identifier", in w3c speak)
So you can link to "mylabel" directly by
"... and #link#loc mylabel#text here is the #emph!real! text#/link ..."

STR.LINK.S.ascii_lower U STR.LINK.S.ascii_upper ~ (STR.LINK.S.alpha U '_' U '-' U STR.LINK.S.decimalDigit)~* 

Something strongly emphasized.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | STR.BIB.cite | 
 STR.IM.image)* 

A short sentence/sequence of words in some foreign lanugage, -- less than a whole paragraph. Our standard to_xhtml_1_0 rendering creates a span element with an xml:lang attribute, which you may render by css as you like.

Attention: The first tag is implicit, ie. may not appear in source text.

#implicit X.lang, (#chars | STR.PHY.bold | STR.PHY.ital | 
                            STR.PHY.ulin | STR.PHY.blink | 
                            STR.PHY.strikeout | STR.PHY.scaps | 
                            STR.PHY.hh | STR.PHY.larger | 
                            STR.PHY.smaller | STR.PHY.indexlo | 
                            STR.PHY.indexhi | 
                            STR.PHY.spanstyle | STR.PHY.src | 
                            STR.PHY.verbatimXml | STR.E.nl | 
                                                  STR.E.ldots | 
                                                  STR.E.label | 
                                                  STR.E.ref | 
                                                  STR.E.pers | 
                                                  STR.E.opus | 
                                                  STR.E.persop | 
                                                  STR.E.emph | 
                                                  STR.E.xemph | 
                   STR.E.xlang | STR.LINK.treeInclude | 
                   STR.LINK.link | STR.BIB.cite | 
                   STR.IM.image)* 

Primitive elements for embedding of and linking to other documents.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | STR.BIB.cite | 
 STR.IM.image)* 

The target where to open the new link. This cannot be rendered in xhtml 1.0 strict! A javascript based implementation must be provided by the user whenever this "target" feature shall be used in xhtml 1.0 strict. The standard xslt script will ignore it and emit a warning iff $user.xhtmlVariant ist set to "strict".

Contents are defined as empty.

Embeds any third-party source text into the source and the rendering result into the output.
(Eg. "lilypond" source resulting to a ".png" which is included into the xhtml document.)
This processing must be executed by the make system which controls the overall document processing pipeline.
The xslt code does only

1. generate a unique file name
2. generate an <img> element when generating xhtml.
3. piping all the thirs-party-source into a bash-script, which will auto-split into source files for these tools.
   This is done by a second conversion target, "to_embedScript".
   The filename suffix is taken from the "type" attribute, and indicates to the further processing which tool(s) has/have to be started (e.g. for creating the png included by the html, or sim.)

An alt may be given, but if omitted, it will be inherited from the containing element. In many cases the containing element be a "floating"!

Attention: The first tag is implicit, ie. may not appear in source text.

#implicit STR.LINK.embed.type, (STR.LINK.embed.alt? & 
                                STR.LINK.embed.body)

The target where to open the new link. This cannot be rendered in xhtml 1.0 strict! A javascript based implementation must be provided by the user whenever this "target" feature shall be used in xhtml 1.0 strict. The standard xslt script will ignore it and emit a warning iff $user.xhtmlVariant ist set to "strict".

The target where to open the new link. This cannot be rendered in xhtml 1.0 strict! A javascript based implementation must be provided by the user whenever this "target" feature shall be used in xhtml 1.0 strict. The standard xslt script will ignore it and emit a warning iff $user.xhtmlVariant ist set to "strict".

Contents are defined as empty.

Inter document link, very similar to classical html <a> element. But it is a little bit higher level!

Attention: The first tag is implicit, ie. may not appear in source text.

#implicit STR.LINK.url, ((STR.LINK.link.blank | STR.LINK.link.top | 
                          STR.LINK.link.inframe | 
                          STR.LINK.link.framename)? & 
                         STR.LINK.link.text? & STR.LINK.loc? & 
                         STR.LINK.link.refdate?)

The location/fragment in the document (what normally appears behind a hashmark!-) A link must contain either an url or a loc entry, or both.

The calendaric date when the meant contents of the link had been retrieved.

The text to print when the link is rendered. It is defined by a generic parameter, so anything may appear there, depending on the instantiation of this module.
If this field is left out, then the url will be taken as text.
In this case, if the url starts with a digit, then the prefix replacing this digit is taken from the stylesheet parameter $user.linktextprefices. This allows more readable, more symbolic references to frequently used mount points.
If the text is present and starts with an exclamation mark "!", then this is also replaced by this prefix.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.BIB.cite | 
 STR.IM.image)* 

The target where to open the new link. This cannot be rendered in xhtml 1.0 strict! A javascript based implementation must be provided by the user whenever this "target" feature shall be used in xhtml 1.0 strict. The standard xslt script will ignore it and emit a warning iff $user.xhtmlVariant ist set to "strict".

Contents are defined as empty.

Includes an xml text corpus into the rendering process. "url" gives the file position, and "mode" gives the mode parameter to the "apply-templates" call.
CURRENTLY PATH is not yet operative, because there are problems serializing the dynamic xpath extension required for its execution.

Attention: The first tag is implicit, ie. may not appear in source text.

#implicit STR.LINK.url, STR.LINK.path, STR.LINK.mode?

Same as treeInclude, but callable from a different parsing situation.

Attention: The first tag is implicit, ie. may not appear in source text.

#implicit STR.LINK.url, STR.LINK.path, STR.LINK.mode?

Suffix of the generated temporary filename in which the body will be written. Used to select the tool for subsequent processing.

STR.LINK.S.ascii_lower U STR.LINK.S.ascii_upper ~ (STR.LINK.S.alpha U '_' U '-' U STR.LINK.S.decimalDigit)~* 

The url of a link or a resource.
(This is currently NOT YET parsed, but can be any sequence of characters. Errors will occur later, when the link is used !-)
Iff the url starts with a digit=n, then there must be an n-th entry in the self-structured list in the stylesheet parameter $user.linkurlprefices, and the digit is replaced by this.

Physical mark-up is mostly deprecated. It follows the (old!) html way of physical mark-up. In this basic model this can only be applied to physical mark-up itself/recursively. The declaration is naive, allowing multiple (nested) application of the same modifier. It can NOT be applied to semantic mark-up. Additionally this module defines some html/xml specific elements.

Explicitly select blinking text. Not only deprecated, but also bad manners.
The xslt rule generates a <span style="text-decoration:blink;">, because the old <blink> tag has not been taken over to xhtml 1.0 strict. Explicitly select stroke-out text. Deprecated.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle)* 

Explicitly select bold text. Deprecated. Consider to use basic.inlineElements:xemph instead.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle)* 

Draws a horizontal line, leaned from html.

Contents are defined as empty.

Explicitly select superscript. Deprecated.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle)* 

Explicitly select subscript. Deprecated.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle)* 

Explicitly select italic text. Deprecated. Consider to use basic.inlineElements:emph instead. Explicitly select underlined text. Deprecated.
The xslt rule generates a <span style="text-decoration:underline;">, because the old <u> tag has not been taken over to xhtml 1.0 strict.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle)* 

Explicitly select larger font. Deprecated.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle)* 

Explicitly select small caps. Deprecated. Consider to use basic.inlineElements:opus or basic.inlineElements:pers instead.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle)* 

Explicitly select smaller font. Deprecated.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle)* 

Inserts an html-<span style='xxx'>

Attention: The first tag is implicit, ie. may not appear in source text.

#implicit STR.PHY.style, (#chars | STR.PHY.bold | STR.PHY.ital | 
                                   STR.PHY.ulin | STR.PHY.blink | 
                                   STR.PHY.strikeout | 
                                   STR.PHY.scaps | 
                                   STR.PHY.hh | STR.PHY.larger | 
                                   STR.PHY.smaller | 
                                   STR.PHY.indexlo | 
                                   STR.PHY.indexhi | 
                                   STR.PHY.spanstyle)* 

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle)* 

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle)* 

A by-pass when generating html/xhtml documents. This element is intended to contain special html fragments which shall be included verbatim in the output. This is achieved simply by an xslt rule which disables output escaping.

Currently only four hex digits are decoded for character values, so that the higher unicode planes (beyond 0x0_FFFF) can currently (201200208) not be described on the d2d input side. (They can be output by xslt).

0x0001 .. 0xfffe

STR.LINK.S.ascii_lower U STR.LINK.S.ascii_upper

STR.LINK.S.ascii_lower U STR.LINK.S.ascii_upper

'a' .. 'z'

'A' .. 'Z'

'0' .. '9'

' ' U 0x0009 U 0x000a U 0x000d

If you leave it out, some alternative text from the enclosing elements must be found for rendering. This searched for by the named template 'copyAltFromContext', which otherwise will fail with an error.

STR.IM.image.file & STR.IM.image.alt? & STR.IM.image.width? & 
STR.IM.image.height? & STR.IM.image.align? & STR.IM.image.showLabel?

Contents are defined as empty.

A very simple list module.

STR.LINK.S.ascii_lower U STR.LINK.S.ascii_upper ~ (STR.LINK.S.alpha U '_' U '-' U STR.LINK.S.decimalDigit)~* 

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | STR.BIB.cite | 
 STR.IM.image | STR.LI.list | STR.TA.table | STR.footnote | 
 STR.footnotemark | STR.footnotetext | STR.p)* 

(STR.LI.list.symbol? & (STR.LI.list.startnum | 
                        STR.LI.list.continues)? & STR.E.label?), 
STR.LI.list.i+ 

longminus, openSquare, diamond, openDiamond are not yet supported.

CURRENTLY the starting number of a numbered list CANNOT be set anymore! Once, in former html versions, this was possible. NOW it is advised to use CSS-three for this purpose, but this is not yet on the market.
THEREFORE we ignore the value of "startnum" and of "continues".
IT COULD be built by rendering the list-items explicitly, not using the <ol> construct, but <xsl:number> and <html:dd> instead. But we are not sure whether this is sensible.

('0' .. '9')~+ 

listSymbol

Values for kind, style, width of cell borders, following CSS2.0 syntax. Valid for the whole table.

Most simple table model; sufficient for many use cases, but can of course be replaced by something more elaborate, when necessary.
The nomenclature follows html.

Labels at the explicit positions refer to the table or the table row; references to labels appearing anywhere in the text will contain the full address path "table <T>, row <R>, column <C>". Numbering starts with one(1).

(STR.TA.border? & STR.E.label?), STR.TA.tr* 

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | STR.BIB.cite | 
 STR.IM.image | STR.LI.list | STR.TA.table | STR.footnote | 
 STR.footnotemark | STR.footnotetext | STR.p)* 

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | STR.BIB.cite | 
 STR.IM.image | STR.LI.list | STR.TA.table | STR.footnote | 
 STR.footnotemark | STR.footnotetext | STR.p)* 

STR.E.label?, (STR.TA.td*  | STR.TA.th* )

This module defines the structural elements like paragraphs, chapters, etc. It starts plugging the sub-modules together, and distributing parametrization, without yet defining the very top of the corpus structure.

STR.kind?, X.lang?, (#chars | STR.PHY.bold | STR.PHY.ital | 
                              STR.PHY.ulin | STR.PHY.blink | 
                              STR.PHY.strikeout | STR.PHY.scaps | 
                              STR.PHY.hh | STR.PHY.larger | 
                              STR.PHY.smaller | STR.PHY.indexlo | 
                              STR.PHY.indexhi | 
                              STR.PHY.spanstyle | STR.PHY.src | 
                              STR.PHY.verbatimXml | 
                     STR.E.nl | STR.E.ldots | STR.E.label | 
                     STR.E.ref | STR.E.pers | STR.E.opus | 
                     STR.E.persop | STR.E.emph | 
                     STR.E.xemph | STR.E.xlang | STR.LINK.treeInclude | 
                     STR.LINK.link | STR.BIB.cite | 
                     STR.IM.image | STR.LI.list | STR.TA.table | 
                     STR.footnote | STR.footnotemark | 
                     STR.footnotetext)*  | STR.p+ 

There may be one such part, under which the h1-elements are numbered with capital latin characters instead of numbers.

STR.h1+ 

STR.symbol?, (STR.kind?, X.lang?, (#chars | STR.PHY.bold | 
                                            STR.PHY.ital | 
                                            STR.PHY.ulin | 
                                            STR.PHY.blink | 
                                            STR.PHY.strikeout | 
                                            STR.PHY.scaps | 
                                            STR.PHY.hh | 
                                            STR.PHY.larger | 
                                            STR.PHY.smaller | 
                                            STR.PHY.indexlo | 
                                            STR.PHY.indexhi | 
                                            STR.PHY.spanstyle | 
                                            STR.PHY.src | 
                                            STR.PHY.verbatimXml | 
                                   STR.E.nl | STR.E.ldots | 
                                   STR.E.label | STR.E.ref | 
                                   STR.E.pers | STR.E.opus | 
                                   STR.E.persop | STR.E.emph | 
                                   STR.E.xemph | STR.E.xlang | 
                                   STR.LINK.treeInclude | 
                                   STR.LINK.link | 
                                   STR.BIB.cite | 
                                   STR.IM.image | STR.LI.list | 
                                   STR.TA.table | STR.footnote | 
                                   STR.footnotemark | 
                                   STR.footnotetext)*  | 
              STR.p+ )

STR.symbol?

STR.symbol?, (STR.kind?, X.lang?, (#chars | STR.PHY.bold | 
                                            STR.PHY.ital | 
                                            STR.PHY.ulin | 
                                            STR.PHY.blink | 
                                            STR.PHY.strikeout | 
                                            STR.PHY.scaps | 
                                            STR.PHY.hh | 
                                            STR.PHY.larger | 
                                            STR.PHY.smaller | 
                                            STR.PHY.indexlo | 
                                            STR.PHY.indexhi | 
                                            STR.PHY.spanstyle | 
                                            STR.PHY.src | 
                                            STR.PHY.verbatimXml | 
                                   STR.E.nl | STR.E.ldots | 
                                   STR.E.label | STR.E.ref | 
                                   STR.E.pers | STR.E.opus | 
                                   STR.E.persop | STR.E.emph | 
                                   STR.E.xemph | STR.E.xlang | 
                                   STR.LINK.treeInclude | 
                                   STR.LINK.link | 
                                   STR.BIB.cite | 
                                   STR.IM.image | STR.LI.list | 
                                   STR.TA.table | STR.footnote | 
                                   STR.footnotemark | 
                                   STR.footnotetext)*  | 
              STR.p+ )

STR.title, (STR.toctitle? & STR.reftitle?), (STR.p | 
                                             STR.LINK.embed | 
                                             STR.PHY.hr | 
                                             STR.source | 
                                             STR.FLOAT.floating | 
                                             STR.BIB.biblist | 
                                             STR.LINK.treeInclude_PROVIS)* , 
STR.h2* 

STR.title, (STR.toctitle? & STR.reftitle?), (STR.p | 
                                             STR.LINK.embed | 
                                             STR.PHY.hr | 
                                             STR.source | 
                                             STR.FLOAT.floating | 
                                             STR.BIB.biblist | 
                                             STR.LINK.treeInclude_PROVIS)* , 
STR.h3* 

STR.title, (STR.toctitle? & STR.reftitle?), (STR.p | 
                                             STR.LINK.embed | 
                                             STR.PHY.hr | 
                                             STR.source | 
                                             STR.FLOAT.floating | 
                                             STR.BIB.biblist | 
                                             STR.LINK.treeInclude_PROVIS)* , 
STR.h4* 

STR.title, (STR.toctitle? & STR.reftitle?), (STR.p | 
                                             STR.LINK.embed | 
                                             STR.PHY.hr | 
                                             STR.source | 
                                             STR.FLOAT.floating | 
                                             STR.BIB.biblist | 
                                             STR.LINK.treeInclude_PROVIS)* , 
STR.h5* 

STR.title, (STR.toctitle? & STR.reftitle?), (STR.p | 
                                             STR.LINK.embed | 
                                             STR.PHY.hr | 
                                             STR.source | 
                                             STR.FLOAT.floating | 
                                             STR.BIB.biblist | 
                                             STR.LINK.treeInclude_PROVIS)* , 
STR.h6* 

STR.title, (STR.toctitle? & STR.reftitle?), (STR.p | 
                                             STR.LINK.embed | 
                                             STR.PHY.hr | 
                                             STR.source | 
                                             STR.FLOAT.floating | 
                                             STR.BIB.biblist | 
                                             STR.LINK.treeInclude_PROVIS)* 

The text used for html header, DC meta tags, etc, where only plain text is allowed. Defaults to the (normal) title stripped from all mark-up.

[ pkind STR.LINK.S.ascii_lower U STR.LINK.S.ascii_upper ~ 
        (STR.LINK.S.alpha U '_' U '-' U STR.LINK.S.decimalDigit)~* ] ~ 
("+" ~ [ pkind STR.LINK.S.ascii_lower U STR.LINK.S.ascii_upper ~ 
               (STR.LINK.S.alpha U '_' U '-' U STR.LINK.S.decimalDigit)~* ])~* 

Attention: The first tag is implicit, ie. may not appear in source text.

#implicit STR.metaContentsTag.name, 
STR.metaContentsTag.content

The paragraph is the central means for organizing text, eg. wrt. language and kind.

When rendering to xhtml, the items contained in "kind" are prepended with "paragraphkind_" and then stored as "css class names", so that visual appearance can be controlled via css.
Furthermore, setting the variable user.p_kind_filter lets only pass those paragraphs with a non-empty intersection with this value.
ATTENTION: the values of "kind" are currently not restricted by an enumeration type (since enumeration are not yet rewritable!), but are free identifiers. So typos are not recognized and can cause missing or ill-rendered text.

Due to its central role in organization, the contents of p also includes tables and lists, which cannot be rendered in xhtml:p. The difference is bridged by the rotation algorithm. The transition between the possible contents is like this:

             d2d:h2                     xhtml:              
               |
               p                         p      list  p     table
      /    /   |   \    \              /  \           |
 chars link  list chars table       chars  link     chars  
      

In the other direction, a d2d:p can be contained also in containers like list item or table cell. Luckily, this is identical to xhtml:

          table/tr/td      
                   |
                   p
          list/i       = ul(ol)/li
               |                 |
               p                 p
      

STR.kind?, X.lang?, (#chars | STR.PHY.bold | STR.PHY.ital | 
                              STR.PHY.ulin | STR.PHY.blink | 
                              STR.PHY.strikeout | STR.PHY.scaps | 
                              STR.PHY.hh | STR.PHY.larger | 
                              STR.PHY.smaller | STR.PHY.indexlo | 
                              STR.PHY.indexhi | 
                              STR.PHY.spanstyle | STR.PHY.src | 
                              STR.PHY.verbatimXml | 
                     STR.E.nl | STR.E.ldots | STR.E.label | 
                     STR.E.ref | STR.E.pers | STR.E.opus | 
                     STR.E.persop | STR.E.emph | 
                     STR.E.xemph | STR.E.xlang | STR.LINK.treeInclude | 
                     STR.LINK.link | STR.BIB.cite | 
                     STR.IM.image | STR.LI.list | STR.TA.table | 
                     STR.footnote | STR.footnotemark | 
                     STR.footnotetext)* 

Parts are an optional top-level grid and identified with roman numbers. The chapter numbers beneath are reset with a new part, iff $user.partResetsChapterNumber = 'yes'.

STR.title, (STR.toctitle? & STR.reftitle?), (STR.p | 
                                             STR.LINK.embed | 
                                             STR.PHY.hr | 
                                             STR.source | 
                                             STR.FLOAT.floating | 
                                             STR.BIB.biblist | 
                                             STR.LINK.treeInclude_PROVIS)* , 
STR.h1* 

There may be one such part, under which (according to tradition) the h1-elements do not carry any numbering, like "index", "bibliography", "glossary", etc.

STR.h1+ 

The text with which references to this corpus part will be rendered. Defaults to the (normal) title.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | STR.BIB.cite | 
 STR.IM.image)* 

Larger unit of program source text, rendered as a text block on its own. Its input mode is "verbatim". This means (1) respecting whitespace and line breaks, (2) must be ended by an explicit end token, (3) all command characters will be ignored, except of those DIRECTLY followed by a tag of an explicitly mentioned direct sub-element (here: "label").

(#chars | STR.E.label | STR.LINK.treeInclude)* 

(STR.SET.all - STR.SET.whitespace)~+ 

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | STR.BIB.cite | 
 STR.IM.image)* 

The text with which this corpus part will be rendered in the Table Of Contents. Defaults to the (normal) title.

(#chars | STR.PHY.bold | STR.PHY.ital | STR.PHY.ulin | 
          STR.PHY.blink | STR.PHY.strikeout | STR.PHY.scaps | 
          STR.PHY.hh | STR.PHY.larger | STR.PHY.smaller | 
          STR.PHY.indexlo | STR.PHY.indexhi | 
          STR.PHY.spanstyle | STR.PHY.src | 
          STR.PHY.verbatimXml | STR.E.nl | STR.E.ldots | 
                                STR.E.label | STR.E.ref | 
                                STR.E.pers | STR.E.opus | 
                                STR.E.persop | STR.E.emph | 
                                STR.E.xemph | STR.E.xlang | 
 STR.LINK.treeInclude | STR.LINK.link | STR.BIB.cite | 
 STR.IM.image)* 

Character parser for more than one language, written without spaces and separated by + character. They are ALSO stored into ONE SINGLE xml.lang attribute, because the spec is not totally clear about the cardinality of language values, ie. of tokens in this attribute. INDEED, more than one language value are frequently required. The xslt library libbasic.d2d provides a template "firstLangInList(String p-list)" used for extracting the first language. This is normally treated as dominant/main/default language.

'a' .. 'z' ~ 'a' .. 'z' ~ ("-" ~ 'A' .. 'Z' ~ 'A' .. 'Z')? ~ 
('+' ~ 'a' .. 'z' ~ 'a' .. 'z' ~ ("-" ~ 'A' .. 'Z' ~ 
                                  'A' .. 'Z')?)~*