Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	.de Sh " Subsection [b][/b] .if t .Sp .ne 5 [b][/b]$1 .. .de Sp " Vertical space (when we can't use .PP) .if t .5v .if n .. .de Ip " List item [b][/b] .ie (.$>=3 .ne $3 .el .ne 3 [/col][/row][/table] [size=18] [b]Nom[/b] [/size] onsgmls - Un système SGML conforme à la norme internationale ISO 8879 -- Standard Generalized Markup Language (Langage normalisé de balisage généralisé). Un système SGML étendu (Extended Facilities) conforme à l'annexe A de la norme internationale ISO/IEC 10744 -- Hypermedia/Time-based Structuring Language (Langage de structuration hypermédia/événementiel) [size=18] [b]Résumé[/b] [/size] .nf [b]onsgmls[/b] [[b]-BCdeghlnpRrsuvx[/b]] [[b]-a[/b][i]type_lien[/i]] [[b]-A[/b][i]architecture[/i]] [[b]-b[/b][i]bctf[/i]] [[b]-c[/b][i]sysid[/i]...] [[b]-D[/b][i]répertoire[/i]] [[b]-E[/b][i]erreurs_max[/i]] [[b]-f[/b][i]fichier[/i]] [[b]-i[/b][i]nom[/i]] [[b]-o[/b][i]option_sortie[/i]...] [[b]-t[/b][i]fichier[/i]] [[b]-w[/b][i]type_avertissement[/i]...] [[b][/b][i]sysid[/i]...] .fi [size=18] [b]Description[/b] [/size] [b]onsgmls[/b] analyse et valide le document SGML dont l'entité document est spécifiée par les identificateurs système [[i]sysid[/i]...] et affiche sur la sortie standard une représentation texte simple de son jeu d'informations de structure des éléments (NdT : Element Structure Information Set). (Il s'agit de l'ensemble d'informations sur lequel une application structurée conforme à SGML devrait agir.) Lorsque plusieurs identificateurs système sont spécifiés, les entités correspondantes sont concaténées pour former l'entité document. Ainsi, l'entité document peut être répartie sur plusieurs fichiers ; par exemple, la déclaration SGML, le prologue et les instances du document peuvent chacun se trouver dans des fichiers séparés. Si aucun identificateur système n'est spécifié, alors onsgmls lira l'entité document depuis l'entrée standard. Un identificateur système, sur la ligne de commande, de valeur « - » peut être utilisé pour faire référence à l'entrée standard. (Normalement, dans un identificateur système, <OSFD>0 est utilisé pour se référer à l'entrée standard.) Les options suivantes sont disponibles : [table][row][col]    [/col][col][b]-a[/b][i]type_lien[/i], [b]--activate=[/b][i]type_lien[/i] Rend le type de lien [i]type_lien[/i] actif. Dans ce cas, toutes les informations ESIS (NdT : [b]E[/b]lement [b]S[/b]tructure [b]I[/b]nformation [b]S[/b]et) ne sont pas produites en sortie : les LPDs (NdT : [b]L[/b]ink [b]P[/b]rocess [b]D[/b]efinition) actives ne sont pas explicitement rapportées, bien que chaque attribut de lien soit qualifié avec son nom de type de lien ; il n'y a aucune information sur les élements résultants ; quand plusieurs règles de lien sont applicables à l'élément courant, onsgmls choisit toujours la première. [/col][/row][/table] [table][row][col]    [/col][col][b]-A[/b][i]architecture[/i], [b]--architecture=[/b][i]architecture[/i] Analyse par rapport à l'architecture [i]architecture[/i]. [/col][/row][/table] [table][row][col]    [/col][col][b]-b[/b][i]bctf[/i], [b]--bctf=[/b][i]bctf[/i], [b]-b[/b][i]encodage[/i], [b]--encoding=[/b][i]encodage[/i] Cette option détermine l'encodage utilisé pour la sortie. Si c'est en mode de jeu de caractères fixé, elle spécifie le nom d'un encodage ; sinon, elle spécifie le nom d'une BCTF. [/col][/row][/table] [table][row][col]    [/col][col][b]-B[/b], [b]--batch_mode[/b] Mode par lots. Analyse séparément chaque [[b][/b][i]sysid[/i]...] spécifié sur la ligne de commande, plutôt que de les concaténer. C'est pratique surtout avec [b]-s[/b]. Si l'option [b]-t[/b][i]nom_de_fichier[/i] est également spécifiée, alors le nom de fichier indiqué servira de préfixe aux [i]sysid[/i] pour composer les noms de fichiers du résultat RAST (NdT : [b]R[/b]eference [b]A[/b]pplication for [b]S[/b]GML [b]T[/b]esting) pour chaque [i]sysid[/i]. [/col][/row][/table] [table][row][col]    [/col][col][b]-c[/b][i]sysid[/i], [b]--catalog=[/b][i]sysid[/i] Met en correspondance les identificateurs publics et les noms d'entités avec les identificateurs système en utilisant le fichier d'entrées de catalogue dont l'identificateur système est [i]sysid[/i]. Plusieurs options [b]-c[/b] sont permises. S'il y a un fichier d'entrées de catalogue nommé « catalog » au même endroit que l'entité document, il sera scruté immédiatement après ceux spécifiés par [b]-c[/b]. [/col][/row][/table] [table][row][col]    [/col][col][b]-C[/b], [b]--catalogs[/b] Les arguments [[b][/b][i]nom_de_fichier[/i]...] spécifient les fichiers catalogues plutôt que l'entité document. L'entité document est spécifiée par la première entrée DOCUMENT dans les fichiers catalogues. [/col][/row][/table] [table][row][col]    [/col][col][b]-D[/b][i]répertoire[/i], [b]--directory=[/b][i]répertoire[/i] Recherche dans [i]répertoire[/i] les fichiers spécifiés dans les identificateurs système. Plusieurs options [b]-D[/b] sont permises. Voir la description du gestionnaire de stockage « osfile » pour plus d'informations à propos de la recherche de fichier. [/col][/row][/table] [table][row][col]    [/col][col][b]-e[/b], [b]--open-entities[/b] Décrit les entités ouvertes dans les messages d'erreur. Les messages d'erreur comportent toujours la position de l'entité externe la plus récemment ouverte. [/col][/row][/table] [table][row][col]    [/col][col][b]-E[/b][i]max_erreurs[/i], [b]--max-errors=[/b][i]max_erreurs[/i] onsgmls s'arrêtera après [i]max_erreurs[/i] erreurs. Si [i]max_erreurs[/i] vaut 0, il n'y a pas de limite au nombre d'erreurs. La valeur par défaut est 200. [/col][/row][/table] [table][row][col]    [/col][col][b]-f[/b][i]fichier[/i], [b]--error-file=[/b][i]fichier[/i] Redirige les erreurs vers [i]fichier[/i]. C'est pratique surtout avec les shells qui ne gèrent pas la redirection de la sortie d'erreur standard « stderr ». [/col][/row][/table] [table][row][col]    [/col][col][b]-g[/b], [b]--open-elements[/b] Montre les identificateurs génériques des éléments ouverts dans les messages d'erreur. [/col][/row][/table] [table][row][col]    [/col][col][b]-h[/b], [b]--help[/b] Affiche un texte d'aide et quitte. [/col][/row][/table] [table][row][col]    [/col][col][b]-i[/b][i]nom[/i], [b]--include=[/b][i]nom[/i] Simule la présence de <!ENTITY % [i]nom[/i] "INCLUDE"> au début du sous-ensemble de déclaration de type de document dans l'entité document SGML. Puisque que des définitions répétées d'une entité sont ignorées, cette définition aura la préséance sur toutes autres définitions de cette entité dans la déclaration de type de document. Plusieurs options [b]-i[/b] sont permises. Si la déclaration SGML remplace le nom réservé INCLUDE, alors le nouveau nom réservé sera le texte de remplacement de l'entité. Typiquement, la déclaration de type de document contiendra <!ENTITY % [i]nom[/i] "IGNORE"> et utilisera %[i]nom[/i]; dans la spécification du mot clé de statut d'une déclaration de section marquée. Dans ce cas, l'effet de l'option sera que la section marquée ne sera pas ignorée. [/col][/row][/table] [table][row][col]    [/col][col][b]-n[/b], [b]--error-numbers[/b] Affiche les numéros d'erreur dans les messages d'erreur. [/col][/row][/table] [table][row][col]    [/col][col][b]-o[/b][i]option_sortie[/i], [b]--option=[/b][i]option_sortie[/i] Produit en sortie des informations supplémentaires selon [i]option_sortie[/i] : [b]entity[/b] Produit les définitions de toutes les entités générales, pas seulement pour les entités de données ou « subdoc » qui sont référencées ou nommées dans un attribut ENTITY ou ENTITIES. [b]id[/b] Distingue les attributs dont la valeur déclarée est ID. [b]line[/b] Produit des commandes « L » donnant le numéro de ligne et le nom de fichier courants. [b]included[/b] Produit une commande « i » pour les sous-éléments inclus. [b]empty[/b] Produit une commande « e » pour des éléments qui ne sont pas autorisés à avoir une balise fermante, c'est ainsi avec un contenu déclaré « empty » ou avec un attribut de référence de contenu. [b]notation-sysid[/b] Produit une commande « f » avant une commande « N », si un identificateur système peut être généré pour cette notation. [b]nonsgml[/b] Dans le mode de jeu de caractères fixé, produit des séquences d'échappement % pour les caractères de données non SGML. Les caractères de données non SGML peuvent être le résultat d'appels de caractères numériques. [b]data-attribute[/b] Produit en sortie le nom et les attributs de notation pour les attributs DATA. Autrement, les attributs DATA sont traités comme des attributs CDATA. Pour plus de détails, voir la clause 4.4.3 de l'annexe K de la norme ISO 8879. [b]comment[/b] Produit en sortie une commande « _ » avec les contenus d'un commentaire. Plusieurs commentaires dans une seule déclaration de commentaire produiront plusieurs commandes « _ » distinctes, comme si les commentaires étaient chacun dans une déclaration de commentaire séparée. [b]omitted[/b] Produit en sortie une commande « o » avant une commande qui était impliquée par le document d'entrée mais omise du balisage réel. Cela affecte actuellement les commandes « ( », « ) » et « A ». [b]tagomit[/b] Comme [b]omitted[/b], mais seulement pour les commandes « ( » et « ) » [b]attromit[/b] Comme [b]omitted[/b], mais seulement pour les commandes « A » Plusieurs options [b]-o[/b] sont permises. [/col][/row][/table] [table][row][col]    [/col][col][b]-p[/b], [b]--only-prolog[/b] Analyse seulement le prologue. [b]onsgmls[/b] quittera après avoir analysé la déclaration de type de document. Implique [b]-s[/b]. [/col][/row][/table] [table][row][col]    [/col][col][b]-R[/b], [b]--restricted[/b] Restreint la lecture de fichiers. Cette option s'adresse à l'utilisation d'outils Web basés sur onsgmls (par exemple les scripts CGI) pour prévenir la lecture de fichiers arbitraires sur un serveur Web. Lorsque cette option est activée, onsgmls ne lira aucun fichier local à part ceux situés dans le répertoire (ou sous-répertoire) spécifié par l'option [b]-D[/b] ou inclus dans la variable d'environnement SGML_SEARCH_PATH. Pour plus de sécurité, cette option limite les noms de fichiers aux caractères A-Z, a-z, 0-9, « ? », « . », « _ », « - » et ne permet pas les noms de fichiers contenant « .. ». [/col][/row][/table] [table][row][col]    [/col][col][b]-s[/b], [b]--no-output[/b] Supprime la sortie. Les messages d'erreur seront tout de même affichés. [/col][/row][/table] [table][row][col]    [/col][col][b]-t[/b][i]nom_de_fichier[/i], [b]--rast-file=[/b][i]nom_de_fichier[/i] Produit dans [i]nom_de_fichier[/i] le résultat RAST ainsi qu'il est défini dans l'« ISO/IEC 13673:1995 » (en fait, ce n'est pas encore complètement une norme internationale ; cela implémente l'« Intermediate Editor's Draft » du 29 août 1994, avec des modifications pour implémenter « ISO/IEC JTC1/SC18/WG8 N1777 »). La sortie normale n'est pas produite. [/col][/row][/table] [table][row][col]    [/col][col][b]-v[/b], [b]--version[/b] Affiche le numéro de version. [/col][/row][/table] [table][row][col]    [/col][col][b]-w[/b][i]type[/i], [b]--warning=[/b][i]type[/i] Contrôle les avertissements et les erreurs. Plusieurs options [b]-w[/b] sont permises. Les valeurs suivantes de « type » activent les avertissements : [b]xml[/b] Avertit sur les constructions non permises par XML. [b]mixed[/b] Avertit sur les modèles de contenu mixte qui ne permettent nulle part « #PCDATA ». [b]sgmldecl[/b] Avertit sur différentes constructions douteuses dans la déclaration SGML. [b]should[/b] Avertit sur différentes recommandations faites dans l'ISO 8879 avec lesquelles le document n'est pas conforme. (Les recommandations sont exprimées avec « should », ce qui est distinct des exigences qui sont généralement exprimées avec « shall »). [b]default[/b] Avertit sur les références utilisant l'entité par défaut. [b]duplicate[/b] Avertit sur les déclarations d'entité dupliquées. [b]undefined[/b] Avertit sur les éléments non définis : éléments utilisés dans la DTD mais non définis. [b]unclosed[/b] Avertit sur les balises ouvrantes et fermantes non terminées. [b]empty[/b] Avertit sur les balises ouvrantes et fermantes vides. [b]net[/b] Avertit sur les balises ouvrantes autorisant les balises fermantes nulles, et sur les balises fermantes nulles (NdT : net=[b]n[/b]ull [b]e[/b]nd [b]t[/b]ag). [b]min-tag[/b] Avertit sur les balises ouvrantes et fermantes minimisées. Équivaut à une combinaison des avertissements « unclosed », « empty » et « net ». [b]unused-map[/b] Avertit sur les tables d'appels abrégés (NdT : short reference maps) inutilisées : tables déclarées dans une déclaration de table d'appels abrégés, mais jamais utilisées dans une déclaration d'utilisation d'appels abrégés dans la DTD. (NdT : pour plus d'informations sur les appels abrégés, vous pouvez consulter la page, en anglais, http://www.sgml.u-net.com/book/sgml-7.htm#SHORTREF) [b]unused-param[/b] Avertit sur les entités paramètres définies mais non utilisées dans une DTD. Les entités paramètres internes inutilisées dont le texte est INCLUDE ou IGNORE ne produisent pas d'avertissement. [b]notation-sysid[/b] Avertit sur les notations pour lesquelles aucun identificateur système n'a pu être généré. [b]all[/b] Avertit sur les conditions qui pourraient être évitées (de l'avis de l'auteur). Équivalent à : « mixed », « should », « default », « undefined », « sgmldecl », « unused-map », « unused-param », « empty » et « unclosed ». [b]immediate-recursion[/b] Avertit sur les éléments immédiatement récursifs. Pour plus de détails, voir la clause 2.2.5 de l'annexe K de la norme ISO 8879. [b]fully-declared[/b] Avertit si l'instance de document n'est pas pleinement déclarée. Cela a pour effet de modifier la déclaration SGML afin qu'elle spécifie IMPLYDEF ATTLIST NO ELEMENT NO ENTITY NO NOTATION NO. Pour plus de détails, voir la clause 2.2.1 de l'annexe K de la norme ISO 8879. [b]fully-tagged[/b] Avertit si l'instance de document n'est pas pleinement balisée. Cela a pour effet de modifier la déclaration SGML afin qu'elle spécifie DATATAG NO, RANK NO, OMITTAG NO, SHORTTAG STARTTAG EMPTY NO et SHORTTAG ATTRIB OMITNAME NO. Pour plus de détails, voir la clause 2.2.2 de l'annexe K de la norme ISO 8879. [b]amply-tagged,[/b] amply-tagged-recursive Avertit si l'instance de document n'est pas amplement balisée. Les éléments définis implicitement peuvent être immédiatement récursifs si [b]amply-tagged-recursive[/b] est spécifié. Cela a pour effet de modifier la déclaration SGML afin qu'elle spécifie DATATAG NO, RANK NO, OMITTAG NO, SHORTTAG ATTRIB OMITNAME NO et soit IMPLYDEF ELEMENT ANYOTHER ou IMPLYDEF ELEMENT YES. Pour plus de détails, voir la clause 2.2.4 de l'annexe K de la norme ISO 8879. [b]type-valid[/b] Avertit si l'instance de document n'est pas valide par le type. Cela a pour effet de modifier la déclaration SGML afin qu'elle spécifie VALIDITY YES. Pour plus de détails, voir la clause 2.2.3 de l'annexe K de la norme ISO 8879. [b]entity-ref[/b] Avertit sur les appels d'entités non prédéfinies. Cela a pour effet de modifier la déclaration SGML afin qu'elle spécifie ENTITIES REF NONE. Pour plus de détails, voir la clause 2.3.2 de l'annexe K de la norme ISO 8879. [b]external-entity-ref[/b] Avertit sur les appels d'entités externes. Cela inclut les références à un sous-ensemble de DTD externe. Cela a pour effet de modifier la déclaration SGML afin qu'elle spécifie ENTITIES REF INTERNAL. Pour plus de détails, voir la clause 2.3.3 de l'annexe K de la norme ISO 8879. [b]integral[/b] Avertit si l'instance de document n'est pas intégralement stockée. Cela a pour effet de modifier la déclaration SGML afin qu'elle spécifie ENTITIES INTEGRAL YES.Pour plus de détails, voir la clause 2.3.1 de l'annexe K de la norme ISO 8879. Un avertissement peut être désactivé en utilisant son nom préfixé par « no- ». Ainsi [b]-wall[/b] [b]-wno-duplicate[/b] active tous les avertissements sauf ceux concernant les déclarations d'entités dupliquées. Les valeurs suivantes de [i]type_avertissement[/i] désactivent les erreurs : [b]no-idref[/b] Ne signale pas d'erreur pour une valeur de référence à un ID qui n'est présent dans aucun élément. Chaque attribut déclaré en tant que « idref » se comportera comme s'il avait été déclaré en tant que « name ». [b]no-significant[/b] Ne produit pas d'erreur lorsqu'un caractère qui n'est pas un caractère significatif dans la syntaxe concrète de référence apparaît dans une chaîne littérale de la déclaration SGML. Cela peut être utile avec certaines batteries de test boguées. [b]no-valid[/b] N'exige pas que le document soit valide par le type. Cela a pour effet de modifier la déclaration SGML pour qu'elle spécifie VALIDITY NOASSERT et IMPLYDEF ATTLIST YES ELEMENT YES. Une option [b]-wvalid[/b] a pour effet de modifier la déclaration SGML pour qu'elle spécifie VALIDITY TYPE et IMPLYDEF ATTLIST NO ELEMENT NO. Si ni [b]-wvalid[/b] ni [b]-wno-valid[/b] ne sont spécifiées, alors les VALIDITY et IMPLYDEF spécifiées dans la déclaration SGML seront utilisées. [b]no-afdr[/b] Ne produit pas d'erreur lorsque les fonctionnalités de notation AFDR des méta-DTDs sont utilisées. Les erreurs sont normalement produites lors de l'analyse des DTDs, mais supprimées lors de l'analyse des méta-DTDs. [/col][/row][/table] [table][row][col]    [/col][col][b]-x[/b], [b]--references[/b] Affiche l'information sur les clauses pertinentes (de la norme ISO 8879:1986) dans les messages d'erreur. [/col][/row][/table] Les options suivantes sont également acceptées afin d'assurer une compatibilité descendante avec sgmls : [table][row][col]    [/col][col][b]-d[/b] Identique à [b]-wduplicate[/b]. [/col][/row][/table] [table][row][col]    [/col][col][b]-l[/b] Identique à [b]-oline[/b]. [/col][/row][/table] [table][row][col]    [/col][col][b]-m[/b][i]sysid[/i] Identique à [b]-c[/b]. [/col][/row][/table] [table][row][col]    [/col][col][b]-r[/b] Identique à [b]-wdefault[/b]. [/col][/row][/table] [table][row][col]    [/col][col][b]-u[/b] Identique à [b]-wundef[/b]. [/col][/row][/table] [size=18] [b]Voir aussi[/b] [/size] [b]ospent(1)[/b], [b]ospam(1)[/b], [b]onsgmlnorm(1)[/b], [b]osx(1)[/b] [size=18] [b]Auteurs[/b] [/size] James Clark, Ian Castle <ian.castle@openjade.org>. [size=18] [b]Traduction[/b] [/size] Alain Portal <aportal AT univ-montp2 DOT fr>, 16 juin 2004 Je remercie infiniment Éric Bischoff sans lequel cette traduction aurait eu du mal à voir le jour. [size=18] [b]Relecture[/b] [/size] Jean-Marc Destabeaux <jmdestabeaux AT free DOT fr> [size=18] [b]Traduction[/b] [/size] Il est possible que cette traduction soit imparfaite ou périmée. En cas de doute, veuillez vous reporter au document original en langue anglaise fourni avec le programme.
Fichier