Standard Generalized Markup Language

Le format Standard Generalized Markup Language (SGML) d'Ibm est un flux au format texte Ascii balisé utilisant une structure bien définie appelée Document Type Definition (DTD).

Une balise est un identifiant entouré par les caractères inférieur < et supérieur >. Par exemple <MaBalise>.

La structure Dtd peut être soit :

Incluse en début du flux Sgml.
Référencée en début du flux Sgml au travers d'une Uniform Resource Identifier (URI) qui pointe un fichier contenant la grammaire Dtd.

Format de la Document Type Definition utilisée par Up ! Standard Generalized Markup Language

La grammaire Dtd est un flux au format texte Ascii balisé utilisant aussi une structure bien définie.

Ainsi, la Dtd est un flux Sgml particulier.

Voici les conventions lexicales :

Séparateurs.
Les séparateurs sont les caractères espace , retour chariot \t, saut de ligne \n et tabulation \t.
Ils ne sont pas conservés dans les données.
Commentaires.
Un commentaire multi-ligne est encadré par les balises <-- et -->. Par exemple :

<-- Ceci est un commentaire.
Ceci est un second commentaire. -->
Chaîne de caractères.
Une chaîne de caractères peut se délimiter par les caractères soit apostrophe ' ou soit guillemet ". Par exemple :

'Ceci est ma chaîne.'
Ceci est ma seconde chaîne."
Date.
Une date est une chaîne de caractères au format JJ-MON-AAAA HH:MM:SS. Par exemple :

30-JAN-2008 21:42:30"
Entier.
Un entier est représenté par une suite de chiffres 0 à 9 précédent éventuellement de soustraction -. Par exemple :

123456
-123456
Identifiant.
Un identifiant commence par une lettre et il est suivi éventuellement de lettres, de chiffres ou du caractère soustraction - .
La différence entre les majuscules et les minuscules est ignorée. Par exemple :

MonIdentifiant
mon-identidiant
Réel.
Un entier est représenté en notation décimale ou scientifique. Par exemple :

123.456
-1.23456E3

Voici les concepts sémantiques :

Entités.
Zones de texte.
Eléments.
Attributs des éléments.
Notations.

Entités

Les entités permettent de factoriser le source de la Dtd ou du flux Sgml afin de rendre des parties de celui-ci réutilisable.

Une définition d'entité est utilsable dans la Dtd si son nom est précédé du caractère pourcent % .

Enfin, une entité permet d'utiliser les caractères réservés au Sgml avec une syntaxe spéciale :

Caractère réservé.	Syntaxe.
`<`	`<`
`>`	`>`
`&`	`&`
`"`	`"`
`'`	`'`
Caractère donné par son code hexadécimal.	`&#`CodeHexadecimal`;`

Exemple : <MonElement> < > & " ' ) </MonElement>

Il est possible de définir ses propres entités qui tiennent alors lieu de paramètres. Par exemple :

<!ENTITY MonEntite SYSTEM MaValeur">

s'utilise comme cela :

<!MaBalise>Ceci est mon entité &MonEntite;</MaBalise>

Zones de texte

Une zone de texte est une portion du flux Standard Generalized Markup Language (SGML) entre deux balises imbriquées ou non. Il n'a donc aucune signification au regard de la Document Type Definition (DTD).

La zone de texte peut être soit :

Analysée par le décodeur Sgml pour appliquer les entités et reconnaître les balises i.e. Parsed Character Data (PCDATA).
En ce cas :
- Son contenu doit respecter la syntaxe Sgml contrainte par la Dtd.
- Sa syntaxe pour sa déclaration dans la Dtd est #PCDATA.
Partiellement analysée par le décodeur Sgml pour appliquer les entités i.e. Relative Character Data (RCDATA).
En ce cas :
- Sa syntaxe dans le flux Sgml est entre les balises <![RCDATA[ et ]]>.
- Sa syntaxe pour sa déclaration dans la Dtd est #RCDATA.
Non analysée par le décodeur Sgml i.e. Character Data (CDATA).
En ce cas :
- Sa syntaxe dans le flux Sgml est entre les balises <![CDATA[ et ]]>.
- Sa syntaxe pour sa déclaration dans la Dtd est #CDATA.

