351486 - Documentation for the new "skins" feature

Status: RESOLVED FIXED

(Bugzilla :: Documentation, enhancement)

Description

[Max Kanat-Alexander]

The new skins feature needs docs. Here's a text description of it and how it works:


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:

* Make a single CSS file, and put it in the skins/contrib directory.
* Make a directory that contains all the same CSS file names as skins/standard/,
  and put your directory in skins/contrib/.

After you put the file or the directory there, make sure to run checksetup.pl so that it can reset the file permissions correctly.

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.

Comment 1

[Colin Ogilvie [:cso]]

Attachment: Patch v1

Max's text converted to docbook.

Comment 2

[Marc Schumann [:Wurblzap]]

Comment on attachment 240672 [details] [diff] [review]
Patch v1

r=wurblzap for Max' text (I don't know docbook and I can't test).

Comment 3

[Colin Ogilvie [:cso]]

(In reply to comment #2)
> (I don't know docbook and I can't test).

http://landfill.mozilla.org/csodocs/html/cust-skins.html (and I'm the module owner for docs anyway) so I guess it's fine if you've OKed the text.

Comment 4

[Marc Schumann [:Wurblzap]]

Yup.

Comment 5

[Max Kanat-Alexander]

Comment on attachment 240672 [details] [diff] [review]
Patch v1

Yeah, Wurblzap's OK is good enough.

Comment 6

[Colin Ogilvie [:cso]]

Checking in docs/xml/customization.xml;
/cvsroot/mozilla/webtools/bugzilla/docs/xml/customization.xml,v  <--  customization.xml
new revision: 1.36; previous revision: 1.35
done