mozilla

Compare Revisions

Creating a Skin for Firefox/Getting Started

Change Revisions

Revision 97116:

Revision 97116 by Carrieduh on

Revision 97117:

Revision 97117 by Carrieduh on

Title:
Creating a Skin for Firefox/Getting Started
Creating a Skin for Firefox/Getting Started
Slug:
Creating_a_Skin_for_Firefox//Getting_Started
Creating_a_Skin_for_Firefox//Getting_Started
Tags:
Add-ons, Themes
Add-ons, Themes
Content:

Revision 97116
Revision 97117
n109    <h6 name="install.rdf">n
110      install.rdf
111    </h6>
n113      Make a copy of <a href="en/Creating_a_Skin_for_Firefox/instn110      <a class="external" href="http://www.myspace.com"></a>
>all.rdf">install.rdf</a> and place it in the <code>My_Theme</code 
>> directory, then open it up in your text editor. This file is a  
>small XML database that describes the skin. 
111    </p>
112    <h4 name="CSS_Files">
113      <a class="external" href="http://www.myspace.com">CSS Files
 ></a>
114    </h4>
115    <p>
116      <a class="external" href="http://www.myspace.com">The CSS f
 >iles in these directories tell the browser how to display the but
 >tons and other controls, where to put the images, what border and
 > padding it should put around them, and so on.</a>
117    </p>
118    <p>
119      <a class="external" href="http://www.myspace.com">As an exa
 >mple, lets change the standard button.</a>
120    </p>
121    <p>
122      <a class="external" href="http://www.myspace.com">Go into t
 >he global <tt>global</tt> directory and open <tt>button.css</tt> 
 >in your favorite text editor. Scroll down to <code>button {</code
 >>. This section defines the normal button in its basic state (The
 >re is no mouse over it, it's not disabled, and it's not selected)
 >.</a>
123    </p>
124    <p>
125      <a class="external" href="http://www.myspace.com">Change th
 >e <code>background-color:</code> to <code>DarkBlue</code> and the
 > <code>color:</code> to <code>White</code>, and save the file.</a
 >>
126    </p>
127    <p>
128      <a class="external" href="http://www.myspace.com"><i>more a
 >fter I get done with some tests</i></a>
129    </p>
130    <h4 name="Repackaging_JAR">
131      <a class="external" href="http://www.myspace.com">Repackagi
 >ng JAR</a>
132    </h4>
133    <p>
134      <a class="external" href="http://www.myspace.com">Now all y
 >ou need to do is repackage a JAR file with the following director
 >y structure, using your favorite archive manager to create a zip 
 >archive:</a>
n116  &lt;Description about="urn:mozilla:install-manifest"&gt;n137<a class="external" href="http://www.myspace.com">/browser/*
117  &lt;em:id&gt;{Themes_UUID}&lt;/em:id&gt;
118  &lt;em:version&gt;Themes_Version&lt;/em:version&gt;
119</pre>
120    <p>
121      The first section requires that you establish a <a href="en
>/Creating_a_Skin_for_Firefox/UUID">UUID</a> for your theme and th 
>at you give your theme a version number. Once you've done this, i 
>nsert the information as above, and scroll down. 
122    </p>
123    <p>
124      You will also have to update the minimum and maximum compat
>ible versions for the target application (Firefox) in the followi 
>ng section: 
125    </p>
126    <pre>
127  &lt;em:targetApplication&gt;
128    &lt;Description&gt;
129      &lt;!-- Firefox's UUID --&gt;
130      &lt;em:id&gt;{ec8030f7-c20a-464f-9b0e-13a3a9e97384}&lt;/em:
>id&gt; 
131      &lt;em:minVersion&gt;Min_FF_Version&lt;/em:minVersion&gt;
132      &lt;em:maxVersion&gt;Max_FF_Version&lt;/em:maxVersion&gt;
133    &lt;/Description&gt;
134  &lt;/em:targetApplication&gt;
135</pre>
136    <p>
137      Establishing both minimum and maximum compatible versions l
>ets you avoid conflicts with versions of Firefox your theme wasn' 
>t designed for -- or wasn't tested on. 
138    </p>
139    <h4 name="CSS_Files">
140      CSS Files
141    </h4>
142    <p>
143      The CSS files in these directories tell the browser how to 
>display the buttons and other controls, where to put the images,  
>what border and padding it should put around them, and so on. 
144    </p>
145    <p>
146      As an example, lets change the standard button.
147    </p>
148    <p>
149      Go into the global <tt>global</tt> directory and open <tt>b
>utton.css</tt> in your favorite text editor. Scroll down to <code 
>>button {</code>. This section defines the normal button in its b 
>asic state (There is no mouse over it, it's not disabled, and it' 
>s not selected). 
150    </p>
151    <p>
152      Change the <code>background-color:</code> to <code>DarkBlue
></code> and the <code>color:</code> to <code>White</code>, and sa 
>ve the file. 
153    </p>
154    <p>
155      <i>more after I get done with some tests</i>
156    </p>
157    <h4 name="Repackaging_JAR">
158      Repackaging JAR
159    </h4>
160    <p>
161      Now all you need to do is repackage a JAR file with the fol
>lowing directory structure, using your favorite archive manager t 
>o create a zip archive: 
162    </p>
163    <pre>
164/browser/*
n173  n146  </a>
n176      Make sure not to just zip up the <tt>My_Theme</tt> parent dn149      <a class="external" href="http://www.myspace.com">Make sure
>irectory since that will cause the drag and drop install in the n> not to just zip up the <tt>My_Theme</tt> parent directory since 
>ext section to fail without error messages.>that will cause the drag and drop install in the next section to 
 >fail without error messages.</a>
n179      Triggering the install from the webn152      <a class="external" href="http://www.myspace.com">Triggerin
 >g the install from the web</a>
n182      To install the theme's JAR file directly from the web, you n155      <a class="external" href="http://www.myspace.com">To instal
>need to run some JavaScript.>l the theme's JAR file directly from the web, you need to run som
 >e JavaScript.</a>
n185&lt;a href='javascript:InstallTrigger.installChrome(InstallTriggen158<a class="external" href="http://www.myspace.com">&lt;a href='jav
>r.SKIN, >ascript:InstallTrigger.installChrome(InstallTrigger.SKIN, 
nn160</a>
t189      If you have JAR files on your hard drive and would like to t163      <a class="external" href="http://www.myspace.com">If you ha
>install them, then download/use <a class="external" href="http://>ve JAR files on your hard drive and would like to install them, t
>www.eightlines.com/neil/mozskin/installjar.html">this form</a>.>hen download/use</a> <a class="external" href="http://www.eightli
 >nes.com/neil/mozskin/installjar.html">this form</a>.

Back to History