Eléments

Un élément permet de structurer le flux Standard Generalized Markup Language (SGML). Il donne lieu à au plus deux balises, l'une d'ouverture, l'autre de fermeture.

Les balises d'ouverture et de fermeture sont signalées par deux caractères soit soustraction - quand l'une ou l'autre est obligatoire ou soit O quand l'une ou l'autre est facultative.

Un élément peut :

Ne rien contenir.
En ce cas :
- Sa syntaxe dans le flux Sgml est en une balise : <MonElement2/>.
- Sa syntaxe pour sa déclaration dans la Dtd est : <!ELEMENT MonElement1 - - EMPTY>.
Contenir d'autres éléments ou du texte libre.
En ce cas :
- Sa syntaxe dans le flux Sgml est en deux balises : <MonElement1>Ceci est mon contenu</MonElement1>.
- Sa syntaxe pour sa déclaration dans la Dtd permet de définir formellement le contenu de la balise à partir d'une expression régulière construite à partir de :
  - Mots-clé.
    - #CDATA, #PCDATA et #RCDATA présentés dans la section précédente.
    - ANY pour signifier n'importe quel contenu - rien, texte ou balises.
  - Noms des balises imbriquées.
  - Opérateurs.
    - (A) pour isoler une sous-expression régulière - La balise A dans l'exemple.
    - A , B pour reconnaître en séquence deux sous-expressions régulières - Les balises A et B dans l'exemple.
    - A | B pour reconnaître une de deux sous-expressions régulières - Les balises A et B dans l'exemple.
    - A? pour reconnaître zéro ou une occurrence d'une sous-expression régulière - La balise A dans l'exempleans l'exemple.
    - A pour reconnaître exactement une occurrence d'une sous-expression régulière - La balise A dans l'exemple.
    - A* pour reconnaître zéro, une ou plusieurs occurences d'une sous-expression régulière - La balise A dans l'exemple.
    - A+ pour reconnaître une ou plusieurs occurences d'une sous-expression régulière - La balise A dans l'exemple.
  Par exemple <!ELEMENT MonElement1 - - #PCDATA>.

Attributs

Un élément du flux Standard Generalized Markup Language (SGML) peut posséder zéro, un ou plusieurs attributs nommés par un identifiant.

La syntaxe d'un attribut dans le flux Sgml est une affectation d'une valeur entre caractères guillemet " ou apostrophe ' au nom de l'attribut :

<MonElement MonAttributA=..." MonAttributB=..." MonAttributC=...">...</MonElement>

Un attribut possède un type :

Type.	Syntaxe.
Enuméré.	`(` Valeur1 `, ... ,` ValeurN `)`
Valeur libre.	`CDATA`
Identifiant unique.	`ID`
Identifiant d'un attribut d'un autre élement.	`IDREF`
Liste d'identifiants des attributs d'autres élements.	`IDREFS`
Identificateur - Un nom.	`NMTOKEN`
Liste d'identificateur.	`NMTOKENS`
Nombre entier.	`NUMBER`
Nom d'une entité Sgml.	`ENTITY`
Liste de noms d'entités Sgml.	`ENTITIES`
Notation Sgml.	`NOTATION`

Un attribut possède une valeur :

Valeur.	Syntaxe.
Valeur par défaut.	Valeur
Dernière valeur utilisée.	`#CURRENT`
Valeur obligatoire.	`#REQUIRED`
Valeur facultative.	`#IMPLIED`
Valeur imposée.	`#FIXED Valeur`

La syntaxe pour sa déclaration dans la Dtd est : <!ATTLIST MonElement MonAttribut Type ValeurParDefaut >.

