Theming Galeon

This is a quick tutorial explaining how to create and install themes for the
Galeon webbrowser.  It describes the theme format used by galeon 0.12 and
above. 

Enjoy!

1) Theme format
---------------------------

0 Galeon themes consist of a directory filled with images for various parts
  of the interface.
0 Icons may contain alpha-channels.
0 Toolbar button images can also have a NAME-prelight.png version, which is
  displayed when the mouse is above the button. For example Back.png is
  used when the mouse is not over the button, and Back-prelight.png is
  used when the mouse is over the button.
0 Please use ThemeName.tar.gz style packages, for future expansion of galeon's
  theme possibilities and consistency.

This list specifies the list of filenames that can be used (if a file isn't
provided a default image will be used):

New.png            - Toolbar button for opening a new window or tab
Back.png           - Toolbar button for going back in history
BackHistory.png    - Toolbar arrow button for back history
Up.png             - Toolbar button for going up one level
Forward.png        - Toolbar button for going forward in history
ForwardHistory.png - Toolbar arrow button for forward history
Refresh.png        - Toolbar button for refreshing content
Home.png           - Toolbar button for going to your home page
Stop.png           - Toolbar button for stopping current data transfer
Go.png             - Toolbar button for going to the location specified in the
                     location entry
Bookmarks.png      - Toolbar togglebutton for displaying the bookmarks dock
History.png        - Toolbar togglebutton for displaying the history dock
Print.png          - Toolbar button for printing the currently loaded document
ClearLocation.png  - Toolbar button for clearing the location entry
LinkMenu.png       - Toolbar button for opening the <link> menu
Find.png           - Toolbar button for opening the find dialog
Fullscreen.png     - Toolbar button for toggling fullscreen mode
CloseTab.png       - Tab closebutton
smart-bm-fold.png  - Smart bookmark tray icon (the "<<" icon in the default 
                     theme)
smart-bm-unfold.png- Smart bookmark tray icon (the ">>" icon in the default 
                     theme)
i-bookmark.png     - Bookmark icon
default.png        - Default bookmarks folder icon
default_open.png   - Opened default bookmarks folder icon
dir.png            - Bookmarks folder icon
dir_open.png       - Opened bookmarks folder icon
Secure.png         - Secure status icon
Insecure.png       - Insecure status icon

Example theme structure (created when unpacking ExampleTheme.tar.gz):

ExampleTheme/New.png
ExampleTheme/Back.png
ExampleTheme/Up.png
ExampleTheme/Forward.png
ExampleTheme/Home.png
ExampleTheme/Refresh.png
ExampleTheme/Stop.png

2) Installing themes
---------------------------

2.1 Installing themes in your home directory

Uncompress the theme package, if necessary. Put the created directory in
~/.galeon/themes. If a directory wasn't created, create one.

2.2 Installing themes system-wide

Uncompress the theme package, if necessary. Put the created directory in
PREFIX/share/galeon/themes. If a direcetory wasn't created, create one.

3) Spinner theme format
---------------------------

0 Spinner themes consist of a directoy filled with images for the various
  frames of the animation.
0 Please use SpinnerName.tar.gz style packages, for future expansion of galeon's
  theme possibilities and consistency.
0 Spinner frames have a 70ms interval

Spinners consist of images (each image is a frame) labeled like this:
001.png
002.png
003.png
..etc..

Spinners are installed just like ordinary themes, but they should be put in the
"spinners" directory instead of the "themes" directory.
