Go to:
Gentoo Home
Documentation
Forums
Lists
Bugs
Planet
Store
Wiki
Get Gentoo!
Gentoo's Bugzilla – Attachment 45895 Details for
Bug 73654
[fr] new translation for devrel HB
Home
|
New
–
[Ex]
|
Browse
|
Search
|
Privacy Policy
|
[?]
|
Reports
|
Requests
|
Help
|
New Account
|
Log In
[x]
|
Forgot Password
Login:
[x]
metadata.xml
devrel-metadata.xml (text/plain), 9.73 KB, created by
Clément VARALDI
on 2004-12-13 03:33:50 UTC
(
hide
)
Description:
metadata.xml
Filename:
MIME Type:
Creator:
Clément VARALDI
Created:
2004-12-13 03:33:50 UTC
Size:
9.73 KB
patch
obsolete
><?xml version='1.0' encoding='UTF-8'?> ><!DOCTYPE sections SYSTEM "/dtd/book.dtd"> > ><!-- Le contenu de ce document est sous licence CC-BY-SA --> ><!-- Voir http://creativecommons.org/licenses/by-sa/1.0 --> > ><!-- This document was last synched to: cvs://gentoo/gentoo/xml/htdocs/doc/en/metadata.xml :: R1.4. --> > ><sections> > > <section> > <title>Quelle est l'utilité des fichiers metadada.xml ?</title> > <subsection> > <body> > <p> > Le fichier <c>metadata.xml</c> a pour objectif de donner des > informations supplémentaires sur les ebuilds. Le fichier <c> > metadata.xml</c> devrait être présent dans tout répertoire de > paquet.. Un fichier <e>skel</e> peut être trouvé dans l'arbre de > Portage, <c>skel.metadata.xml</c>. > </p> > > <note> > Lancez <c>xmllint --valid metadata.xml</c> avant de soumettre un > fichier <c>metadata.xml</c>. Nous espérons intégrer rapidement dans > repoman le support des fichiers <c>metadata.xml</c>. > </note> > </body> > </subsection> > </section> > > > <section> > <title>La structure d'un metadata</title> > <subsection> > <body> > <p> > Un fichier <c>metadata.xml</c> peut contenir un certain nombre de > tags : > </p> > > <table> > <tr> > <th>tag</th> > <th>description</th> > </tr> > > <tr> > <ti><brite><pkgmetadata></brite></ti> > <ti> > C'est l'élément racine d'un fichier metadata.xml. Il n'a pas > d'attributs. Il doit avoir le sous-tag suivant : <brite> > <herd></brite>. Il peut également admettre les sous-tags > suivants : <brite><email></brite> pour une adresse > électronique de <e>herd</e> (groupe travaillant sur le projet), > <brite><maintainer></brite>, et <brite> > <longdescription></brite>. > </ti> > </tr> > > <tr> > <ti><brite><herd></brite></ti> > <ti> > Il doit y avoir au moins un sous-tag de type <e>herd</e>. Le > contenu de ce tag doit être le nom d'un groupe, comme 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>. Il ne doit apparaître qu'une et une seule fois. > </ti> > </tr> > > <tr> > <ti><brite><maintainer></brite></ti> > <ti> > Au delà du fait d'appartenir à un groupe, un paquet peut aussi > être maintenu de manière directe. Les mainteneurs du paquet > peuvent être indiqué à l'aide du taf <brite><maintainer> > </brite>. Ce tag a un sous-tag obligatoire :<brite> > <email></brite>. Il a deux sous-tags optionnels : > <brite><name></brite> et <brite><description></brite>. > </ti> > </tr> > > <tr> > <ti><brite><email></brite></ti> > <ti> > Celui-ci contient l'adresse électronique du mainteneur. Il est > obligatoire. > </ti> > </tr> > > <tr> > <ti><brite><name></brite></ti> > <ti> > Celui-ci contient un texte libre, avec le nom du mainteneur. Il > est optionnel. > </ti> > </tr> > > <tr> > <ti><brite><description></brite></ti> > <ti> > Le tag de description contient une description sur la maintenance, > ou par exemple une remarque indiquant aux personnes intéressées > qu'elle peuvent se charger de la maintenance. > Ce tag est optionnel. > </ti> > </tr> > > <tr> > <ti><brite><longdescription></brite></ti> > <ti> > Ce tag contient une description du paquet. Il a pour objectif > d'ajouter des informations au champ DESCRIPTION présent dans les > ebuilds. > </ti> > </tr> > </table> > > <p> > Il y a également quelques attributs qui peuvent être utilisés avec ces > tags. Ils sont tous optionnels : > </p> > > <table> > <tr> > <th>attribut</th> > <th>tags</th> > <th>description</th> > </tr> > > <tr> > <ti>lang</ti> > <ti> > <brite><description></brite>, <brite><longdescription> > </brite> > </ti> > <ti> > Dans tous les cas pour lesquels une description est nécessaire, il > doit y avoir <e>au moins</e> une description en anglais. Si une > description dans une autre langue est proposée, cet attribut est > utilisé pour spécifier la langue utilisée. Le format est le code > habituel pour les pays, en deux caractères. > </ti> > </tr> > > <tr> > <ti>restrict</ti> > <ti> > <brite><herd></brite>, <brite><maintainer></brite>, > <brite><longdescription></brite> > </ti> > <ti> > L'attribut <e>restrict</e> permet de restreindre l'application de > certains tag, à certaines versions d'un paquet. Quand cet attribut > est utilisé, un tag sans attribut doit également exister. Ce tag > dans l'attribut <e>restrict</e> servira de tag par défaut. Le > format de l'attribut <e>restrict</e> est celui utilisé dans les > paramètres DEPEND, à l'exception du fait que "<" et > ">" doivent être spécifiés avec des &lt; et > &gt;. > <br /> > <br /> > Par exemple pour le paquet db, un attribut > <c>restrict=">=sys-libs/db-3.2.9-r5"</c> dans le tag de > mainteneur indiquera que je suis actuellement mainteneur dans > toutes les versions supérieures à la 3.2.9-r5. > </ti> > </tr> > </table> > </body> > </subsection> > </section> > > > > <section> > <title>Exemples de metadata</title> > <subsection> > <title>Premier exemple</title> > <body> > <p> > Dans le premier exemple nous vous proposons un fichier <path> > metadata.xml</path> pour OpenOffice.org, dans lequel les ebuilds sont > complètement gérés par un groupe nommé <c>openoffice</c> : > </p> > > <pre caption="paquet géré par un groupe"> ><?xml version='1.0' encoding='UTF-8'?> ><!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd"> ><pkgmetadata> > <herd>openoffice</herd> > <longdescription> > 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. > </longdescription> ></pkgmetadata> > </pre> > > <p> > Le groupe <c>openoffice</c> est défini dans <path>herds.xml</path> par > le <uri link="/proj/en/metastructure">Projet de métastructures Gentoo > </uri> > </p> > > <note> > Cet exemple est probablement démodé à l'heure où vous lisez ces > lignes. Ce n'est qu'un exemple ! > </note> > > <pre caption="Exemple de groupe OpenOffice"> ><herd> > <name>openoffice</name> > <email>openoffice@gentoo.org</email> > <description>openoffice related packages</description> > <maintainer><email>pauldv@gentoo.org</email></maintainer> > <maintainer><email>brad@gentoo.org</email></maintainer> ></herd> > </pre> > > <p> > Si vous souhaitez vous ajouter (ou enlever) dans un groupe, éditez > <path>herds.xml</path>, qui est situé dans <path>[gentoo]/misc</path> > dans le dépôt CVS de Gentoo. Assurez-vous de connaître l'alias mail > caractérisant le groupe en question (par exemple le groupe "sound" a > pour alias <mail link="sound@gentoo.org">sound@gentoo.org</mail>) et > ajoutez-vous à l'alias en question (en éditant <path> > /var/mail/alias/misc/<nom de l'alias></path> sur > dev.gentoo.org). > </p> > </body> > </subsection> > > > <subsection> > <title>Second exemple</title> > <body> > <p> > Comme second exemple nous allons voir le <path>metadata.xml</path> de > <c>mirrorselect</c>. Cet ebuild est maintenu par le groupe <c> > tools-portage</c>, mais a un mainteneur à part. > </p> > > <pre caption="Paquet d'un groupe, avec un mainteneur individuel"> ><?xml version='1.0' encoding='UTF-8'?> ><!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd"> ><pkgmetadata> > <herd>tools-portage</herd> > <maintainer> > <email>johnm@gentoo.org</email> > <name>John Mylchreest</name> > </maintainer> > <longdescription> > 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. > </longdescription> ></pkgmetadata> > </pre> > </body> > </subsection> > </section> ></sections>
You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
View the attachment on a separate page
.
View Attachment As Raw
Actions:
View
Attachments on
bug 73654
:
45425
|
45432
|
45439
|
45441
|
45453
|
45595
|
45596
|
45893
|
45894
|
45895
|
45897
|
45961
|
47829
|
47830
|
47831
|
54040
|
54041
|
54042
|
54043
|
55255
|
55256
|
55257
|
55258
|
55259
|
55261
|
55487
|
55958
|
56147
|
56557