From: mozilla%colinogilvie.co.uk <>
Date: Mon, 9 Oct 2006 01:30:27 +0000 (+0000)
Subject: Bug 351486: Documentation for the new "skins" feature
X-Git-Tag: bugzilla-2.23.3~12
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e4269baa7ee4e8beb05214fb59c6a81a61b249cf;p=thirdparty%2Fbugzilla.git

Bug 351486: Documentation for the new "skins" feature
Patch by Colin Ogilvie <colin.ogilvie@gmail.com>; r=wurblzap
---

diff --git a/docs/xml/customization.xml b/docs/xml/customization.xml
index 4a832c6144..20924f5f55 100644
--- a/docs/xml/customization.xml
+++ b/docs/xml/customization.xml
@@ -2,6 +2,42 @@
 <chapter id="customization">
   <title>Customising Bugzilla</title>
 
+  <section id="cust-skins">
+    <title>Custom Skins</title>
+    
+    <para>
+      Bugzilla allows you to have multiple skins. These are custom CSS and possibly
+      also custom images for Bugzilla. To create a new custom skin, you have two
+      choices:
+      <itemizedlist>
+        <listitem>
+          <para>
+            Make a single CSS file, and put it in the 
+            <filename>skins/contrib</filename> directory.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Make a directory that contains all the same CSS file
+            names as <filename>skins/standard/</filename>, and put
+            your directory in <filename>skins/contrib/</filename>.
+          </para>
+        </listitem>
+      </itemizedlist>
+    </para>
+      
+    <para>
+      After you put the file or the directory there, make sure to run checksetup.pl
+      so that it can reset the file permissions correctly.
+    </para>
+    <para>
+      After you have installed the new skin, it will show up as an option in the
+      user's General Preferences. If you would like to force a particular skin on all
+      users, just select it in the Default Preferences and then uncheck "Enabled" on
+      the preference.
+    </para>
+  </section>
+  
   <section id="cust-templates">
     <title>Template Customization</title>