D2d "d2d-meta", User's Manual

• List of Public Top-Level Tags (= Document Types)
• Containement Graph between Elements
• List of All Tags
• List of Tag Homonyms

• Definitions, sorted by source modules :

  • d2d-meta
  • basic
  • basic.citation
  • basic.inlineElements
  • basic.interDocuments
  • basic.physical
  • basic.sets
  • basic.simpleImage
  • basic.simpleLists
  • basic.simpleTables
  • basic.structure
  • basic.xmlInfra
• Survey on all Module Import Statements
• Survey on all "docu" entries

This is an automatically generated documentation page. It is part of the d2d user documentation of the BandM metatools meta programming and compiler construction toolkit.

This file documents the instantiated version of the module, where all rewritings and insertions are expanded. This shows how parsing really works. When many files are involved, their uninstantiated documentation may be more helpful for a survey.

List of Public Top-Level Tags (= Document Types)

• tags INLINE
• tags assumedXsltOutput
• tags docutext
• tags location
• tags nonStructuredTarget
• tags originalCharacterData
• tags originalComment
• tags parsingError
• tags warning

Containement Graph between Elements

List of All Tags

• tags INLINE
• tags align from basic.simpleImage:image.align via STR.IM.
• chars all from basic.sets:all via STR.E.S, STR.SET.
• chars alpha from basic.sets:alpha via S, STR.E.S, STR.LI.IN.S, STR.LI.S, STR.SET, STR.TA.IN.S, STR.TA.SETS.
• tags alt from basic.simpleImage:image.alt via STR.IM.
• chars ascii_alpha from basic.sets:ascii_alpha via STR.BIB.S.
• chars ascii_lower from basic.sets:ascii_lower via S, STR.BIB.S, STR.E.S, STR.LI.IN.S, STR.LI.S, STR.SET, STR.TA.IN.S, STR.TA.SETS.
• chars ascii_upper from basic.sets:ascii_upper via S, STR.BIB.S, STR.E.S, STR.LI.IN.S, STR.LI.S, STR.SET, STR.TA.IN.S, STR.TA.SETS.
• tags assumedXsltOutput
• tags blink from basic.physical:blink via STR.PHY.
• tags bold from basic.physical:bold via STR.PHY.
• tags border from basic.simpleTables:border via STR.TA.
• chars c from basic.simpleTables:c via STR.TA.
• chars cite from basic.citation:cite via STR.BIB.
• chars continues from basic.simpleLists:list.continues via STR.LI.
• chars decimalDigit from basic.sets:decimalDigit via S, STR.BIB.S, STR.E.S, STR.LI.IN.S, STR.LI.S, STR.SET, STR.TA.IN.S, STR.TA.SETS.
• tags docutext
• tags emph from basic.inlineElements:emph via STR.E.
• tags expected
• tags file from basic.simpleImage:image.file via STR.IM.
• tags footnote from basic.structure:footnote via STR.
• tags footnotemark from basic.structure:footnotemark via STR.
• tags footnotetext from basic.structure:footnotetext via STR.
• tags height from basic.simpleImage:image.height via STR.IM.
• tags hh from basic.physical:hh via STR.PHY.
• tags i from basic.simpleLists:list.i via STR.LI.
• tags image from basic.simpleImage:image via STR.IM.
• tags indexhi from basic.physical:indexhi via STR.PHY.
• tags indexlo from basic.physical:indexlo via STR.PHY.
• tags ital from basic.physical:ital via STR.PHY.
• chars key from basic.citation:key via STR.BIB.
• chars kind from basic.structure:kind via STR.
• enum kind
• chars label from basic.inlineElements:label via STR.E, STR.LI.IN, STR.TA.IN.
• chars lang from basic.xmlInfra:lang via STR.E.X, STR.X.
• tags larger from basic.physical:larger via STR.PHY.
• tags ldots from basic.inlineElements:ldots via STR.E.
• tags link from basic.interDocuments:link via STR.LINK.
• tags list from basic.simpleLists:list via STR.LI.
• enum listSymbol from basic.simpleLists:listSymbol via STR.LI.
• tags loc from basic.interDocuments:loc via STR.LINK.
• chars localRef
• tags location
• tags messageText
• tags mode from basic.interDocuments:mode via STR.LINK.
• tags nl from basic.inlineElements:nl via STR.E.
• tags nonStructuredTarget
• tags opus from basic.inlineElements:opus via STR.E.
• tags originalCharacterData
• tags originalComment
• tags p
• tags p from basic.structure:p via STR.
• tags parsingError
• tags path from basic.interDocuments:path via STR.LINK.
• tags pers from basic.inlineElements:pers via STR.E.
• chars persop from basic.inlineElements:persop via STR.E.
• chars ref from basic.inlineElements:ref via STR.E.
• tags refdate from basic.interDocuments:link.refdate via STR.LINK.
• tags scaps from basic.physical:scaps via STR.PHY.
• tags showLabel from basic.simpleImage:image.showLabel via STR.IM.
• tags skipped
• tags smaller from basic.physical:smaller via STR.PHY.
• tags source from basic.structure:source via STR.
• tags spanstyle from basic.physical:spanstyle via STR.PHY.
• tags src from basic.physical:src via STR.PHY.
• chars startnum from basic.simpleLists:list.startnum via STR.LI.
• tags strikeout from basic.physical:strikeout via STR.PHY.
• tags style from basic.physical:style via STR.PHY.
• chars symbol from basic.simpleLists:list.symbol via STR.LI.
• chars symbol from basic.structure:symbol via STR.
• tags table from basic.simpleTables:table via STR.TA.
• chars tag
• tags td from basic.simpleTables:td via STR.TA.
• tags text from basic.interDocuments:link.text via STR.LINK.
• tags th from basic.simpleTables:th via STR.TA.
• tags tr from basic.simpleTables:tr via STR.TA.
• tags treeInclude from basic.interDocuments:treeInclude via STR.LINK.
• tags ulin from basic.physical:ulin via STR.PHY.
• tags url from basic.interDocuments:url via STR.LINK.
• tags verbatimXml from basic.physical:verbatimXml via STR.PHY.
• tags warning
• chars whitespace from basic.sets:whitespace via STR.SET.
• tags width from basic.simpleImage:image.width via STR.IM.
• tags xemph from basic.inlineElements:xemph via STR.E.
• tags xlang from basic.inlineElements:xlang via STR.E.

