Protocole de rédaction

Checklist

Attention: une fois votre texte terminé, prenez le temps de réviser et de compléter les points suivants:

• orthographe, syntaxe et structure des phrases (ponctuation);
• Ne pas mettre d'hyperlien dans le titre
• les "ID";
• les entrées dans le glossaire;
• les entrées des références dans la bibliographie;
• les références et les liens;
• les espaces insécables (CTRL+espace);
• les tableaux à identifier

Structure des dossiers de l'espace de rédaction de l'hyperdocument

L'espace de rédaction est situé sous: {CRGGID}/redaction-CRGGID/

Voici une brève description des dossiers présents dans l'espace de rédaction:

Emplacement des fichiers XML de développement de l'hyperdocument

Les fichiers XML qui constituent l'hyperdocument sont déposés dans le dossier {CRGGID}/redaction-CRGGID/sources/. Voici une liste des fichiers qui se retrouvent probablement à cet endroit avec une brève description:

L'emplacement des fichiers XML de développement de l'hyperdocument a été choisi pour les raisons suivantes:

• Les versions de publication permettent d'avoir une vue d'ensemble de l'état et du contenu du Guide à un moment X.
• Les formats de publication, html ou pdf, sont familliés pour les utilisateurs.
• La génération du fichier de publication est une étape simple pouvant être exécutée automatiquement.
• La rédaction est effectuée par le GRDS, les besoins des membres de l'espace collaboratif sont exclusivement de type consultatif.
• L'emplacement des dossiers sur le serveur du GRDS permet l'autonomie de la prise de backup et de l'accès au réseau Internet.

Étapes de création d'un nouveau fichier XML du Guide

L'ajout d'un chapitre ou d'une annexe au cadre de référence implique la création d'un nouveau fichier. Les fichiers XML seront créé à l'aide d'un gabarit dans XMetal.

1. L'ajout d'un fichier au guide peut s'accompagner d'un changement important de structure du guide. Au besoin, créer une nouvelle version du guide.
2. Créer un nouveau fichier XML à partir des gabarits sous: "File > New " de XMetal et choisir sous l'onglet "CRGGID" le document désiré.
3. Sauvegarder le document à l'endroit approprié sous le format ID_V.xml" ou l'ID est l'identificateur unique de l'élément racine du fichier.
4. Mettre à jour la version en cours du fichier driver {CRGGID}/redaction-CRGGID/entites/contenu.ent: créer une nouvelle entité générale externe et lui donner le chemin système du nouveau fichier. Prenez note que le nom de l'entité ne comporte pas de mention de version. Le chemin système doit obligatoirement suivre la convention utilisée par les autres entités du fichier.
5. Insérer le nouveau chapitre ou l'annexe dans le guide: faire l'appel de l'entité dans le fichier {CRGGID}/redaction-CRGGID/sources/cadre-reference-corps.xml Inscrire l'appel de l'entité dans le document XML parent approprié.

Prenez note que l'ajout, la modification, le retrait ou le déplacement d'une section à un chapitre existant n'affecte en rien la structure de fichiers ni la stratégie d'entités générales du fichier driver.

Modification d'un fragment du guide

Simplement ouvrir le fichier devant être modifié dans l'éditeur XMetal. Celui-ci devrait alors être reconnu par les macros prennant en charge les fragments du guide et le message « Fragment CRGGID activé » s'affichera dans la barre de statut de l'application.

Pour être reconnu en tant que fragment CRGGID, un fichier doit comporter les deux items suivants:

1. L'instruction de traitement xm-well_formed de XMetal qui indique à l'application que le document doit être édité en mode well-formed. Ce mode d'édition lie l'instance XML à la DTD sans toutefois valider.

   <?xm-well_formed path="S:\redaction-CRGGID\DTD\crggid.dtd"?>

   Cette instruction de traitement permet d'associer l'instance XML à la DTD sans utiliser la déclaration du type de document DOCTYPE. Elle doit apparaître dans le prologue du document XML.

