mirror of
https://github.com/netsurf-browser/netsurf
synced 2024-12-19 18:52:39 +03:00
73 lines
3.3 KiB
XML
73 lines
3.3 KiB
XML
<?xml version="1.0"?>
|
|
<!DOCTYPE riscos-prm PUBLIC "-//Gerph//DTD PRM documentation 1.00//EN"
|
|
"http://www.movspclr.co.uk/dtd/100/prm.dtd">
|
|
|
|
<!-- $Id: Themes.xml,v 1.4 2003/11/23 18:08:07 jmb Exp $ -->
|
|
|
|
<riscos-prm doc-group="NetSurf User's Manual">
|
|
<chapter title="NetSurf Themes">
|
|
<section title="Introduction and Overview">
|
|
<p>NetSurf has inbuilt support for themed icons and status bar tools.<br/>
|
|
This document details how to create your own themes for NetSurf</p>
|
|
</section>
|
|
|
|
<section title="Tools Required">
|
|
<p>In order to create a new theme, you will require the following tools:
|
|
<list type="unordered">
|
|
<item><p> A template editor </p></item>
|
|
<item><p> A sprite file editor </p></item>
|
|
</list>
|
|
</p>
|
|
</section>
|
|
|
|
<section title="Creating Templates">
|
|
<p>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.</p>
|
|
|
|
<p>The templates file must contain one template. It should be called "toolbar".</p>
|
|
|
|
<subsection title="Toolbar">
|
|
<p>The toolbar template must contain the following icons, which <strong>must</strong> be numbered (as indicated in parentheses):
|
|
<list type="unordered">
|
|
<item><p> Throbber (1)</p></item>
|
|
<item><p> URL entry bar (2)</p></item>
|
|
<item><p> Status bar (3)</p></item>
|
|
<item><p> Back Button (4)</p></item>
|
|
<item><p> Refresh Button (5)</p></item>
|
|
</list></p>
|
|
</subsection>
|
|
</section>
|
|
|
|
<section title="Sprites">
|
|
<p>Sprites should be contained in a single file named "Sprites".</p>
|
|
|
|
<p>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).</p>
|
|
|
|
<p>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)</p>
|
|
|
|
<subsection title="Optional Preview Sprite">
|
|
<p>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".</p>
|
|
</subsection>
|
|
</section>
|
|
|
|
<section title="Packaging your Theme">
|
|
<p>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.</p>
|
|
</section>
|
|
|
|
<section title="Submitting your Theme">
|
|
<p>Themes may be uploaded to the central NetSurf theme repository at <reference type="link" href="http://netsurf.sourceforge.net/themes/">http://netsurf.sourceforge.net/themes/</reference></p>
|
|
</section>
|
|
|
|
</chapter>
|
|
|
|
<meta>
|
|
<maintainer>
|
|
<email name="NetSurf Development Team" address="netsurf-develop@lists.sourceforge.net" />
|
|
</maintainer>
|
|
|
|
<history>
|
|
<revision number="0.01" date="03/06/03" author="JMB" title="Initial version" />
|
|
<revision number="0.02" date="03/06/03" author="JMB" title="Various changes for clarity" />
|
|
<revision number="0.03" date="23/11/03" author="JMB" title="Updated after theme code tidy."/>
|
|
</history>
|
|
</meta>
|
|
</riscos-prm> |