Par exemple :

<!ATTLIST MonAttributA CDATA Ma valeur"> <!ATTLIST MonAttributB ID #REQUIRED> <!ATTLIST MonAttributC NOTATION (ImageGif|ImagePng) #REQUIRED >

Notations

Une notation permet de référencer une application externe à l'application faisant appel au décoder Standard Generalized Markup Language (SGML) dans le but de prendre en compte une valeur d'une entité marquée comme étant à ne pas analyser via l'instruction NDATA.

Par exemple :

<!NOTATION ImageGif SYSTEM file://programs/gif.exe">

Balises particulières

Voici les balises particulières :

La balise ! DOCTYPE sert à inclure ou référencer un Dtd dans un flux Sgml.
Elle cite la balise racine permettant d'analyser le contenu du flux Sgml.
Dans l'exemple suivant, la balise principale est ListeEmployes :

<!DOCTYPE ListeEmployes SYSTEM ${UPS_HOME}/upsedi/resources/${UPS_LANGUAGE}/mon-dtd.dtd">
La balise ? NomDeLaBalise sert à inclure une directive à destination de l'application utilisant le flux Sgml. Elle est transmise par le décodeur Sgml.
Par exemple :
<? UpsMxr:DefinitionsProgramme Source Composant Exemple d'emploi d'Up ! Mixer et Up ! Sgml" Version 4.0.0; ImporterModule /************/ UpsQry(<UpsQry.upi>, ImporterDefinitions); UpsOra(<UpsOra.upi>, ImporterDefinitions); ?>
La partie de la Dtd entre les balises <![ INCLUDE [ et ]]> sert à inclure les définitions de la Dtd.
La partie de la Dtd entre les balises <![ IGNORE [ et ]]> sert à ignorer les définitions de la Dtd.

Xml variante du Sgml

La variante la plus connue du Standard Generalized Markup Language (SGML) est le eXtended Markup Language (XML) en version 1.0 ou 1.1 du World Wide Web Consortium (W3C).

Seules ces deux versions utilisent une grammaire au format Document Type Definition (DTD).

Voici les restrictions à apporter au standard Smgl pour être compatible avec le standard Xml 1.0 ou 1.1 :

Le flux Xml commence par la balise suivante l'identifiant comme tel :

<?xml version=1.1" encoding=UTF-8" standalone=no" ?>
- La propriété version précise la version de Xml.
- La propriété encoding précise la page de codes du flux Xml - ISO-10646-UCS-2, ISO-10646-UCS-4, ISO-8859-1, UTF-8, UTF-16, etc.
- Si la propriété standalone a pour valeur yes, alors le contenu du flux Xml n'est pas affecté par les déclarations dans la Dtd externe.
  En pratique, les valeurs ne sont pas prises en compte. Par défaut, la valeur est no.
Un identifiant peut utiliser les caractères souligné - ou deux points : . La différence entre les majuscules et les minuscules n'est pas ignorée.
Les identifiants comprenant le caractère deux-points : ont un sémantique particulière et ceux commençant par xml ou XML sont réservés.
Chaque balise comporte des propriétés supplémentaires déclarées automatiquement :
- xml:space permet de spécifier comment gérer les séparateurs pour tout le contenu de la balise.
  - Avec xml:space=default, les séparateurs sont gérés comme en Sgml i.e. ignorés.
  - Avec xml:space=preserve, les séparateurs sont préservés i.e. transmis à l'application.
  Par défaut, les séparateurs sont gérés comme en Sgml.
- xml:lang permet de spécifier quel est la langue du contenu de la balise.
  Par exemple : xml:lang=fr".
