How to apply the Menu button
============================

The menu button is starting point for the menu.
It first has to be added to the panel.
To add the KBFX Menu to the panel, proceed as following:
  Right-click on the panel, on which you want to place the KBFX button
  Select "Add Applet to panel" in the context menu
  Select "KBFX Spinx"
A tooltip appears "KBFX Spinx Added"
If you move your mouse over the button, a tooltip appears (turned off
in the default configuration).
If you want to, you can now remove the K-Menu button and move the KBFX
to the desired place on the panel.
To open the menu, just click on the button.



How to create themes for KBFX 0.4.9.3
=====================================

So you want to create your own themes for KBFX 0.4.9.3?
The guide is done in a simple manner and we hope that you will easily and
simply create themes for KBFX 0.4.9.3. If you don't like something in this
guide, please feel free to contact us at IRC on irc.freenode.org
on channel #kbfx

NOTE: The values for Width and Height are only our suggested values.
      You can use whatever values you feel are appropriate for your theme.

 topbg.png
 ---------
 This is an image that is at the top of the menu.
 Width = 504px
 Height = 95px

 dudebox.png
 -----------
 This is the background image where your personal image is displayed.
 Width = 95px
 Height = 88px

 menu_top_image_person.png
 -------------------------
 This image is used for theme's default personal image.
 Width = 48 px
 Height = 48 px

 find.png
 --------
 This is a small image displayed in the search field.
 Width = 22px
 Height = 21px

 rhstile.png
 -----------
 This is normal image displayed in categories.
 Width = 132px
 Height = 23px

 rhshovertile.png
 ----------------
 This is a hover image for categories.Used as hoverimage for rhstile.png
 Width = 132px
 Height = 23px

 scrollnormal.png
 ----------------
 This image is used as a scrollbar. The same image is used both for
 scrolling up & down.
 Width = 240px
 Height = 10px

 separator.png
 -------------
 This is the separator image which separates your different subcategories.
 Width = 240px
 Height = 27px

 tilenormal.png
 --------------
 This is the normal image where your applications are showed.
 Width = 240px
 Height = 46px

 tilehover.png
 -------------
 This is the hover image where your applications are showed.
 Width = 240px
 Height = 46px

 listbox.png
 -----------
 This is the background under the categories. It can be viewed on description
 on both sides of the menu.
 Width = 108px
 Height = 23px

 middleboxbg.png
 ---------------
 This is the background of the middle part of the menu.
 Width = 200px
 Height = 270px

 botbg.png
 ---------
 This is the background image at the bottom off the menu.
 Width = 504px
 Height = 38px

 lock.png
 --------
 This is the lock image.
 Width = 84px
 Height = 38px

 lockhover.png
 -------------
 This is the lock hover image.
 Width = 84px
 Height = 38px

 logout.png
 ----------
 This is the logout image.
 Width = 84px
 Height = 38px


 logouthover.png
 ---------------
 This is the logout hover image.
 Width = 84px
 Height = 38px

 mask.png
 --------
 This is deciding what size your menu will have when users install it.
 Of course the size can be controlled later by the configuration of KBFX.
 Width = 504px
 Height = 513px

 preview.png
 -----------
 preview.png should be a snapshot of the working KBFX theme. It is used in the
 configuration application in order the user to see what the theme will look like.
 Width = 170 px
 Height = 205 px

 normal.png / hover.png / pressed.png
 ------------------------------------
 These are the KBFX Buttons for the kicker panel that are used in the theme.
 Width and Height - as you like, but preferably Height not to be too much.


More information can be found on:
 http://www.kbfx.org/staticpages/index.php?page=howto0493



How to write theme's kbfxfontrc and kbfxlayoutrc files
======================================================

  Every theme MAY have two configuration files named:

kbfxfontrc - configures the fonts properties that the theme uses
kbfxlayoutrc - configures the layout of the theme, the KBFX button
               and some other properties of the theme

  If one or both of these files don't exist, KBFX internal configuration
options will be used for fonts and layout.
  All the properties and values are separated between different Sections
in the way showed below:

[Section]
property = value

