<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (C) 2000-2010  Ministere de la culture et de la communication (France), AJLSM
See LICENCE file
-->
<!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website V2.1b1//EN" "../../dtd/website.dtd" [
<!ENTITY test SYSTEM "test/test.xml" NDATA XML>
]>
<webpage id="documentation">
	<head>
		<title>Documentation</title>
		<titleabbrev>documentation</titleabbrev>
		<author>
			<firstname>Martin</firstname>
			<surname>Sévigny</surname>
			<affiliation>
				<orgname>AJLSM</orgname>
			</affiliation>
		</author>
		<author>
			<firstname>Frédéric</firstname>
			<surname> Glorieux</surname>
			<affiliation>
				<orgname>AJLSM</orgname>
			</affiliation>
		</author><revhistory>
			<revision>
				<revnumber>1.0</revnumber>
				<date>2002/09/25</date>
			</revision>
		</revhistory>
	</head>
	<para>La documentation de la plate-forme SDX-2 n'est pas encore complètement prête. En attendant, vous devrez lire les commentaires des différents fichiers source.</para>
	<section>
		<title>Quelques remarques concernant la documentation</title>
		<para>La documentation est écrite en XML, selon la DTD Website qui est une adaptation de Docbook pour créer des ensembles de pages. Dans ce contexte, mais aussi dans le contexte du système de build de SDX-2, il y a deux aspects particuliers&#xA0;: les images et les liens hypertextes. Le fichier <olink targetdocent="test">test</olink> donne des exemples de ces deux situations.</para>
		<section>
			<title>Les images</title>
			<para>Les images sont insérées à l'aide de l'élément <sgmltag>imageobject</sgmltag>. Pour cet élément, on doit utiliser l'attribut <sgmltag>fileref</sgmltag> pour indiquer l'URL relative de l'image par rapport au document source. Le système de build se chargera de faire suivre l'image.</para>
		</section>
		<section>
			<title>Les liens hypertextes</title>
			<para>Pour créer un lien hypertexte interne au système de documentation, on doit utiliser l'élément <sgmltag>olink</sgmltag>. Mais auparavent, il est nécessaire de déclarer une entité externe de notation (NDATA) XML, dont la cible est l'adresse URL du document vers lequel on fait un lien. Une fois cette entité déclarée, on l'utilise tout simplement dans l'attribut <sgmltag>targetdocument</sgmltag> de l'élément <sgmltag>olink</sgmltag>.</para>
		</section>
	</section>
</webpage>
