files/es/empaquetar_un_tema/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

---
title: Empaquetar un Tema
slug: Empaquetar_un_Tema
tags:
  - Complementos
  - Herramientas_API
  - Temas
  - Todas_las_Categorías
translation_of: Mozilla/Thunderbird/Thunderbird_extensions/Theme_Packaging
---
<p> </p>
<p>Este documento describe cómo empaquetar <a href="es/Temas">temas</a> para Firefox y Thunderbird.</p>
<h3 id="Pre-requisitos" name="Pre-requisitos">Pre-requisitos</h3>
<p>Hacer un tema para Firefox o Thunderbird requiere conocimientos de hojas de estilo en cascada (<a href="es/CSS">CSS</a>), probablemente <a href="es/XBL">XBL</a>, y un poco de habilidad para diseño gráfico y estética (...o quizá no). Este documento describe solamente cómo se empaquetan los temas para ser mostrados en la ventana de los temas de Firefox.</p>
<h3 id="Estructura_de_los_ficheros_del_tema" name="Estructura_de_los_ficheros_del_tema">Estructura de los ficheros del tema</h3>
<p>Los temas Firefox/Thunderbird son empaquetados en un archivo JAR con la siguiente estructura:</p>
<pre class="eval">theme.jar:
  install.rdf
  contents.rdf
  preview.png
  icon.png
  browser/<i>files</i>
  global/<i>files</i>
  mozapps/<i>files</i>
  communicator/<i>files</i>
  ...

</pre>
<ul>
 <li>Debe de existir un fichero <a href="es/Chrome.manifest">chrome.manifest</a> (Firefox/Thunderbird 1.5) o contents.rdf en el nivel superior para registrar el chrome para el tema (como antes) y también un fichero install.rdf que especifique los metadatos mostrados en la ventana de temas.</li>
</ul>
<ul>
 <li>preview.png es una imagen que se mostrarán en el área de previsualización de la ventana de temas. Puede tener cualquier tamaño.</li>
</ul>
<ul>
 <li>icon.png es una imagen png de tamaño 32 x 32 (puede contener transparencias) que será mostrada en la lista y en la ventana de temas.</li>
</ul>
<h3 id="install.rdf" name="install.rdf">install.rdf</h3>
<p>El fichero <a href="es/Install.rdf">install.rdf</a> debe de tener este aspecto:</p>
<pre class="eval">&lt;?xml version="1.0"?&gt;

&lt;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>"&gt;

  &lt;Description about="urn:mozilla:install-manifest"&gt;
    &lt;em:type&gt;4&lt;/em:type&gt;<i>otras propiedades</i>
  &lt;/Description&gt;
&lt;/RDF&gt;
</pre>
<h4 id="Propiedades_de_install.rdf_requeridas" name="Propiedades_de_install.rdf_requeridas">Propiedades de install.rdf requeridas</h4>
<p>El fichero install.rdf debe contener las siguientes propiedades. Véase <a href="es/Install.rdf">Referencia install.rdf</a> para más información:</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="Propiedades_de_install.rdf_opcionales" name="Propiedades_de_install.rdf_opcionales">Propiedades de install.rdf opcionales</h4>
<ul>
 <li>em:description</li>
 <li>em:creator</li>
 <li>em:contributor</li>
 <li>em:homepageURL</li>
 <li>em:updateURL</li>
</ul>
<p>Nótese que si el tema va a ser publicado en el sitio web <a class="external" href="http://addons.mozilla.org" rel="freelink">http://addons.mozilla.org</a>, no debe incluir la parte updateURL.</p>
<h4 id="Fichero_install.rdf_de_ejemplo" name="Fichero_install.rdf_de_ejemplo">Fichero install.rdf de ejemplo</h4>
<pre class="eval">&lt;?xml version="1.0"?&gt;

&lt;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>"&gt;

  &lt;Description about="urn:mozilla:install-manifest"&gt;
    &lt;em:id&gt;{18b64b56-d42f-428d-a88c-baa413bc413f}&lt;/em:id&gt;
    &lt;em:version&gt;1.0&lt;/em:version&gt;
    &lt;em:type&gt;4&lt;/em:type&gt;

    &lt;!-- Aplicación para la cual esta extensión puede ser instaladainto,
         indicando la mínima y máxima versión soportada. --&gt;
    &lt;em:targetApplication&gt;
      &lt;Description&gt;
        &lt;em:id&gt;{ec8030f7-c20a-464f-9b0e-13a3a9e97384}&lt;/em:id&gt;
        &lt;em:minVersion&gt;0.8&lt;/em:minVersion&gt;
        &lt;em:maxVersion&gt;0.9&lt;/em:maxVersion&gt;
      &lt;/Description&gt;
    &lt;/em:targetApplication&gt;

    &lt;!-- Front End MetaData --&gt;
    &lt;em:name&gt;New Theme 1&lt;/em:name&gt;
    &lt;em:description&gt;A test theme for Firefox&lt;/em:description&gt;
    &lt;em:creator&gt;Ben Goodger&lt;/em:creator&gt;
    &lt;em:contributor&gt;John Doe&lt;/em:contributor&gt;
    &lt;em:homepageURL&gt;<a class="external" href="http://www.bengoodger.com/" rel="freelink">http://www.bengoodger.com/</a>&lt;/em:homepageURL&gt;

    &lt;!-- Front End Integration Hooks (used by Theme Manager)--&gt;
    &lt;em:internalName&gt;newtheme1&lt;/em:internalName&gt;
  &lt;/Description&gt;
&lt;/RDF&gt;
</pre>
<p>Los siguientes son algunos GUIDs de aplicaciones comunes que puedes usar en la propiedad targetApplication:</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="Referencia_oficial_para_Toolkit_API" name="Referencia_oficial_para_Toolkit_API">Referencia oficial para <a href="es/Toolkit_API">Toolkit API</a></h3>
<div>
 {{page("/es/docs/Toolkit_API/Official_References")}}</div>