2. L'instruction de traitement crggid qui identifie l'instance XML comme étant un fragment du guide et active les macros.

   <?crggid fragment="section"?>

   Le pseudo-attribut fragment n'est pas utilisé par les macros et est réservé pour un développement ultérieure. Il sert à identifier le nom de l'élément qui chapeaute le fragment (l'élément racine du fragment). Cette instruction de traitement doit obligatoirement être située après l'élément racine du fragment (à la fin du document).

Note: On a parfois observé un bogue lié au fait qu'un fichier constituant un fragment du guide était ouvert en même temps que l'application XMetal, c'est-à-dire lorsqu'on sélectionne à partir de l'explorateur Windows l'item Edit in XMetal du menu contextuel du fichier XML. Dans ce cas, il se peut que le fragment du guide ne soit pas reconnu par les macros. La solution consiste alors à fermer XMetal et à procéder en deux étapes, soit en premier lieu ouvrir l'application XMetal et ensuite ouvrir le fichier XML.

Étapes de création d'une section flottante

On peut rédiger une section du guide à l'extérieur du guide. Il s'agit alors d'une section flottante. De telles sections sont crées à l'aide du gabarit Section de XMetal, sous l'onglet CRGGID. Les sections flottantes sont placées dans le dossier {CRGGID}/redaction-CRGGID/sections-flottantes/. Lorsqu'une section flottante est jugée prète à être intégrée dans le guide, on procède par copier-coller du code source vers le chapitre approprié du guide. Le fichier de la section flottante est ensuite transféré dans le dossier {CRGGID}/redaction-CRGGID/sections-flottantes/sections-integrees/ pour éviter de mélanger des sections en élaboration de celles déjà intégrées au guide.

Versionnage des fichiers

Tous les fichiers du Guide suivent les conventions de versionnage utilisée au GRDS, à l'exception des fichiers du dossier {CRGGID}/redaction-CRGGID/DTD/. Le versionnage se fait a priori, c'est-à-dire que l'on crée d'abord une nouvelle version du fichier et on travaille sur celle-ci plutôt que sur l'ancienne.

Notez qu'il n'est pas prévu de versionnage pour les artefacts tels les images et autres objets que l'on veut intégrer au Guide.

Version des fichiers entités en cours de rédaction: Le fichier contenu.ent doit être versionné à chaque nouvelle publication de l'ébauche de l'hyperdocument.

Versions publiées: Les « versions publiées » de l'hyperdocument sont versionnées. Le schème servant à identifier chaque parution n'est pas la date courante, mais plutôt un numéro décimal séquentiel (0.1, 0.2, 0.3, etc.), l'objectif étant que la version finale de l'hyperdocument porte le numéro 1.0.

L'identifiant id

Libellé

L'attribut xreflabel est utilisé par l'ensemble des éléments (portions de texte) qui pourront être lié à l'aide de liens hypertextes internes et qui devront avoir un libellé constant. La chaîne de caractères contenue dans cet attribut sera alors inscrite comme texte de l'hyperlien quand il s'agit d'un lien xref.

Cette façon de procéder réduit le temps de rédaction et assure l'uniformité des appels pour une même référence en plus de conserver en un endroit unique la chaîne de caractères facilitant ainsi sa modification.

Langue

La valeur inscrite dans l'attribut lang doit être un code alpha-2 de la norme des codes de langue ISO 639-1. Cet attribut de base sera modifié seulement pour les éléments de l'hyperdocument qui seront rédigées en une autre langue que le français. La langue par défaut est le français.

La personnalisation des liens <xref>

Donner des exemples simples de la personnalisation via l'attribut xrefstyle

<para>... consultez le 
   <xref xrefstyle="template:chapitre %n - %t" linkend="chap_amorce"/>.</para>

résultat HTML:

<p>Pour plus d'information, consultez le 
   <a title="Chapitre 5. Pourquoi une méthodologie ?"  
      href="#chap_amorce-sommaire">chapitre 5 - <i>Pourquoi une méthodologie ?</i>
   </a>.</p>

Résultat visible à l'impression:

Pour plus d'information, consultez le chapitre 5 - Pourquoi une méthodologie ? [37].

Longs URI/URL/URNs

Les URIs insérés dans le corps de texte causent souvent des problèmes d'affichage en raison de leur longueur excessive, en particulier lorsque le texte est justifié. La solution traditionnelle consiste à insérer des caractères blancs invisibles qui serviront de points de cassure pour le changement de ligne. Deux solutions sont possibles avec l'application XSLT développée pour le CRGGID:

1. Attribut role

   Insérer l'URI dans l'élément phrase et inscrire dans son attribut role la valeur « uri » (en minuscule). L'application XSL se chargera d'insérer un caractère blanc invisible après chaque caractère « / » ou « : » contenu dans l'URI.

   Par exemple:

   <para>Bla bla bla 
      &lt;<phrase role="uri">http://www.exemple.com/foo/bar/toc/zouf/vlan</phrase>
        &gt; et on continue par là …
   </para>

   Donne au rendu PDF:

   Bla bla bla <http://www.exemple.com/foo/toc/
   zouf/vlanbar> et on continue par là …

   Cette solution ne fonctionne qu'avec le format de sortie PDF.

2. Instruction de traitement sbr (soft break)

   Insérer l'instruction de traitement sbr dans une chaîne de caractère pour indiquer un endroit de cassure potentiel.

   Par exemple:

   <para>Bla bla bla http://www.exemple.com/foo/bar/toc/<?sbr?>zouf/vlan et on continue par là … </para>

   Donne au rendu PDF:

   Bla bla bla <http://www.exemple.com/foo/toc/
   zouf/vlanbar> et on continue par là …

Le double arobas @@

Afin de faciliter la redaction, nous suggérons d’utiliser la double arobas @@ en cours de texte lorsqu’il s’agit d’intégrer une référence. L’arobas sera accompagnée d’une annotation comme aide mémoire pour préciser la nature de la référence. Après la rédaction du texte, il sera plus facile ainsi de compléter en ajoutant des liens aux endroits marqués. Ce truc pourra aussi être utilisé pour les notes en bas de page.

Par exemple:

<para>
   … il est possible d'appliquer le premier degré du
   <annotation
     username="hameljf" 
     initials="JFH"
     time="17 octobre 2003 16:40:15"
     comment="Peut-être faire une entrée et un lien au glossaire">
      @@ref principe de respect des fonds</annotation> 
   puisqu'il permet d'identifier …
</para>

Sinon, lors de l'insertion d'un appel d'une nouvelle référence bibliographique, vous devez prendre le temps d'insérer à l'endroit approprié les éléments bibliographiques nécessaires pour la création de la bibliographie.

Cet élément doit toujours avoir un identificateur explicite incluant le préfixe approprié.

Contrairement à l'exemple inclu dans la documentation, la balise citetitle possédant l'attribut pubwork, attitré à la saisie du type du document, doit être utilisée pour saisir le titre de la référence bibliographique à la place de la balise title. Référence : http://lists.oasis-open.org/archives/docbook/200202/msg00157.html

Les citations de contenu:<quote> et <blockquote>

Autres éléments constituant des blocs dans le corps du texte

Glossaire

Le glossaire contiendra le vocabulaire défini et utilisé dans la méthodologie. Il sert à clarifier les termes et les concepts que nous retiendrons de sorte que le lecteur puisse y référer au besoin. Comme la bibliographie, il forme une partie autonome qui sera en annexe de notre travail.

L'élément <glossentry>doit toujours avoir un identificateur explicite incluant le préfixe approprié.

 Exemple : <glossentry id="gloss-document">

Le glossaire est divisé selon les lettres de l'alphabet à l'aide de l'élément glossdiv. Le tri se fait correctement par ordre alphabétique à l'intérieur des divisions.

Les éléments de la bibliographie ne sont présentement pas triés par la feuille de style de Norm Walsh.

Voici un exemple d'une entrée fictive dans le glossaire contenant deux définitions provenant de sources différentes, une remarque et un Voir aussi. Plusieurs autres éléments sont également disponibles pour ajouter d'autres informations selon nos besoins.

<glossentry id="gloss-extreme-markup-language">
<glossterm>eXtreme Markup Language</glossterm>
 <acronym>XML</acronym>
  <glossdef>
   <blockquote>
    <attribution>
     <citation><xref linkend="ref-XML"/></citation>
    </attribution>
    <para>Voici la transcription de la définition du terme 
          trouvé dans la source d'information mentionnée dans 
          l'appel à la référence bibliographique inscrite dans 
          la balise "citation".</para>
   </blockquote>
  </glossdef>
  <glossdef>
   <blockquote>
    <attribution>
     <citation><xref linkend="ref-autre-2001"/></citation>
    </attribution>
    <para>Voici la transcription de la définition du terme 
          trouvé dans la source d'information mentionnée dans 
          l'appel à la référence bibliographique inscrite dans 
          la balise "citation".</para>
   </blockquote>
   <remark>
     Voici une remarque intéressante sur cette définition.
   </remark>
   <glossseealso otherterm="gloss-SGML"/>
  </glossdef>
</glossentry>

N.B.: Pour plus d'exemples et pour voir les gabarits de saisie du 
glossaire, voir le glossaire actuel en code source et la partie 
explicative en début de document.

Les Voir et Voir aussi sont saisis à l'intérieur des balises <glosssee otherterm="id"/> et <glossseealso otherterm="id"/>. Les hyperliens incluant le texte seront ajoutés par la feuille de style appropriée. La langue d'inscription des renvois utilisés est celle de l'attribut langue de la balise de plus bas niveau si celle-ci n'est pas indiquée, la feuille de style remonte jusqu'à l'élément de plus haut niveaubook. L'attribut langue fait partie des attributs de bases. On peut donc modifier la langue au niveau de chaque élément contenu dans la DTD DocBook.

Afin d'avoir des appels de référence reliés aux références bibliographiques il s'agit d'utiliser la syntaxe suivante : <attribution><citation><xref linkend="ref-iso-15489-1-2001"/></citation></attribution>. L'intitulé de l'hyperlien sera celui de l'attribut xreflabel ou celui de la balise abbr de la référence bibliographique si celui n'est pas présent, par contre il y a alors deux paires de parenthèses.Vérifier si le format de l'appel de la référence est bien celui désiré.

Afin de faciliter la saisie des gabarits contenant les balises les plus souvent utilisées, vous pouvez vous référer au début du fichier "glossaire.xml" ou aux gabarits apparaissants ci dessous..

Gabarit glossaire

1) gabarit pour ajouter des division au glossaire


	<glossdiv>
		<title></title>	
	</glossdiv>
			
			
	NOTE: les entrées du glossaire vont être insérées entre les balises 