Les marqueurs d'ouverture et de fermetures d'une balise sont toujours obligatoires.
De ce fait, la syntaxe de Dtd devient :
De ce fait, la syntaxe de Dtd devient :
LexemeDtd : ... | <! ELEMENT NomDeLElement ExpressionContenuElement > ... Et la syntaxe de Xml est :
LexemeXml : ... | < NomDeLaBalise ListeDeProprietesSgmlOption > ListeDeLexemesSgmlOption < / NomDeLaBalise> | < / NomDeLaBalise ListeDeProprietesSgmlOption > ...
Les exceptions de balises par inclusion ou exclusion ne sont pas supportées.
Les instructions CURRENT, NUMBER et RCDATA ne sont pas supportées.

Syntaxe d'un flux Sgml

Syntaxe d'un Document Type Definition

Dtd :

ListeDeLexemesDtdOption

ListeDeLexemesDtdOption :

<--

Commentaire

-->

<![ IGNORE [

ContenuLibre

]]>

<![ INCLUDE [

ListeDeLexemesDtdOption

]]>

<! ATTLIST

NomDeLElement

ListeDAttributs

<! ELEMENT

ListeDElements

OptionBalise

ExpressionContenuElement

>

<! ENTITY

PrefixeEntiteOption

NomDeLEntite

ValeurEntite

>

<! NOTATION

NomDeLaNotation

SuiteNotation

PrefixeEntite :

%

ValeurEntite :

ValeurEntite

PUBLIC

Description

URI

SYSTEM

URI

SuiteValeurEntite

SuiteValeurEntite :

NDATA

NomDeLaNotation

ListeDElements :

NomDeLElement

(

ListeDElements2

)

ListeDElements2 :

NomDeLElement

ListeDElements2

,

NomDeLElement

OptionBalise :

-

O

ExpressionContenuElement :

ANY

#CDATA

EMPTY

#PCDATA

#RCDATA

NomDUneBalise

NbOccurrencesOption

(

ExpressionContenuElement

) NbOccurrencesOption

ExpressionContenuElement

,

ExpressionContenuElement

|

ExpressionContenuElement

-

ExpressionContenuElement

+

ExpressionContenuElement

NbOccurrencesOption :

?

+

*

,

NomDeLAttribut

ValeurParDefautAttribut

TypeAttribut :

CDATA

ID

IDREF

ENTITY

ENTITIES

NUMBER

NOTATION (

ListeDeValeursAttribut

)

NMTOKEN

NMTOKENS

ListeDeValeursAttribut

)

ListeDeValeursAttribut :

ValeurAttribut

ListeDeValeursAttribut

|

ValeurAttribut

ValeurAttribut :

Entier

Reel

Identifiant

ChaineEntreApostrophes

ChaineEntreGuillemets

&

NomDeLEntite

;

ValeurParDefautAttribut :

#CURRENT

#IMPLIED

#FIXED

ValeurAttribut

#REQUIRED

ValeurAttribut

SuiteNotation :

PUBLIC

Description

URI

SYSTEM

URI

SuiteValeurEntite

Syntaxe d'un flux au format Standard Generalized Markup Language

FluxSgml :

PrologueOption

ContenuSgmlOption

PrologueOption :

<! DOCTYPE

NomBaliseRacine

DtdExterne

DtdInterne

>

DtdExterne :

PUBLIC

Description

URI

SYSTEM

URI

DtdInterne :

[

ListeDeLexemesDtdOption

]

ContenuUnitaireSgml :

ContenuLibreSansMarqueNiAccolade

<![ CDATA [

ContenuLibreSansCrochetsFermants

]]>

<![ IGNORE [

ContenuLibreSansCrochetsFermants

]]>

<![ INCLUDE [

ContenuSgmlOption

]]>

<![ PCDATA [

ContenuSgmlOption

]]>

<![ RCDATA [

ContenuLibreSansCrochetsFermants

]]>

<--

CommentaireSansSoustrations

-->

Balise

Entite

Balise :

<

NomBalise

ListeDAttributsOption

SuiteBalise

NomBalise :

NomBalise

Prefixe

:

NomBalise

ListeDAttributsOption :

=

NomAttribut

Prefixe

:

NomAttribut