NOTE:  - Pay close attention to the case of the properties and Sections names
	 because the configuration is CASESENSITIVE!
       - The order of the sections in the file is not important!


 File  kbfxfontrc
 ----------------
 It's best the colors to be represented in RGB format.
 Font Properties should constrain to QFont class representation.
 The values bellow are the default ones:

  [Fonts]
  ApplicationText=0,0,0
  ApplicationTextFont=Arial,8,-1,5,50,0,0,0,0,0
  CommentText=128,125,0
  CommentTextFont=Arial,8,-1,5,50,0,0,0,0,0
  GroupText=0,0,0
  GroupTextFont=Arial,8,-1,5,50,0,0,0,0,0
  UserName=255,255,255
  UserNameFont=Arial,10,-1,5,75,0,0,0,0,0
  SeparatorColor=0,0,0
  SeparatorFont=Arial,8,-1,5,50,0,0,0,0,0
  PluginColor=0,0,0
  PluginFont=Arial,8,-1,5,50,0,0,0,0,0
  LineColor=255,220,125
  # This is if the font when you hover on an item will be bold
  HoverBold = false

 File  kbfxlayoutrc
 ------------------
 The values bellow are the default ones:

  [KbfxButton]
  # Describes the paths to theme's buttons.
  # KBFX uses the normal.png/hover.png/pressed.png
  # that are in the theme's folder by default
  # We recommend not to use this section!
  Normal = KBFX Normal Button Full Path
  Hover = KBFX Hover Button Full Path
  Press = KBFX Pressed Button Full Path

  [TopBar]
  # Face Position X
  DudeX=-1
  # Face Position Y
  DudeY=-1
  # Face Box Height
  FaceH=64
  # Face Box Width
  FaceW=65
  # Face Box Position X
  FaceX=27
  # Face Box Position Y
  FaceY=8
  # User Name Position X
  UserNameX=130
  # User Name Position Y
  UserNameY=32
  # Top Bar Height
  Height=95
  # Top Bar Width
  Width=504
  # Top Bar Position X
  X=0
  # Top Bar Position Y
  Y=0
  # Hide User Name
  DisableUserName=false

  [BottomBar]
  # Bottom Bar Height
  Height=38
  # Bottom Bar Width
  Width=504
  # Bottom Bar Position X
  X=0
  # Bottom Bar Position Y
  Y=428

  [Scrollbars]
  # THIS SECTION IS NOT USED FOR NOW
  # Bottom Scroll Bar Position X
  ScrollBarBotX=108
  # Bottom Scroll Bar Position Y
  ScrollBarBotY=95
  # Top Scroll Bar Position X
  ScrollBarTopX=108
  # Top Scroll Bar Position Y
  ScrollBarTopY=95

  [ListBox]
  # List Box Height
  Height=275
  # List Box Width
  Width=132
  # List Box Position X
  X=0
  # List Box Position Y
  Y=95

  [SearchBox]
  # Search Box Height
  Height=22
  # Search Box Width
  Width=240
  # Search Box Position X
  X=130
  # Search Box Position Y
  Y=48

  [ItemView]
  # Item Height
  Height=275
  # Item Width
  Width=240
  # Item Position X
  X=132
  # Item Position Y
  Y=95

  [ItemProperties]
  # Comment Margin in Item
  CommentMargin=66
  # Icon Size in Item
  IconSize=32
  # No Comments in Item
  NoComments=false

  [ToolBar]
  # Tool Bar Button Normal Size
  ButtonNormalSize=48
  # Tool Bar Button Pressed Size
  ButtonPressedSize=48

  [MainMenu]
  # Contracted Menues
  ContractedMenu=false
  # Main Menu Height
  UserMenuHeight=513
  # Main Menu Width
  UserMenuWidth=504

  [WaterEffect]
  # Enabled Water Effect
  EnableWater=false
  # Water Effect Frame Rate
  FrameRate=0



 How to create a ".kbfxtheme" file
 =================================

The ".kbfxtheme" file is a simple archive file (.tar.gz or .tar.bz2) that should
contain at least these elements:
- one or more theme folders with all the necessary images/files inside. Have in mind
  that the name of the theme is the name of the folder.
- in the theme(s) folder there should be an image called preview.png that serves
  as a live preview of the look of the theme.
- the extension of the archive should be ".kbfxtheme"

You can create ".kbfxtheme" file following these instructions (there is
an option in Konqueror's rightclick "Actions" menu for preparing KBFX Theme Package
or you can create the ".kbfxtheme" file manually as described bellow):
- Create a folder with a name that is identical to the name you want for your theme.
- Put the necessary images/files inside it (see the above instructions for the images part).
- Create an archive of the folder (with ark/tar etc).
- Rename the archive file to ".kbfxtheme" and you are ready.


 How to help us out
 ==================

You can help us for the KBFX releases with the translation of the interface.
For this purpose please download the kbfxconfigapp.pot file from SourceForge:
http://sourceforge.net/project/showfiles.php?group_id=141258&package_id=210120 .
Then use KBabel (http://kbabel.kde.org/) or poEdit (http://www.poedit.org/) to make the translation.
Next send the .po file to my mail - phobosk@mail.kbfx.org
Thanks in advance for this help.