</title> et </glossdiv>.


2)gabarit de saisie des termes du glossaire contenu dans une source 
d'information avec appel de référence

	<glossentry id="gloss-">
		<glossterm></glossterm>
		<acronym></acronym>
		<glossdef lang="">
			<blockquote>
				<attribution>
					<citation><xref linkend="ref-"/></citation>
				</attribution>
				<para></para>
			</blockquote>
			<remark></remark>
			<glossseealso otherterm="gloss-"></glossseealso>
		</glossdef>
	</glossentry>
					
3)Gabarit pour la saisie d'une définition du GRDS

	<glossentry id="gloss-">
		<glossterm></glossterm>
		<acronym></acronym>
		<glossdef>
			<para></para>
			<remark></remark>
			<glossseealso otherterm="gloss-"></glossseealso>
		</glossdef>
	</glossentry>

4) À la suite d'un couple de balises "paragraphe", ou à l'intérieur de 
celles-ci on peut ajouter les balises permettant de délimiter un exemple.

	<informalexample>
		<para></para>
	</informalexample>

5) Pour inscrire les termes anglais correspondant aux entrées du glossaire 
française, insérer à l'intérieur du couple de balises "glossterm", à la 
suite de la chaîne de caractères représentant le terme, les balises 
suivantes :

 <foreignphrase lang="en">
 </foreignphrase>
 
 Exemple: 