List of Tag Homonyms

• chars kind from basic.structure:kind via STR.
• enum kind
• tags p
• tags p from basic.structure:p via STR.
• chars symbol from basic.simpleLists:list.symbol via STR.LI.
• chars symbol from basic.structure:symbol via STR.

^{^ToC}

Module d2d-meta

TAGS parser d2d-meta: INLINE

wrapper to parse any target language fragments in xslt parser

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":87.3-24

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:INLINE

TAGS parser d2d-meta: assumedXsltOutput

contains the reg exp which has been recognized as minimal nessary output

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":73.3-35

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:assumedXsltOutput

TAGS parser d2d-meta: docutext

this is the format of the human-readable documentation text, used for parsing and rendering. Therefore texts like this may be rich text.

(docutext.p | STR.source)* 

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":94.3-99.8

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:docutext

TAGS parser d2d-meta: expected

Used in : parsingError

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":29.3-19

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:expected

ENUMERATION d2d-meta: kind

In the generated XML, a value of this enum is stored by verbatim the input. This list is in source order; aliases in parenthesis:

Used in : parsingError -- warning

Homonyms:

• chars kind from basic.structure:kind via STR.

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":21.30-67

Xml tagging is ATT {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:kind

CHAR parser d2d-meta: localRef

S.ascii_lower U STR.E.S.ascii_upper ~ 
(STR.E.S.alpha U '_' U '-' U S.decimalDigit)~*  ~ 
("." ~ 
 S.ascii_lower U STR.E.S.ascii_upper ~ 
 (STR.E.S.alpha U '_' U '-' U S.decimalDigit)~* )~*  ~ 
" "?

Used in : .docutext.p

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":102.3-56

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:localRef

TAGS parser d2d-meta: location

Used in : parsingError -- warning

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":19.3-46

Xml tagging is ATT {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:location

TAGS parser d2d-meta: messageText

Used in : warning

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":26.3-22

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:messageText

TAGS parser d2d-meta: nonStructuredTarget

used as a placeholder when there is no top-level element in a target language of xslt rules.

Contents are defined as empty.

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":68.3-37

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:nonStructuredTarget

TAGS parser d2d-meta: originalCharacterData

additional storage for the parsed input of a character parser with sub-elements.

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":79.3-58

Xml tagging is ATT {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:originalCharacterData

TAGS parser d2d-meta: originalComment

comment text in the original d2d source.

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":83.3-33

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:originalComment

TAGS parser d2d-meta: docutext.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.TA.IN.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 | 
 localRef | STR.LI.list | STR.TA.table)* 

Used in : docutext

Homonyms:

• tags p from basic.structure:p via STR.

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":95.15-98.20

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:p

TAGS parser d2d-meta: parsingError

An error is signalled by this element, together with one of two different kinds of suggestions:

1. Either the tag is known and recognized, found somewhere later in the currently growing content models. But some contents seems (!!) to be missing before. Then a textual representation of the grammar expression which corresponds to that gap is put into "expected".
2. Or the tag cannot be found in all currently growing content models. Then the input data is skipped up to the next command character, and the next tag is tried. In this case the skipped input is contained in "skipped".

((kind, tag)? & location?), (expected | skipped)

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":28.3-61

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:parsingError

TAGS parser d2d-meta: skipped

Used in : parsingError

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":30.3-19

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:skipped

CHAR parser d2d-meta: tag

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

Used in : parsingError -- warning

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":23.3-36

Xml tagging is ATT {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:tag

TAGS parser d2d-meta: warning

((kind, tag)? & location?), messageText

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/d2d-meta.dd2":25.3-37

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/d2d-meta}d2d:warning

^{^ToC}

Module basic

This module is the central starting point for all our current applications of d2d, and a convenient starting point for any user. It contains (a) sub-modules and (b) functional libraries.

The sub-modules are listed the beginning of this file. Their sequential order in the source file is bottom-up in complexity: the very first sub-modules define infra-structure (like set); the middle ones model different organizations of text (starting with inlineElements); at the end these are combined to a complete text corpus architecture (starting with structure).

The modules are in very different state of development: Some of them are fully operative (like citation); others are operative, but utmost simple (like simpleLists); few are currently not employed at all, but only for demonstrative purpose (like personal_names_de);

Xslt code is currently (20150423) only given into xhtml_1_0, and into source files for different processors, allowing to embed the graphical output of lilypond, musixtex and LaTeX source directly. This is supported by the module interDocuments together with a dedicated Makefile system.

The xslt code in the following modules assumes some procedures (for string and file name manipulation, etc.) to be provided by the basic library "libbasic.xslt".
On the other side of the scale it assumes that the top-level module, which finally plugs all the sub-modules together, provides also some global services like a template with name "muliDefault", to find the translation into the selected language, and some parameter definitions, which have default values depending on the top-level intentions ($user.p_kind_filter, GEHT ABER DOCHNICHT ZURZEITetc.)

((FIXME The basic lib could be moved HERE, as an inline code.))
((FIXME The muliDefault could be moved from top-level to lowest level (REALLY?) ))

^{^ToC}

Module basic.citation

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.

CHAR parser basic.citation: cite via STR.BIB

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 - '!')~+ ] ~ '!')?

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1096.5-58

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:cite

