Attachment 26298 Details for Bug 42837 – Translated XML file (metadata.xml)

Translated XML file (metadata.xml)

metadata.xml (text/plain), 7.51 KB, created by Olivier Fisette (RETIRED) on 2004-02-24 21:48:59 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Olivier Fisette (RETIRED)

Created: 2004-02-24 21:48:59 UTC

Size: 7.51 KB

patch

obsolete

><?xml version='1.0' encoding="UTF-8"?>
><!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
><guide link="/doc/en/metadata.xml">
><title>MÃ©ta-donnÃ©es Gentoo</title>
>
><author title="Auteur">
>  <mail link="pauldv@gentoo.org">Paul De Vrieze</mail>
></author>
><author title="Correcteur">
>  <mail link="swift@gentoo.org">Sven Vermeulen</mail>
></author>
><author title="Traducteur">
>  <mail link="olivier.fisette@sympatico.ca">Olivier Fisette</mail>
></author>
>
><abstract>
>Information Ã  propos de metadata.xml.
></abstract>
>
><license/>
>
><version>0.1</version>
><date>10 fÃ©vrier 2004</date>
>
><chapter>
><title>Pourquoi metadata.xml&nbsp;?</title>
><section>
><body>
>
><p>
>Le but du fichier <c>metadata.xml</c> est de fournir de l'information 
>supplÃ©mentaire sur les Â«&nbsp;ebuilds&nbsp;Â». Le fichier <c>metadata.xml</c> 
>devrait Ãªtre prÃ©sent dans le rÃ©pertoire de chaque paquet. Un gabarit (fichier 
>Â«&nbsp;skel&nbsp;Â») est prÃ©sent dans l'arbre portage&nbsp;: 
><c>skel.metadata.xml</c>.
></p>
>
><note>
>Veuillez exÃ©cuter <c>xmllint --valid metadata.xml</c> avant d'envoyer un 
>fichier <c>metadata.xml</c>. Nous espÃ©rons ajouter bientÃ´t le support pour 
><c>metadata.xml</c> Ã  repoman.
></note>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Structure des mÃ©ta-donnÃ©es</title>
><section>
><body>
>
><p>
>Un fichier <c>metadata.xml</c> peut contenir ces balises&nbsp;:
></p>
>
><table>
><tr>
>  <th>Balise</th>
>  <th>Description</th>
></tr>
><tr>
>  <ti>
>    <brite>&lt;pkgmetadata&gt;</brite>
>  </ti>
>  <ti>
>    Il s'agit de l'Ã©lÃ©ment racine du fichier metadata.xml. Il n'a aucun attribut.
>		Sa sous-balise obligatoire est&nbsp;: <brite>&lt;herd&gt;</brite>. En plus, 
>		les sous-balises suivantes sont permises&nbsp;: <brite>&lt;email&gt;</brite> 
>		(pour l'adresse de courrier Ã©lectronique gÃ©nÃ©rale du Â«&nbsp;herd&nbsp;Â»), 
>		<brite>&lt;maintainer&gt;</brite> et <brite>&lt;longdescription&gt;</brite>.
>  </ti>
></tr>
><tr>
>  <ti>
>    <brite>&lt;herd&gt;</brite>
>  </ti>
>  <ti>
>    Il doit y avoir au moins une sous-balise &lt;herd&gt;. Le contenu de cette 
>		balise devrait Ãªtre le nom d'un Â«&nbsp;herd&nbsp;Â» tel que spÃ©cifiÃ© dans le 
>		fichier <uri 
>    link="http://www.gentoo.org/cgi-bin/viewcvs.cgi/misc/herds.xml?rev=HEAD;cvsroot=gentoo;content-type=text/plain">
>		herds.xml</uri>. 
>  </ti>
></tr>
><tr>
>  <ti>
>    <brite>&lt;maintainer&gt;</brite>
>  </ti>
>  <ti>
>    En plus de faire partie d'un Â«&nbsp;herd&nbsp;Â», un paquet peut Ãªtre 
>		maintenu directement. Les dÃ©veloppeurs assignÃ©s Ã  la maintenance d'un paquet 
>		peuvent Ãªtre mentionnÃ©s avec la balise <brite>&lt;maintainer&gt;</brite>.
>		Cette balise a une sous-balise obligatoire&nbsp;: 
>		<brite>&lt;email&gt;</brite>. Elle a deux sous-balises optionnelles&nbsp;: 
>		<brite>&lt;name&gt;</brite>, et <brite>&lt;description&gt;</brite>.
>  </ti>
></tr>
><tr>
>  <ti><brite>&lt;email&gt;</brite></ti>
>  <ti>
>    Contient l'adresse de courrier Ã©lectronique du mainteneur. C'est requis.
>  </ti>
></tr>
><tr>
>  <ti><brite>&lt;name&gt;</brite></ti>
>  <ti>
>    Contient un texte sous forme libre donnant le nom du mainteneur. C'est 
>		optionnel.
>  </ti>
></tr>
><tr>
>  <ti><brite>&lt;description&gt;</brite></ti>
>  <ti>
>    Cette balise contient une description de la maintenance ou une remarque, 
>		par exemple une offre pour que quelqu'un prenne en charge la maintenance 
>		du paquet. C'est optionnel.
>  </ti>
></tr>
><tr>
>  <ti><brite>&lt;longdescription&gt;</brite></ti>
>  <ti>
>    Cette balise contient une description du paquet. Cela s'ajoute au champ
>		DESCRIPTION qui se trouve dans les ebuilds eux-mÃªmes.
>  </ti>
></tr>
></table>
>
><p>
>Il y a aussi divers attributs qui peuvent Ãªtre utilisÃ©s avec ces balises. Ils 
>sont tous optionnels&nbsp;:
></p>
>
><table>
><tr>
>  <th>Attribut</th>
>  <th>Balise</th>
>  <th>Description</th>
></tr>
><tr>
>  <ti>lang</ti>
>  <ti>
>    <brite>&lt;description&gt;</brite>, <brite>&lt;longdescription&gt;</brite>
>  </ti>
>  <ti>
>    Dans tous les cas oÃ¹ une description est requise, il doit y avoir <e>au 
>		moins</e> une description en anglais. Si une description supplÃ©mentaire dans
>		une autre langue est donnÃ©e, cet attribut sert Ã  spÃ©cifier la langue 
>		utilisÃ©e. Le format est un code de pays Ã  deux lettres.
>  </ti>
></tr>
><tr>
>  <ti>restrict</ti>
>  <ti>
>    <brite>&lt;herd&gt;</brite>, <brite>&lt;maintainer&gt;</brite>, 
>    <brite>&lt;longdescription&gt;</brite>
>  </ti>
>  <ti>
>    L'attribut restrict permet de restreindre l'application de certaines balises 
>		Ã  certaines versions du paquet. Lorsque cet attribut est utilisÃ©, une balise 
>		sans cet attribut doit Ã©galement exister. Cette balise sans l'attribut 
>		restrict servira de valeur par dÃ©faut. Le format de l'attribut restrict est 
>		celui des options de DEPEND, mais Â«&nbsp;&lt;&nbsp;Â» et Â«&nbsp;&gt;&nbsp;Â» 
>		doivent Ãªtre spÃ©cifiÃ©s en utilisant &amp;lt; and &amp;gt;.<br />
>		<br />
>    Par exemple, dans le paquet db
>		<c>restrict="&gt;=sys-libs/db-3.2.9-r5"</c> 
>		dans la balise maintainer indique que je suis le responsable pour la 
>		version 3.2.9-r5 et les suivantes.
>  </ti>
></tr>
></table>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Exemples de mÃ©ta-donnÃ©es</title>
><section>
><title>Premier exemple</title>
><body>
>
><p>
>Dans ce premier exemple, nous vous montrons le <path>metadata.xml</path> pour
>OpenOffice, dont les Â«&nbsp;ebuilds&nbsp;Â» sont entiÃ¨rement gÃ©rÃ©s par le 
>Â«&nbsp;herd&nbsp;Â» nommÃ© <c>openoffice</c>:
></p>
>
><pre caption="Paquet gÃ©rÃ© par un Â«&nbsp;herd&nbsp;Â»">
>&lt;?xml version='1.0' encoding='UTF-8'?&gt;
>&lt;!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd"&gt;
>&lt;pkgmetadata&gt;
>  &lt;herd&gt;openoffice&lt;/herd&gt;
>  &lt;longdescription&gt;
>    OpenOffice is the  opensource version of staroffice.
>    This ebuild allows you to compile it yourself. Unfortunately this
>    compilation can take up to a day depending on the speed of your
>    computer. It will however make a snappier openoffice than the binary
>    version.
>  &lt;/longdescription&gt;
>&lt;/pkgmetadata&gt;
></pre>
>
><p>
>Le Â«&nbsp;herd&nbsp;Â» <c>openoffice</c> est dÃ©fini dans <path>herds.xml</path>
>par le <uri link="/proj/en/metastructure">Gentoo Metastructure Project</uri>
>&nbsp;:
></p>
>
><note>
>Cet exemple sera peut-Ãªtre surannÃ© lorsque vous le lirez. Ce n'est qu'un 
>exemple&nbsp;!
></note>
>
><pre caption="Exemple du Â«&nbsp;herd&nbsp;Â» de OpenOffice">
>&lt;herd&gt;
>  &lt;name&gt;openoffice&lt;/name&gt;
>  &lt;email&gt;openoffice@gentoo.org&lt;/email&gt;
>  &lt;description&gt;openoffice related packages&lt;/description&gt;
>  &lt;maintainer&gt;&lt;email&gt;pauldv@gentoo.org&lt;/email&gt;&lt;/maintainer&gt;
>  &lt;maintainer&gt;&lt;email&gt;brad@gentoo.org&lt;/email&gt;&lt;/maintainer&gt;
>&lt;/herd&gt;
></pre>
>
></body>
></section>
><section>
><title>DeuxiÃ¨me exemple</title>
><body>
>
><p>
>Comme second exemple, nous regarderons le <path>metadata.xml</path> de 
><c>mirrorselect</c>. Cet Â«&nbsp;ebuild&nbsp;Â» est maintenu par le 
>Â«&nbsp;herd&nbsp;Â» <c>tools-portage</c>, et aussi par un mainteneur sÃ©parÃ©. 
></p>
>
><pre caption="Paquet maintenu par un Â«&nbsp;herd&nbsp;Â» et une autre personne">
>&lt;?xml version='1.0' encoding='UTF-8'?&gt;
>&lt;!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd"&gt;
>&lt;pkgmetadata&gt;
>  &lt;herd&gt;tools-portage&lt;/herd&gt;
>  &lt;maintainer&gt;
>    &lt;email&gt;johnm@gentoo.org&lt;/email&gt;
>    &lt;name&gt;John Mylchreest&lt;/name&gt;
>  &lt;/maintainer&gt;
>  &lt;longdescription&gt;
>    This utility is used to select the fastest mirror (distfiles) and provide a
>    nicer front-end for mirror selection (both rsync + distfiles) to a user.
>  &lt;/longdescription&gt;
>&lt;/pkgmetadata&gt;
></pre>
>
></body>
></section>
></chapter>
></guide>

Actions: View

Attachments on bug 42837: 26298 | 26320