-{r2}
|
{maketoc}
|
-bitweaver has always had th eoption of using your own icons by overriding existing ones. This has just been overhauled in R2 - our icon styles are now compatible with Gnome and KDE icon themes!
|
-
|
-! Using the IconStyles
|
-IconStyles can be viewed and chosen on the Admin --> Themes --> Themes Manager page. A selection of icons is shown that you can select your favourite theme easily.
|
-As soon as you add a new icon style, it should appear on the Themes Manager ready for selection.
|
+Bitweaver's __Icon Styles__ are compatible with Gnome and KDE icon themes. Icon Styles can be viewed and chosen on the ''Admin > Themes > Themes Manager'' page. Icons Styles are presented for you to select from: |
|
{attachment id=403}
|
-A screenshot of the administration area where you can pick an icon style
|
|
-!! Where can i get more IconStyles?
|
-We don't have a repository for this yet. Hopefully soon though. We have started some ((icon research)) with a list of possible icon sets.
|
-
|
-! Adding new IconStyles
|
-It's quite easy to add new IconStyles thanks to the fact that we try to stick to the official [http://tango.freedesktop.org/Standard_Icon_Naming_Specification|Icon Naming Specification]. Since the [http://tango.freedesktop.org/|Tango Desktop Project] is tightly associated with the icon naming specification we chose this theme as the bitweaver default.
|
-
|
-!! Where are Icon Styles?
|
-You can find icon styles in your themes directory. The structure of an icon style is outlined below.
|
+! About Icon Styles |
+Icon Styles added by the admin appear on the ''Themes Manager'' page. See ((icon research)) as a starting point for a new Icon Style. It's quite easy to add new Icon Styles thanks to the fact that Bitweaver sticks to the official [http://tango.freedesktop.org/Standard_Icon_Naming_Specification|Icon Naming Specification]. Since the [http://tango.freedesktop.org/|Tango Desktop Project] is tightly associated with the icon naming specification we chose their theme Tango as bitweaver's default. The available Icon Styles reside in the themes directory: |
{code title="IconStyles Directory"}
|
// base IconStyles directory
|
-themes/icon_styles/<style>/
|
+themes/icon_styles/somestyle/ |
|
// substructure of the icon style
|
-themes/icon_styles/<style>/small/
|
-themes/icon_styles/<style>/large/
|
-themes/icon_styles/<style>/style_info/
|
+themes/icon_styles/somestyle/small/ |
+themes/icon_styles/somestyle/large/ |
+themes/icon_styles/somestyle/style_info/ |
{/code}
|
|
-!! 1. Get new Icon Theme
|
-You can get more icon themes from here - Please note that most of these themes don't adhere to the naming convention yet and will therefore probably not work with bitweaver. If you find new themes that adhere to naming specifications please let us know.
|
+! Overriding or adding specific icons |
+To use icons that are not part of an Icon Style, or to override icons that are, use the icons directory in your custom style. E.g., to override the "busy" icon in liberty/icons/ place the new "busy" icon in themes/styles/yourstyle/icons/liberty/ (must have either gif, png or jpg extension). |
+ |
+! Getting new icon themes |
+Icon themes that don't adhere to the naming convention will probably not work with Bitweaver. Themes that do adhere to the naming specifications can be found on sites like: |
* [http://art.gnome.org/themes/icon/|Gnome art]
|
* [http://www.kde-look.org/index.php?xcontentmode=27|KDE-look]
|
-* Here is a [http://ramnet.se/~nisse/diverse/temp/themes%20following%20the%20naming%20spec.html|list of IconStyles that adhere to the naming specification]
|
+* [http://ramnet.se/~nisse/diverse/temp/themes%20following%20the%20naming%20spec.html|list of IconStyles that adhere to the naming specification] |
|
-!! 2. Make the icon style compatible with bitweaver
|
+! Making the icon theme compatible with Bitweaver |
There are 3 types of icon themes:
|
-# Themes that have a full set of various icon sizes
|
-# Themes that come as SVG icons only
|
-# Themes that come as a mixture where the PNG icon versions are used to give a nicer version of a given icon at it's size
|
+# themes that have a full set of various icon sizes |
+# themes that come as SVG icons only |
+# themes that come as a mixture where the PNG icon is a nicer version of a given icon |
|
-!!! 1. Full icon set themes
|
+!! 1. Full icon set themes |
These icon themes are the easiest to convert.
|
{code title="Typical icon theme directory structure"}
|
// List of directories within the theme
|