CHAR parser basic.citation: key via STR.BIB

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 S.decimalDigit)~+ 

Used in : cite

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1084.5-56

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:key

^{^ToC}

Module basic.inlineElements

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.

TAGS parser basic.inlineElements: emph via STR.E

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.TA.IN.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)* 

Used in : ITSELF recursively! -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":344.5-32

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:emph

CHAR parser basic.inlineElements: label via STR.E, STR.LI.IN, STR.TA.IN

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.

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

Used in : emph -- footnote -- footnotetext -- list.i -- list -- .docutext.p -- STR.p -- source -- table -- td -- link.text -- th -- tr -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":366.5-22

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:label

TAGS parser basic.inlineElements: ldots via STR.E

Draws three low dots surrounded by spaces.

Contents are defined as empty.

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":362.5-18

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:ldots

TAGS parser basic.inlineElements: nl via STR.E

Forces a line break, but not a new paragraph.

Contents are defined as empty.

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":358.5-15

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:nl

TAGS parser basic.inlineElements: opus via STR.E

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.

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":632.5-17

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:opus

TAGS parser basic.inlineElements: pers via STR.E

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.

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":622.5-17

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:pers

CHAR parser basic.inlineElements: persop via STR.E

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 - '!')* ] ~ "!"

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":641.5-76

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:persop