<glossterm>document numérique 
	<foreignphrase lang="en">electronic document</foreignphrase>
</glossterm>

NOTE: si dans le texte on parle de la terminologie anglaise celle-ci 
pourra également être insérée entre les balises "foreignphrase".


6) Des liens hypertextes peuvent être saisis à l'intérieure des balises 
<para></para><ulink url="http:\\www.google.com">Google</ulink> 

	<ulink url=""></ulink>

7) Gabarit pour les éléments du glossaire avec "voir" seulement

	<glossentry id="gloss-">
		<glossterm></glossterm>
		<glosssee otherterm="gloss-"></glosssee>
	</glossentry>

Étant donné que le développement du glossaire et de la bibliographie consiste principalement à l'ajout d'information, on ne devrait pas avoir besoin de versionnage.

Si plusieurs utilisateurs travaillent sur les mêmes fichiers, un dossier bidon avec le nom de la personne et la date du retrait pourrait être créé.

NOTE : L'identification des termes du glossaire qui seront utilisés dans le glossaire du projet PIAF se fera au niveau des élément "glossentry" avec l'attribut "role". La sémantique de la chaîne de caractères contenu dans cet attribut sera "identifiant du projet-section à laquelle la définition s'applique" exemple: role="PIAF-1".

L'index

indexterm ::=
(primary?,
 ((secondary,
   ((tertiary,
     (see|seealso+)?)|
    see|seealso+)?)|
  see|seealso+)?)