ValeurAttribut :

'

ContenuEntreApostrophes

'

"

ContenuEntreGuillemets

"

ContenuEntreApostrophes :

ContenuLibreSansApostropheNiAccolade

''

Entite

Entite :

& amp ;

& apos ;

& gt ;

& lt ;

& quot ;

& # CodeUnicode ;

ContenuEntreGuillemets :

ContenuLibreSansGuillemetNiAccolade

""

Entite

SuiteBalise :

/>

>

ContenuSgml

< /

NomBalise

>

Opérateurs utilisables dans un module au format Standard Generalized Markup Language

< <-- <![ > --> ]]> - % # , | ? + * ()

Mots-clés utilisables dans un module au format Standard Generalized Markup Language

ANY ATTLIST
CDATA CURRENT
DOCTYPE
EMPTY ELEMENT ENTITY ENTITIES
FIXED
ID IDREF IMPLIED INCLUDE IGNORE
NDATA NMTOKEN NMTOKENS NOTATION NUMBER
PCDATA PUBLIC
RCDATA REQUIRED
SYSTEM

Exemple d'un flux au format Sgml

Document Type Definition externe

Source du Document Type Definition

Le fichier est par exemple ${UPS_HOME}/upsedi/resources/${UPS_LANGUAGE}/employe-sgml.dtd.

<!ELEMENT ListeEmployes - - Employe*> <!ELEMENT Employe - - (Nom,Numero,Salaire,DateDEmbauche)> <!ATTLIST Employe Numero - - CDATA #REQUIRED> <!ELEMENT Nom - - #PCDATA> <!ELEMENT Salaire - - #PCDATA> <!ELEMENT DateDEmbauche - - #PCDATA>

Source du Standard Generalized Markup Language


<!DOCTYPE ListeEmployes SYSTEM "file://${UPS_HOME}/upsedi/resources/${UPS_LANGUAGE}/employe-sgml.dtd">

<ListeEmployes>

	<Employe Numero=7724>

	
		<Nom>Mister Scott</Nom>

		<Salaire>1000.0</Salaire>

		<DateDEmbauche>28-DEC-2005 10:50:00</DateDEmbauche>

	
	</Employe>

	<Employe Numero=7832>

	
		<Nom>Mister Allen</Nom>

		<Salaire>1200.0</Salaire>

		<DateDEmbauche>26-JAN-2002 11:09:10</DateDEmbauche>

	
	</Employe>

	<Employe Numero=7948>

	
		<Nom>Lady Smith</Nom>

		<Salaire>1400.0</Salaire>

		<DateDEmbauche>10-JAN-2004 15:22:20</DateDEmbauche>

	
	</Employe>

	<Employe Numero=7954>

	
		<Nom>Miss King</Nom>

		<Salaire>2000.0</Salaire>

		<DateDEmbauche>01-AVR-2003 08:12:20</DateDEmbauche>

	
	</Employe>


</ListeEmployes>

Document Type Definition inclus


<!DOCTYPE ListeEmployes


	[

	<!ELEMENT Employe - - (Nom,Numero,Salaire,DateDEmbauche)>

	<!ATTLIST Employe Numero CDATA #REQUIRED>

	<!ELEMENT Nom - - #PCDATA>

	<!ELEMENT Salaire - - #PCDATA>

	<!ELEMENT DateDEmbauche - - #PCDATA>

	]>

<ListeEmployes>

	<Employe Numero=7724>

	
		<Nom>Mister Scott</Nom>

		<Salaire>1000.0</Salaire>

		<DateDEmbauche>28-DEC-2005 10:50:00</DateDEmbauche>

	
	</Employe>

	<Employe Numero=7832>

	
		<Nom>Mister Allen</Nom>

		<Salaire>1200.0</Salaire>

		<DateDEmbauche>26-JAN-2002 11:09:10</DateDEmbauche>

	
	</Employe>

	<Employe Numero=7948>

	
		<Nom>Lady Smith</Nom>

		<Salaire>1400.0</Salaire>

		<DateDEmbauche>10-JAN-2004 15:22:20</DateDEmbauche>

	
	</Employe>

	<Employe Numero=7954>

	
		<Nom>Miss King</Nom>

		<Salaire>2000.0</Salaire>

		<DateDEmbauche>01-AVR-2003 08:12:20</DateDEmbauche>

	
	</Employe>