CHAR parser basic.inlineElements: ref via STR.E

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 ..."

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

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":397.5-20

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:ref

TAGS parser basic.inlineElements: xemph via STR.E

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.TA.IN.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)* 

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- ITSELF recursively! -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":345.5-33

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:xemph

TAGS parser basic.inlineElements: xlang via STR.E

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. it may not appear in a document source.

#implicit STR.E.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.TA.IN.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)* 

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- xemph -- ITSELF recursively!

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":649.5-52

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:xlang

^{^ToC}

Module basic.interDocuments

Primitive elements for embedding of and linking to other documents.

TAGS parser basic.interDocuments: link via STR.LINK

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. it may not appear in a document source.

#implicit STR.LINK.url, 
(STR.LINK.link.text? & STR.LINK.loc? & 
 STR.LINK.link.refdate?)

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":726.5-734.11

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:link

TAGS parser basic.interDocuments: loc via STR.LINK

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.

#chars

Used in : link

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":742.5-36

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:loc

TAGS parser basic.interDocuments: mode via STR.LINK

Used in : treeInclude

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":883.5-42

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:mode

TAGS parser basic.interDocuments: path via STR.LINK

Used in : treeInclude

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":883.5-42

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:path

TAGS parser basic.interDocuments: link.refdate via STR.LINK

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

Used in : link

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":733.9-24

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:refdate

TAGS parser basic.interDocuments: link.text via STR.LINK

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.TA.IN.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)* 

Used in : link

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":730.9-29

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:text

TAGS parser basic.interDocuments: treeInclude via STR.LINK

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. it may not appear in a document source.

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

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- source -- td -- link.text -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":866.5-868.24

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:treeInclude

TAGS parser basic.interDocuments: url via STR.LINK

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.

#chars

Used in : link -- treeInclude

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":741.5-36

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:url

^{^ToC}

Module basic.physical

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.

TAGS parser basic.physical: blink via STR.PHY

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)* 

Used in : ITSELF recursively! -- bold -- emph -- footnote -- footnotetext -- list.i -- indexhi -- indexlo -- ital -- larger -- .docutext.p -- STR.p -- scaps -- smaller -- spanstyle -- strikeout -- td -- link.text -- th -- ulin -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":240.5-241.68

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:blink

TAGS parser basic.physical: bold via STR.PHY

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)* 

Used in : blink -- ITSELF recursively! -- emph -- footnote -- footnotetext -- list.i -- indexhi -- indexlo -- ital -- larger -- .docutext.p -- STR.p -- scaps -- smaller -- spanstyle -- strikeout -- td -- link.text -- th -- ulin -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":240.5-241.68

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:bold

TAGS parser basic.physical: hh via STR.PHY

Draws a hashmark sign. Is currently the only element which can be included in src.

Contents are defined as empty.

Used in : blink -- bold -- emph -- footnote -- footnotetext -- list.i -- indexhi -- indexlo -- ital -- larger -- .docutext.p -- STR.p -- scaps -- smaller -- spanstyle -- src -- strikeout -- td -- link.text -- th -- ulin -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":246.5-15

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:hh

TAGS parser basic.physical: indexhi via STR.PHY

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)* 

Used in : blink -- bold -- emph -- footnote -- footnotetext -- list.i -- ITSELF recursively! -- indexlo -- ital -- larger -- .docutext.p -- STR.p -- scaps -- smaller -- spanstyle -- strikeout -- td -- link.text -- th -- ulin -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":240.5-241.68

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:indexhi

TAGS parser basic.physical: indexlo via STR.PHY

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)* 

Used in : blink -- bold -- emph -- footnote -- footnotetext -- list.i -- indexhi -- ITSELF recursively! -- ital -- larger -- .docutext.p -- STR.p -- scaps -- smaller -- spanstyle -- strikeout -- td -- link.text -- th -- ulin -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":240.5-241.68

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:indexlo