L’index sera créé à la toute fin. Les entrées d'index seront inscrite dans le corps du document, c'est-à-dire en contexte.

Décrire la façon dont les exemples seront inscrits dans le texte format ligne ou bloc.

Comment rédiger un texte technique

Le respect du français

Le CRGGID est un projet gouvernemental et à ce chapitre, nous devons nous conformer à la politique gouvernementale concernant l’utilisation du français dans l’administration publique.

En bref, voici quelqes lignes directrices:

• ne pas mélanger dans une même phrase anglais et français: ce qui peut donner lieu à des faux sens et à des contresens;
• éviter les termes franglais du genre: «Je fais mon footing jusqu'au parking chaque matin»;
• placer les expressions étrangères entre guillemets : « Voici mon " planing" de la journée »; il convient alors de créer une note de bas de page pour donner l’équivalent français ou de créer une entrée au glossaire pour préciser le terme par une définition.

Comme il y aura plusieurs termes anglais utilisés en informatique, nous metterons ces mots en italiques

Avant d'utiliser les mots étrangers, même entre guillement, il faut vérifier l'équivalent français (voir: OQLF) car il peut y avoir confusion.

Construction des phrases

Nous faisons ici un rappel sur la construction des phrases dans une rédaction technique. Une phrase dasn un style informatif est d'abord une phrase courte de moins de 35 mots et d'au plus trois propositions. Il ne doit pas y avoir surenchère d'épithètes et d'adverbes.

Les caractéristiques suivantes doivent se retrouver:

• une idée par phrase (très important)
• le sujet est facile à identifier et proche du verbe
• ne pas utiliser de pronom si le nom auquel il se rapporte n'est pas clairement identifiable
• les sigles, symboles et abréviations doivent être définis en début de texte
• ne pas faire d'énumération trop longue après un deux points
• ne pas introduire une énumération à l'intérieur d'une énumération
• éviter de commenter ou de décrire une figure qui ne se trouve pas dans la même page
• respecter les règles de ponctuation

Comment rédiger un texte précis

• Utiliser le terme exact, le mot juste.
• n'utiliser que les mots dont le sens est connu de tous, c'est-à-dire de notre lecteur
• Éviter les termes contenant trop de sens différents ou trop vagues
• Éviter également les expressions dont le sens est trop flou ou ambiguë;
  • «au niveau de...»
  • «sur le plan de...»
  • «au point de vu de...»
  • «nous avons balayé...»
  • «nous avons pris en compte...»
• Énumérer des termes de même nature
• Éviter les énumérations trop longues
• Mentionner les unités de mesure
• Tous les résultats, passages, illustrations tirés d'ailleurs doivent ètre accompagné d'uone référence ou d'un numéro de référence qui correspond à une liste bibliographique (dans ce cas-ci, un pointeur)
• Numéroter les équations, les graphiques et les figures
• Vérifier que toutes les références apparaissent bien

Améliorer la concision

