diff options
Diffstat (limited to 'files/fr/theme_packaging')
| -rw-r--r-- | files/fr/theme_packaging/index.html | 100 |
1 files changed, 100 insertions, 0 deletions
diff --git a/files/fr/theme_packaging/index.html b/files/fr/theme_packaging/index.html new file mode 100644 index 0000000000..e3377ec59d --- /dev/null +++ b/files/fr/theme_packaging/index.html @@ -0,0 +1,100 @@ +--- +title: Empaqueter un thème +slug: Theme_Packaging +tags: + - Themes +translation_of: Mozilla/Thunderbird/Thunderbird_extensions/Theme_Packaging +--- +<p>Ce document décrit comment sont packagés les <a href="fr/Th%c3%a8mes">thèmes</a> pour Firefox et Thunderbird.</p> +<h3 id="Pr.C3.A9alables" name="Pr.C3.A9alables">Préalables</h3> +<p>Construire un thème pour Firefox ou Thunderbird requiert quelques connaissances des feuilles de style en cascade (<a href="fr/CSS">CSS</a>), probablement de <a href="fr/XBL">XBL</a>, et quelques notions de design graphique et d'esthétisme (...ou peut-être pas). Ce document décrit seulement comment les thèmes sont packagés afin d'être affichés dans la fenêtre des thèmes de l'application.</p> +<h3 id="Arborescence_des_fichiers_d.27un_th.C3.A8me" name="Arborescence_des_fichiers_d.27un_th.C3.A8me">Arborescence des fichiers d'un thème</h3> +<p>Les thèmes Firefox/Thunderbird sont packagés dans un fichier JAR avec la structure arborescente suivante :</p> +<pre class="eval">montheme.jar : + install.rdf + contents.rdf + preview.png + icon.png + browser/<i>fichiers</i> + global/<i>fichiers</i> + mozapps/<i>fichiers</i> + communicator/<i>fichiers</i> + ... + +</pre> +<ul> + <li>Vous devez avoir à la racine un fichier <a href="fr/Chrome.manifest">chrome.manifest</a> (Firefox/Thunderbird 1.5) ou un fichier contents.rdf qui référence le chrome pour le thème (comme avant) et aussi un manifest <a href="fr/Install.rdf">install.rdf</a> qui spécifit les meta-données affichées dans la fenêtre de gestion des thèmes.</li> + <li>preview.png est une image d'aperçu qui sera afficher dans la zone d'aperçu de la fenêtre de gestion des thèmes. Cette image peut avoir n'importe qu'elle taille a priori.</li> + <li>icon.png est un PNG de 32x32 (qui peut contenir un canal alpha de transparence) qui sera également visible dans la liste des thèmes de la fenêtre de gestion des thèmes.</li> +</ul> +<h3 id="install.rdf" name="install.rdf">install.rdf</h3> +<p>Votre fichier manifest <a href="fr/Install.rdf">install.rdf</a> devrait ressembler à cela :</p> +<pre class="eval"><?xml version="1.0"?> + +<RDF xmlns="<a class="external" href="http://www.w3.org/1999/02/22-rdf-syntax-ns#" rel="freelink">http://www.w3.org/1999/02/22-rdf-syntax-ns#</a>" + xmlns:em="<a class="external" href="http://www.mozilla.org/2004/em-rdf#" rel="freelink">http://www.mozilla.org/2004/em-rdf#</a>"> + + <Description about="urn:mozilla:install-manifest"> + <em:type>4</em:type><i>more properties</i> + </Description> +</RDF> +</pre> +<h4 id="Les_propri.C3.A9t.C3.A9s_requises_dans_install.rdf" name="Les_propri.C3.A9t.C3.A9s_requises_dans_install.rdf">Les propriétés requises dans install.rdf</h4> +<p>Votre manifest install.rdf doit contenir les propriétés suivantes. Consultez la référence <a href="fr/Install.rdf">install.rdf</a> pour plus d'informations :</p> +<ul> + <li>em:id</li> + <li>em:version</li> + <li>em:type</li> + <li>em:targetApplication</li> + <li>em:name</li> + <li>em:internalName</li> +</ul> +<h4 id="Les_propri.C3.A9t.C3.A9s_optionnelles_d.27install.rdf" name="Les_propri.C3.A9t.C3.A9s_optionnelles_d.27install.rdf">Les propriétés optionnelles d'install.rdf</h4> +<ul> + <li>em:description</li> + <li>em:creator</li> + <li>em:contributor</li> + <li>em:homepageURL</li> + <li>em:updateURL</li> +</ul> +<p>Il est à noter que si votre thème est disponible sur le site Web officiel <a class="external" href="http://addons.mozilla.org" rel="freelink">http://addons.mozilla.org</a>, il ne devra pas inclure de propriété <code>updateURL</code>.</p> +<h4 id="Exemple_de_fichier_manifest_install.rdf" name="Exemple_de_fichier_manifest_install.rdf">Exemple de fichier manifest install.rdf</h4> +<pre class="eval"><?xml version="1.0"?> + +<RDF xmlns="<a class="external" href="http://www.w3.org/1999/02/22-rdf-syntax-ns#" rel="freelink">http://www.w3.org/1999/02/22-rdf-syntax-ns#</a>" + xmlns:em="<a class="external" href="http://www.mozilla.org/2004/em-rdf#" rel="freelink">http://www.mozilla.org/2004/em-rdf#</a>"> + + <Description about="urn:mozilla:install-manifest"> + <em:id>{18b64b56-d42f-428d-a88c-baa413bc413f}</em:id> + <em:version>1.0</em:version> + <em:type>4</em:type> + + <!-- Target Application this extension can install into, + with minimum and maximum supported versions. --> + <em:targetApplication> + <Description> + <em:id>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</em:id> + <em:minVersion>0.8</em:minVersion> + <em:maxVersion>0.9</em:maxVersion> + </Description> + </em:targetApplication> + + <!-- Front End MetaData --> + <em:name>New Theme 1</em:name> + <em:description>A test theme for Firefox</em:description> + <em:creator>Ben Goodger</em:creator> + <em:contributor>John Doe</em:contributor> + <em:homepageURL><a class="external" href="http://www.bengoodger.com/" rel="freelink">http://www.bengoodger.com/</a></em:homepageURL> + + <!-- Front End Integration Hooks (used by Theme Manager)--> + <em:internalName>newtheme1</em:internalName> + </Description> +</RDF> +</pre> +<p>Ce qui suit sont les GUID habituels des applications que vous devez utiliser dans la propriété <code>targetApplication</code> :</p> +<pre class="eval">Firefox {ec8030f7-c20a-464f-9b0e-13a3a9e97384} +Thunderbird {3550f703-e582-4d05-9a08-453d09bdfdc6} +Sunbird {718e30fb-e89b-41dd-9da7-e25a45638b28} +</pre> +<h3 id="R.C3.A9f.C3.A9rence_officielle_de_l.27API_du_toolkit" name="R.C3.A9f.C3.A9rence_officielle_de_l.27API_du_toolkit">Référence officielle de l'<a href="fr/API_du_toolkit">API du toolkit</a></h3> +<p>{{page("/fr/API_du_toolkit/Références_officielles")}}</p> |