TAGS parser basic.physical: ital via STR.PHY

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)* 

Used in : blink -- bold -- emph -- footnote -- footnotetext -- list.i -- indexhi -- indexlo -- ITSELF recursively! -- larger -- .docutext.p -- STR.p -- scaps -- smaller -- spanstyle -- strikeout -- td -- link.text -- th -- ulin -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":240.5-241.68

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:ital

TAGS parser basic.physical: larger via STR.PHY

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)* 

Used in : blink -- bold -- emph -- footnote -- footnotetext -- list.i -- indexhi -- indexlo -- ital -- ITSELF recursively! -- .docutext.p -- STR.p -- scaps -- smaller -- spanstyle -- strikeout -- td -- link.text -- th -- ulin -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":240.5-241.68

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:larger

TAGS parser basic.physical: scaps via STR.PHY

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)* 

Used in : blink -- bold -- emph -- footnote -- footnotetext -- list.i -- indexhi -- indexlo -- ital -- larger -- .docutext.p -- STR.p -- ITSELF recursively! -- smaller -- spanstyle -- strikeout -- td -- link.text -- th -- ulin -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":240.5-241.68

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:scaps

TAGS parser basic.physical: smaller via STR.PHY

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)* 

Used in : blink -- bold -- emph -- footnote -- footnotetext -- list.i -- indexhi -- indexlo -- ital -- larger -- .docutext.p -- STR.p -- scaps -- ITSELF recursively! -- spanstyle -- strikeout -- td -- link.text -- th -- ulin -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":240.5-241.68

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:smaller

TAGS parser basic.physical: spanstyle via STR.PHY

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

Attention: The first tag is implicit, ie. it may not appear in a document source.

#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)* 

Used in : blink -- bold -- emph -- footnote -- footnotetext -- list.i -- indexhi -- indexlo -- ital -- larger -- .docutext.p -- STR.p -- scaps -- smaller -- ITSELF recursively! -- strikeout -- td -- link.text -- th -- ulin -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":243.5-59

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:spanstyle

TAGS parser basic.physical: src via STR.PHY

Small piece of program source text, character data only! Is rendered inline and in tele-type fonts. Can include only character data, or #hh/ to include a hashmark sign "#".