• Développer une idée par phrase et ne pas redévelopper cette même idée une seconde fois
• Utiliser la forme directe plutôt qu'indirecte. Les verbes actifs et d'action sont plus vivants que les verbes à la forme passive
• Faire la chasse aux formules inutiles et aux périphrases alambiquées:
  • « Il convient de noter... » pour: « Notons que... »
  • « Il ne faut pas oublier que... » pour: « Rappelons que... »
  • « Il n'est pas déraisonnable de penser que... » pour: « Nous pensons que... »

• Faire la guerre aux pléonasmes:
  • « Une particularité propre... »

• Utiliser les sigles, les symboles et les abréviations préalablement définis sans en abuser
• Utiliser la numérotation des figures pour améliorer la concision du texte:
  • « Comme visible à la fig. 3.1,... »

Conventions d'écriture

Voici quelques conventions d’écriture que nous adopterons. Le tableau ci-dessous montre un rappel des conventions typographiques pour les textes français. Notons que les espaces insécables devront être signalées manuellement par le rédacteur à l’aide de l'entité &ampnbsp; introduite avant le Signe approprié.

* Le symbole % est traité en français comme une abréviation et donc suit les mêmes règles qu'un mot isolé.

** Cette convention, peut varier d'une éditeur à l'autre.

N.B.: Le point-virgule (;) sert à séparer des propositions indépendantes, qui, le plus souvent, ne possèdent pas de lien logique entre elles. Son utilisation est donc déconseillée dans des textes techniques (sauf pour les énumérations). Mieux vaut faire des phrases courtes.

Définitions

Bibliographie

Une bibliographie est une section d'un document contenant une liste de références biblipgraphiques.

Référence bibliographique

Une référence bibliographique est une notice identifiant un document donnant auteur, titre et source, c'est-à-dire toutes les précisions nécessaires pour se procurer le document. [GDT]

Appel de référence bibliographique

Pointeur situé dans le corps du texte lié à une référence bibliographique.

Sources consultées

DefGuide

Norman Walsh, Leonard Muellner. DocBook: The Definitive Guide (Page consultée le 24 octobre 2003). http://www.docbook.org/tdg/en/

Annexe

NOTE: Lorsque la ressource est disponible en format papier et imprimé 
inscrire la référence bibliographique pour le format papier et mettre un 
hyperlien sur le titre de la resource pour permettre l'accès au format 
électronique. Ceci assure l'accès à la ressource à long terme.

1) Gabarit pour l'ajout de division dans la bibliographie:

	<bibliodiv>
		<title></title>

	</bibliodiv>

2) Gabarit pour la saisie des entrées bibliographiques

Le format de saisie pour l'attribut  "xreflabel", qui servira d'appel 
bibliographique, est auteur-espace-date si deux documents d'un même 
auteur ont la même date faire suivre d'une lettre minuscule. 
	exemple: Girard 2002a et Girard 2002b  
	exemple de code:  
<biblioentry id="ref-iso-15489-1-2001" xreflabel="ISO 15489-1 2001">

	<biblioentry id="ref-" xreflabel="">
			<authorgroup>
				<author>
					<firstname></firstname>
					<surname></surname>
				</author>
				<author>
					<firstname></firstname>
					<surname></surname>
				</author>
				<collab>
					<collabname></collabname>
				</collab>
				<corpauthor></corpauthor>
				<othercredit>
					<firstname></firstname>
					<surname></surname>
					<contrib></contrib>
				</othercredit>
			</authorgroup>
			</authorgroup>
			<citetitle pubwork=""></citetitle>
			<copyright>
				<year></year>
				<holder></holder>
			</copyright>
			<edition></edition>
			<isbn></isbn>
			<publisher>
				<publishername></publishername>
				<address>
				<city></city>
				<state></state><country></country>
				</address>
			</publisher>
			<pubdate></pubdate>
			<subtitle></subtitle>
			<pagenums></pagenums>
	</biblioentry>
		
		NOTE : éliminer les balises non utilisées.
		
		Voici les balises pertinentes pour les articles, les insérer sous 
l'élément "biblioentry": 
		
		<volumenum></volumenum>
		<issuenum></issuenum>
		<issn></issn>

 3) Gabarit pour insérer des hyperliens dans les éléments de la 
