NetSurf

NetSurf Themes

Introduction & Overview

NetSurf has inbuilt support for themed icons and status bar tools. This document details how to create your own themes for NetSurf.

Tools Required

In order to create a new theme, you will require the following tools:

Creating Templates

The best way to go about creating a new theme is to take the templates for the default theme and edit them with a template editor.

The templates file must contain one template. It should be called "toolbar".

Toolbar

The toolbar template must contain the following icons, which must be numbered (as indicated in parentheses):

Sprites

Sprites should be contained in a single file named "Sprites".

Throbber sprites should display the various stages of progress and should be named "throbberN", where N is a numerical suffix (eg throbber0, throbber 23 etc).

Button sprites can be called whatever you like. The only limitation is that two sprites are provided per button - one unpressed, the other pressed. Also, the template validation strings for each button should contain the sprite names (eg Sbackl,backp)

Optional Preview Sprite

You may optionally provide a preview sprite for display in the theme configuration dialogue box. The sprite must be in a file called "Preview" and the sprite itself must be called "preview".

Packaging your Theme

The default packaging for NetSurf themes is simply a folder named the same as your theme name (eg "Clear" for the Clear theme). Simply place all the files for your theme into a single directory, name the directory appropriately and create a Zip archive containing your theme.

Submitting your Theme

Themes may be uploaded to the central NetSurf Theme repository at http://netsurf.sourceforge.net/themes/.