(#chars | STR.PHY.hh)* 

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":313.5-29

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:src

TAGS parser basic.physical: strikeout via STR.PHY

(#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)* 

Used in : blink -- bold -- emph -- footnote -- footnotetext -- list.i -- indexhi -- indexlo -- ital -- larger -- .docutext.p -- STR.p -- scaps -- smaller -- spanstyle -- ITSELF recursively! -- td -- link.text -- th -- ulin -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":240.5-241.68

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:strikeout

TAGS parser basic.physical: style via STR.PHY

Used in : spanstyle

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":244.5-37

Xml tagging is ATT {http://bandm.eu/doctypes/d2d_gp/basic}a:style

TAGS parser basic.physical: ulin via STR.PHY

(#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)* 

Used in : blink -- bold -- emph -- footnote -- footnotetext -- list.i -- indexhi -- indexlo -- ital -- larger -- .docutext.p -- STR.p -- scaps -- smaller -- spanstyle -- strikeout -- td -- link.text -- th -- ITSELF recursively! -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":240.5-241.68

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:ulin

TAGS parser basic.physical: verbatimXml via STR.PHY

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.

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":253.5-49

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:verbatimXml

^{^ToC}

Module basic.sets

CHAR parser basic.sets: all via STR.E.S, STR.SET

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

Used in : persop -- STR.symbol

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":90.5-27

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:all

CHAR parser basic.sets: alpha via S, STR.E.S, STR.LI.IN.S, STR.LI.S, STR.SET, STR.TA.IN.S, STR.TA.SETS

S.ascii_lower U STR.E.S.ascii_upper

Used in : c -- list.continues -- STR.kind -- label -- localRef -- ref -- tag

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":107.5-20

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:alpha

CHAR parser basic.sets: ascii_alpha via STR.BIB.S

S.ascii_lower U STR.E.S.ascii_upper

Used in : key

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":105.5-39

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:ascii_alpha

CHAR parser basic.sets: ascii_lower via S, STR.BIB.S, STR.E.S, STR.LI.IN.S, STR.LI.S, STR.SET, STR.TA.IN.S, STR.TA.SETS

'a' .. 'z'

Used in : alpha -- ascii_alpha -- list.continues -- STR.kind -- label -- localRef -- ref -- tag

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":103.5-30

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:ascii_lower

CHAR parser basic.sets: ascii_upper via S, STR.BIB.S, STR.E.S, STR.LI.IN.S, STR.LI.S, STR.SET, STR.TA.IN.S, STR.TA.SETS

'A' .. 'Z'

Used in : alpha -- ascii_alpha -- list.continues -- STR.kind -- label -- localRef -- ref -- tag

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":104.5-30

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:ascii_upper

CHAR parser basic.sets: decimalDigit via S, STR.BIB.S, STR.E.S, STR.LI.IN.S, STR.LI.S, STR.SET, STR.TA.IN.S, STR.TA.SETS

'0' .. '9'

Used in : c -- list.continues -- key -- STR.kind -- label -- localRef -- ref -- tag

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":96.5-34

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:decimalDigit

CHAR parser basic.sets: whitespace via STR.SET

' ' U \t U \n U \r

Used in : STR.symbol

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":116.5-48

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:whitespace

^{^ToC}

Module basic.simpleImage

TAGS parser basic.simpleImage: image.align via STR.IM

Used in : image

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1851.7-39

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:image_align

TAGS parser basic.simpleImage: image.alt via STR.IM

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.

Used in : image

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1852.7-18

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:image_alt

TAGS parser basic.simpleImage: image.file via STR.IM

Used in : image

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1849.7-42

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:image_file

TAGS parser basic.simpleImage: image.height via STR.IM

Used in : image

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1850.7-47

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:image_height

TAGS parser basic.simpleImage: image via STR.IM

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

Used in : emph -- footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- link.text -- th -- xemph -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1847.5-1854.9

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:image

TAGS parser basic.simpleImage: image.showLabel via STR.IM

Contents are defined as empty.

Used in : image

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1853.7-24

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:image_showLabel

TAGS parser basic.simpleImage: image.width via STR.IM

Used in : image

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1850.7-47

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:image_width

^{^ToC}

Module basic.simpleLists

A very simple list module.

CHAR parser basic.simpleLists: list.continues via STR.LI

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

Used in : list

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1574.7-28

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:listContinues

TAGS parser basic.simpleLists: list.i via STR.LI

(#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.TA.IN.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)* 

Used in : list

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1575.7-1576.25

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:listitem

TAGS parser basic.simpleLists: list via STR.LI

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

Used in : footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- th

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1570.5-1577.9

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:list

ENUMERATION basic.simpleLists: listSymbol via STR.LI

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

In the generated XML, a value of this enum is stored by verbatim the input. This list is in source order; aliases in parenthesis:

Used in : STR.LI.list.symbol

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1590.5-1594.32

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:listSymbol

CHAR parser basic.simpleLists: list.startnum via STR.LI

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')~+ 

Used in : list

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1572.7-27

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:listStartnum

CHAR parser basic.simpleLists: list.symbol via STR.LI

@listSymbol

Used in : list

Homonyms:

• chars symbol from basic.structure:symbol via STR.

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1573.7-23

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:listSymbol

^{^ToC}

Module basic.simpleTables

TAGS parser basic.simpleTables: border via STR.TA

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

Used in : table

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1727.5-19

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:border

CHAR parser basic.simpleTables: c via STR.TA

(STR.E.S.alpha U '_' U '-' U S.decimalDigit)~+ 

Used in : td

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1711.5-54

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:tdCls

TAGS parser basic.simpleTables: table via STR.TA

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.TA.IN.label?), STR.TA.tr* 

Used in : footnote -- footnotetext -- list.i -- .docutext.p -- STR.p -- td -- th

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1705.5-44

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:table

TAGS parser basic.simpleTables: td via STR.TA

STR.TA.c?, 
(#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.TA.IN.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)* 

Used in : tr

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1710.5-32

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:td

TAGS parser basic.simpleTables: th via STR.TA

(#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.TA.IN.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)* 

Used in : tr

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1713.5-28

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:th

TAGS parser basic.simpleTables: tr via STR.TA

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

Used in : table

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":1706.5-39

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:tr

^{^ToC}

Module basic.structure

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.

TAGS parser basic.structure: footnote via STR

STR.symbol?, 
(STR.kind?, STR.E.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.TA.IN.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+ )

Used in : ITSELF recursively! -- footnotetext -- list.i -- STR.p -- td -- th

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":2364.5-54

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:footnote

TAGS parser basic.structure: footnotemark via STR

STR.symbol?

Used in : footnote -- footnotetext -- list.i -- STR.p -- td -- th

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":2366.5-31

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:footnotemark

TAGS parser basic.structure: footnotetext via STR

STR.symbol?, 
(STR.kind?, STR.E.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.TA.IN.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+ )

Used in : footnote -- ITSELF recursively! -- list.i -- STR.p -- td -- th

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":2364.5-54

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:footnotetext

CHAR parser basic.structure: kind via STR

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

Used in : footnote -- footnotetext -- STR.p

Homonyms:

• enum kind

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":2284.5-61

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:kind

TAGS parser basic.structure: p via STR

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?, STR.E.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.TA.IN.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)* 

Used in : footnote -- footnotetext -- list.i -- td -- th

Homonyms:

• tags p

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":2242.5-45

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:p

TAGS parser basic.structure: source via STR

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.TA.IN.label | STR.LINK.treeInclude)* 

Used in : docutext

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":2454.5-2456.35

Xml tagging is {http://bandm.eu/doctypes/d2d_gp/basic}a:SRC

CHAR parser basic.structure: symbol via STR

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

Used in : footnote -- footnotemark -- footnotetext

Homonyms:

• chars symbol from basic.simpleLists:list.symbol via STR.LI.

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":2368.5-62

Xml tagging is ATT {http://bandm.eu/doctypes/d2d_gp/basic}a:symbol

^{^ToC}

Module basic.xmlInfra

Xml infrastructure, definition of ubiquituous attributes and their data type. Corresponds mostly to the xml namespace and the definitions in http://www.w3.org/XML/1998/namespace, namely w.r.t. "xml:lang", "xml:space", "xml:base" and "xml:id"

CHAR parser basic.xmlInfra: lang via STR.E.X, STR.X

The xml namespace description in http://www.w3.org/XML/1998/namespace refers to http://www.w3.org/TR/xml/#sec-lang-tag for the xml:lang attribute, which in turn refers to [IETF BCP 47], which shall consist of "RFC 4646: Tags for Identifying Languages", http://tools.ietf.org/html/rfc4646 and "RFC 4647: Matching of Language Tags", http://tools.ietf.org/html/rfc4647. This is currently (20150423) already obsoleted by http://tools.ietf.org/html/rfc5646.
The second does define the processing of LISTS of language selectors, but not their syntax. Anyhow, xml:lang seems to be forseen only for one(1) such language code. Our handling deliberately violates the specification and allows more than one language, cf. parser "langs".
The precedessor is [IETF RFC 3066] http://www.ietf.org/rfc/rfc3066.txt.
The character parser implemented here is a very primitive variant of the older "two-(plus-two)" format of the ISO language code, and stores it as the xml standard attribute "xml:lang".

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

Used in : footnote -- footnotetext -- STR.p -- xlang

Source is at SYSTEM "http://bandm.eu/doctypes/d2d_gp/basic.dd2":167.5-168.25

Xml tagging is ATT {http://www.w3.org/XML/1998/namespace}xml:lang

^{^ToC}

Survey on all Module Import Statements

^{^ToC}

Survey on all "docu" entries

^{^ToC}

D2d "d2d-meta", User's Manual

Created on 2024-09-23_07h47m32
by program BandM d2d, version 2.0.1
command line =
java BandM d2d --path LIB_GP RES_eu.bandm.tools.doctypes.DocTypes/xhtml --mode ddf2doc --key en --static 0 --debug 0 --source d2d-meta --additionalSources --outputfile . --lineWidth 50 --stylesheetParams user.iconUrl http://bandm.eu/metatools/docs/usage/mtlogo_16x16.png {}user.preambleFile ./doc_preamble_inst_en.html-text