Description des fichiers XML de type MIME

Langue :

Les fichiers XML MIME fournissent toutes les informations concernant les types MIME qui sont installés dans la base de données MIME par l'application update-mime-database. Les fichiers XML MIME sont situés dans le répertoire <MIME>/packages. Quelques règles concernant les fichiers XML MIME :

Le fichier XML doit spécifier le namespace sous la forme http://www.freedesktop.org/standards/shared-mime-info.
L'élément root doit être mime-info .
Aucun, un ou plusieurs éléments mime-type peuvent être spécifiés comme enfants de l'élément mime-info. L'attribut type sert à spécifier le type MIME qui est défini.

Par défaut, le fichier freedesktop.org.xml est installé dans le répertoires de packages dans l'un des chemins <MIME> (généralement les packages /usr/share/mime/).

Le tableau suivant donne une brève description de chaque élément qui peut être enfant de l'élément mime-type.

Table 6-1 Eléments enfants de <mime-type>

Elément (et attributs)	Description
`<glob pattern="*.xyz">`	Cet élément spécifie un modèle global pour les noms de fichier. Si le nom de fichier correspond, le fichier est assigné au type MIME de l'élément `mime-type` parent. L'attribut `pattern` est obligatoire.
`<magic priority="50">`	Cet élément contient une liste des éléments `match` comme ses enfants. L'attribut `priority` est facultatif et spécifie une priorité entre 0 et 100 (100 étant la priorité de correspondance la plus élevée). Chaque élément `match` enfant a trois attributs requis et un attribut facultatif : `type` `offset` `value` `mask` (attribut facultatif) Pour des détails sur ces attributs, reportez-vous à la XDG shared mime info specification.
`<alias type="media/subtype">`	Cet élément définit un alias pour l'élément `mime-type` parent. Par exemple, `application/x-pdf` est un alias pour le type MIME `application/pdf`.
`<sub-class-of type="media/subtype">`	Cet élément définit l'élément `mime-type` parent comme sous-classe du type MIME spécifié dans l'attribut `type`. Par exemple, `image/svg` est une sous-classe des types MIME `text/xml`, `text/plain` et `application/octet-stream`.
`<comment xml:lang="locale">`	Cet élément fournit une description lisible pour le type MIME. Aucune ou plusieurs occurrences de cet élément peuvent exister, tant que chacune contient une valeur unique pour l'attribut `xml:lang`.
`<root-XML namespaceURI="namespace" localName="">`	S'il s'avère qu'un fichier est un fichier XML, cet élément aide à classifier davantage le type de fichier à l'aide des attributs `namespaceURI` et `localName`. L'attribut `namespaceURI` est l'espace de nom du document, et `localName` le nom de l'élément racine du document. Si `localName` est présent et que la valeur est vide, l'élément racine peut avoir n'importe quel nom, mais l'esspace de nom doit toujours correspondre.

L'exemple suivant définit le type MIME text/x-diff.

Exemple 6-1 Exemple de fichier XML source diff.xml :

<?xml version='1.0'?>
<mime-info xmlns='http://www.freedesktop.org/standards/shared-mime-info'>
<mime-type type="text/x-diff">
	<comment>Differences between files</comment>
	<comment xml:lang="af">verskille tussen lêers</comment>
	<!-- more translated comment elements -->
	<magic priority="50"> <match type="string" offset="0" value="diff\t"/>
		<match type="string" offset="0" value="***\t"/>
		<match type="string" offset="0" value="Common subdirectories: "/>
	</magic>
	<glob pattern="*.diff"/>
	<glob pattern="*.patch"/>
</mime-type>
</mime-info>

Dans cet exemple, plusieurs élément comment donnent un nom lisible au type MIME dans différentes langues. Le type MIME text/x-diff possède des règles pour faire correspondre les deux via des modèles globaux et via l'utilisation du reniflement de contenu (aussi appelé règles magiques). Tous les fichiers avec l'extension .diff ou .patch sont résolus sur ce type MIME. De plus, tous les fichiers dont le contenu commence avec les chaînes spécifiées dans les attributs value de l'élément match sont résolus sur le type MIME text/x-diff. Pour plus d'informations sur les modèles globaux et les règles magiques, reportez-vous à la XDG shared mime info specification.