référence bibliographique 
     gabarit : <ulink url=""></ulink> 
     exemple :
<citetitle><ulink url="http:\\www.google.com">Google</ulink>
</citetitle>
		
 4)gabarit pour saisir les ressources électroniques, cette partie 
est insérée sous l'élément "biblioentry"
   <bibliosource class="uri">
      <ulink url="">http://www.acme.com/exemple</ulink>
      <phrase>(Consulté le  2003)</phrase>
	</bibliosource>

exemple:
	<bibliosource class="uri">
		<ulink url="http://www.columbia.edu/cu/cup/cgos/idx_basic.html">
http://www.columbia.edu/cu/cup/cgos/idx_basic.html 
		<phrase>(Consulté le 11 janvier 2002)</phrase>
		<medialabel>[en ligne]</medialabel></ulink>
	</bibliosource>
    
    Exemple fictif, comportant plusieurs balises :
    <biblioentry id="ref-ISO-15489-2001" xreflabel="ISO 15489-1 2001">
			<authorgroup>
				<author>
					<firstname>Andrea</firstname>
					<surname>Bahadur</surname>
				</author>
				<author>
					<firstname>Mark</firstname>
					<surname>Shwarek</surname>
				</author>
				<collab>
					<collabname>Diane Girard</collabname>
				</collab>
				<corpauthor>Université de Montréal</corpauthor>
				<othercredit>
					<firstname>Mark</firstname>
					<surname>Shwarek</surname>
					<contrib>dessin</contrib>
				</othercredit>
			</authorgroup>
			<copyright>
				<year>1974</year>
				<year>1975</year>
				<holder>Product Development International Holding N. V.</holder>
			</copyright>
			<isbn>0-88459-021-6</isbn>
			<publisher>
				<publishername>Plenary Publications International,Inc.</publishername>
			</publisher>
			<pubdate>2001</pubdate>
			<citetitle pubwork="book">Kites</citetitle>
			<subtitle>Ancient Craft to Modern Sport</subtitle>
			<pagenums>988-999</pagenums>
			<bibliosource class="uri">
				<ulink url="http://www.columbia.edu/cu/cup/cgos/idx_basic.html">
       http://www.columbia.edu/cu/cup/cgos/idx_basic.html <phrase>
(Consulté le 11 janvier 2002)</phrase> <medialabel>[en ligne]
</medialabel>
					</ulink>
			</bibliosource>
		</biblioentry>

Addenda

Dans cette section du protocole de rédaction, chacun pourra ajouter des points nouveaux à inclure dans le protocole de rédaction.

Utilisation des caractères gras

Pour mettre en caractères gras du texte, il suffit d'utiliser l'élément <emphasis> et de lui ajouter la valeur bold dans l'attribut role: role= "bold". Par défaut, l'élément <emphasis> met le texte en italic. Il n'y a pas de "souligné", celui-ci étant réservé aux hyperliens.

Niveaux de lecture

Lors de la réunion du 22 janvier p.m., nous avons défini quatre niveaux de lecture pour quatre lecteurs types:

• Le gestionnaire de documents et l'usager responsable. [Par défaut, ce niveau de lecture se retrouve en tout temps dans le corps du texte.]
• L'administrateur (décideur). [Ce niveau de lecture sera rédigé sous forme de sommaire exécutif et placé dans l'élément <abstract>de la partie introductive d'une grande section de l'hyper document.]
• Le fonctionnaire du SCT [ Ce niveau de lecture constitue un développement théorique ou justificatif formant un tout indépendant dans le corps du texte. Ce bloque de texte devra être marqué à l'aide de l'attribut role = n-sct]
• L'informaticien [Ce niveau de lecture correspondant est un développement technique à l'intention de l'informaticien et sera marqué à l'aide de l'attribut role = n-inf]

• Les recommandations qui s'adressent au Gouvernementt du Québec et donc par automatiquement aux fonctionnaires du SCT et aux Administrateurs de haut niveau seront rédigé dans l'élément <blockquote> et marqué de l'attribut role = rec.