</ListeEmployes>

Exemple d'un flux au format Xml

Document Type Definition externe

Source du Document Type Definition

Le fichier est par exemple ${UPS_HOME}/upsedi/resources/${UPS_LANGUAGE}/employe-xml.dtd.

<?xml version="1.1" encoding="UTF-8" standalone="no" ?> <!ELEMENT ListeEmployes Employe*> <!ELEMENT Employe (Nom,Numero,Salaire,DateDEmbauche)> <!ATTLIST Employe Numero CDATA #REQUIRED> <!ELEMENT Nom #PCDATA> <!ELEMENT Salaire #PCDATA> <!ELEMENT DateDEmbauche #PCDATA>

Source du eXtended Markup Language


<?xml version="1.1" encoding="UTF-8" standalone="no" ?>

<!DOCTYPE ListeEmployes SYSTEM "file://${UPS_HOME}/upsedi/resources/${UPS_LANGUAGE}/employe-xml.dtd">

<ListeEmployes>

	<Employe Numero=7724>

	
		<Nom>Mister Scott</Nom>

		<Salaire>1000.0</Salaire>

		<DateDEmbauche>28-DEC-2005 10:50:00</DateDEmbauche>

	
	</Employe>

	<Employe Numero=7832>

	
		<Nom>Mister Allen</Nom>

		<Salaire>1200.0</Salaire>

		<DateDEmbauche>26-JAN-2002 11:09:10</DateDEmbauche>

	
	</Employe>

	<Employe Numero=7948>

	
		<Nom>Lady Smith</Nom>

		<Salaire>1400.0</Salaire>

		<DateDEmbauche>10-JAN-2004 15:22:20</DateDEmbauche>

	
	</Employe>

	<Employe Numero=7954>

	
		<Nom>Miss King</Nom>

		<Salaire>2000.0</Salaire>

		<DateDEmbauche>01-AVR-2003 08:12:20</DateDEmbauche>

	
	</Employe>


</ListeEmployes>

Document Type Definition inclus


<?xml version="1.1" encoding="UTF-8" standalone="no" ?>

<!DOCTYPE ListeEmployes


	[

	<!ELEMENT Employe (Nom,Numero,Salaire,DateDEmbauche)>

	<!ATTLIST Employe Numero CDATA #REQUIRED>

	<!ELEMENT Nom #PCDATA>

	<!ELEMENT Salaire #PCDATA>

	<!ELEMENT DateDEmbauche #PCDATA>

	]>

<ListeEmployes>

	<Employe Numero=7724>

	
		<Nom>Mister Scott</Nom>

		<Salaire>1000.0</Salaire>

		<DateDEmbauche>28-DEC-2005 10:50:00</DateDEmbauche>

	
	</Employe>

	<Employe Numero=7832>

	
		<Nom>Mister Allen</Nom>

		<Salaire>1200.0</Salaire>

		<DateDEmbauche>26-JAN-2002 11:09:10</DateDEmbauche>

	
	</Employe>

	<Employe Numero=7948>

	
		<Nom>Lady Smith</Nom>

		<Salaire>1400.0</Salaire>

		<DateDEmbauche>10-JAN-2004 15:22:20</DateDEmbauche>

	
	</Employe>

	<Employe Numero=7954>

	
		<Nom>Miss King</Nom>

		<Salaire>2000.0</Salaire>

		<DateDEmbauche>01-AVR-2003 08:12:20</DateDEmbauche>

	
	</Employe>


</ListeEmployes>