Text: structured, annotated string with links

In this context a text is a structured, annotated string with links:

structured. The structure is defined by tree of divisions: <div>.
annotated. Semantic annotations are inserted in the text: <span>.
linked. Links with other documents, references, images etc.. is defined: <link>.

Text division
The <div> tag indicates a text division which structures a textual document. Basic division classes are:

`section`	Text section: chapter, section (i.e. sub-divisions of chapter), paragraph, etc.. This is a synonym for the `<div id="id">..<b>title</b>..<a name="id"/>..` XHTML construct.
`abstract`	A few lines describing/summarizing the enclosing document contents.
`list`	Enumeration, i.e. list if items. Sub-divisions of an enumeration are the items. This is a synonym for the `<ul> <li>..` XHTML construct.
`table`	Table or spreadsheet. Sub-divisions of a table are the table rows and sub-divisions of the rows are the table cells. This is a synonym for the `<table> <tr> <td>..` XHTML construct.
`center`	Centered piece of text, used to emphasized a statement, insert an image, an equation, etc.. This is a synonym for the `<div align="center">..` XHTML construct.
`margin`	Marginal piece of text, e.g. annotations, side notes, etc.. This is a synonym for the `<div align="right">..` XHTML construct.
`figure`	A floating-body in the document: figure, table, .. The title and id allows to parametrize the figure.

while user-defined classes can be defined.

By convention a class of the form table:<class-name> refers to a user-defined table of the given class, with similar construct for list, ..

<div|d

name	type	default-value
*class*	`name`	`section`	The class specifies the role/function of the text division or user defined style.
*title*	`name`	Title of the text division.
id	`name`	Identifier to refer this text division.

>(string | div((*)?*) | span((*)?*) | link((*)?*))?*</div|d>

Text annotations: emphasizing and citation

The <span> tag indicates emphasis, i.e. an internal piece of text with a particular status or presentation.

<span|s

name	type	default-value
*class*	`name`	`section`	The class specifies the semantic of this piece of text or user defined style.
*style*	`string`	User defined style.

>(string | link((*)?*))?*</span|s>

Annotation are not supposed to have an id, in this context. The text division supports this property.

The <i>.. construct stands <span style="font-style: italic">.. XHTML construct.

The <tt>.. construct stands <span style="font-family: monospace">.. XHTML construct.

The <b>.. construct stands <span style="font-weight: bold">.. XHTML construct.

Text links: referring to external objects
The <link> tag indicates a semantic link, defined by one of these set of fields:

Link to an external document.

<link|l

name	type
*url*	`location`	External reference to a uniform resource location of the link's contents. It may be another document, an image (JPG, PNG of GIF file), a sound (MP3 or MIDI) or a video (MPEG file).
id	`name`	If defined, allows to refer to a fragment of text, defined in a `div` `id`.
*target*	`name`	If defined, defines the pop-up window where the document is shown, otherwise the contents replaces this one.

>string</link|l>

This is a synonym for the <a href="url"> .. construct.

Insertion of an image.

<link|l

name	type
*img*	`location`	Internal reference to an embedded image.

/>

In this context the image name must be a significant alternate description of the image contents.

This is a synonym for the <img src="img" alt="img"> .. construct.

Bibliographical citation.

<link|l

name	type
*ref*	`name`	Indicates an embedded reference to bibliographical citation.

/>

This is a synonym for the <a class="ref" href="..ref">ref</a> construct.

Indexed reference.

<link|l

name	type
*ura*	`name`	Indicates an abbreviated form (e.g., WWW, HTTP, URI, etc.) or an acronym (e.g., SONAR, etc.)
*where*	`location`	Indicates in which document this name is defined.

/>

This is a synonym for the <a class="ura" href="where#name">ura</a> construct.

Text parameter.

<link|l

name	type
*name*	`name`	Parameter name.
*type*	`name`	Parameter type.
*read*	`condition`	Whether this field is visible or implicit.
*write*	`condition`	Whether this field is editable.
*value*	`expression`	Defines the field value by a dynamic evaluation.

/>

Defines a parametric input or output value in the text.

About style information
The usual text rendering parameters are:

`font-family`	`string`	Font family name
`font-size`	`number`	Font size
`color`	`color`	Font color
other style		`font-weight: bold ; font-style: italic ; text-decoration: underline;`
`text-align`		`left\|right\|center\|justify`
`text-transform`		`capitalize\|uppercase\|lowercase`
`text-decoration`		`underline\|overline\|line-through\|blink`
`vertical-align`		`baseline\|sub\|super\|top\|text-top\|middle\|bottom\|text-bottom`

They are defined either

in the style field with a syntax of the form style="name:value; .." or
in the XHTML preamble of the form:
<html><head><title>..</title><style type='text/css'>

.my-class { font-size : 36 ; color : #ff0088; }

a { text-decoration:none }

../..

</style></head><body>..</body></html>
(here style parameters for a class of name my-class and the a tag are defined) or
in an external file referenced by:
<link href="./style.css" rel="stylesheet" type="text/css" />

using the style-sheet specifications.