You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
kbfx/doc/HOWTO

412 lines
11 KiB

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.
- If ANY of these images are missing KBFX will use the image with the
same name from the "default" theme.
- In order to be used by the Configurator and by KBFX, every theme for
0.4.9.3 MUST HAVE a file in it's folder named "version-2" !
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 hover image for rhstile.png
Width = 132px
Height = 23px
scrollnormal.png / scrollnormalbot.png
--------------------------------------
These images are used as top and bottom scrollbars.
Width = 240px
Height = 10px
separator.png / indexseparator.png
----------------------------------
These are the separator images which separate 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
listboxbg.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 of 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
and which will be the transparent parts of the menu (through the alpha
mask of the png image). Of course the size can be controlled later by
the configuration of KBFX.
Width = 504px
Height = 513px
logo.png
---------
logo.png is used as a theme's or author's logo shown in the Information box of
the KBFX Configurator. You can put whatever image you want and it will be scaled
to 100px width by 100px height.
Width = up to 100 px
Height = up to 100 px
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
When you want to prepare a theme, have in mind that every change that you
make in the "KBFX Configurator" is kept in files in your home KDE directory.
Usually these files are here:
~/.trinity/share/apps/kbfx/themerc
and are named:
THEMENAME_layoutrc
THEMENAME_fontrc
So if you want to ship your theme settings from the "KBFX Configurator", the best
thing to do is to use the buttons: "EXPORT KBFXFONTRC FILE" ("Fonts" section of the
Configurator) and "EXPORT KBFXLAYOUTRC FILE" ("Layout section" of the Configurator)
and put the exported files in your theme folder.
NOTE: - Pay close attention to the case of the properties and Sections names
because the configuration is CASE SENSITIVE!
- The order of the sections in the file is not important!
- Have in mind that the Layout of the theme also depends on the sizes of
the images!
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]
TooltipText=0,0,0
TooltipTextFont=Arial,8,-1,5,50,0,0,0,0,0
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]
# Time in msec for which the button
# to fade in/out
FadeTime=75
# The three properties below describe the
# paths to the theme's buttons.
# KBFX uses the normal.png/hover.png/pressed.png
# that are in the theme's folder by default.
# So we recommend NOT to use the below three
# properties!
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
# Hide User Name
DisableUserName=false
# Top Bar Height
Height=95
# THE PROPERTIES BELOW ARE NOT USED FOR NOW
# Top Bar Width
Width=504
# Top Bar Position X
X=0
# Top Bar Position Y
Y=0
[BottomBar]
# Bottom Bar Height
Height=38
# THE PROPERTIES BELOW ARE NOT USED FOR NOW
# 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 Position X
X=0
# List Box Position Y
Y=95
# List Box Width
Width=132
# THE PROPERTIES BELOW ARE NOT USED FOR NOW
# List Box Height
Height=275
[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 Position X
X=132
# Item Position Y
Y=95
# Item Width
Width=240
# THE PROPERTIES BELOW ARE NOT USED FOR NOW
# Item Height
Height=275
[ItemProperties]
# Comment Margin in Item
CommentMargin=66
# Icon Size in Item
IconSize=32
# No Comments in Item
NoComments=false
[ToolBar]
# THIS SECTION IS NOT USED FOR NOW
# Tool Bar Button Normal Size
ButtonNormalSize=48
# Tool Bar Button Pressed Size
ButtonPressedSize=48
[MainMenu]
# Main Menu Height
UserMenuHeight=513
# Main Menu Width
UserMenuWidth=504
# Contracted Menues
ContractedMenu=false
File version-2
--------------
This file is obligatory to exist, though it can be empty.
It is used to designate that the theme is in the new format and the
properties that are in the file are used in the KBFX Configurator for
showing the user some info about the theme.
The values in this file cannot be overwritten by the KBFX Configurator.
If existing, the file should contain information about the theme's version,
author's name, author's email and a homepage for the theme.
The unspecified fields are replaced with the string - "Not Specified".
The values bellow are self explanatory and are just an example:
[ThemeGeneral]
ThemeVersion=0.51
AuthorName=Nookie
AuthorEmail=nookie@no_spam.org
Homepage=http://www.kbfx.org
How to create a ".kbfxtheme" file for 0.4.9.3
=============================================
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(s) there should be an image named preview.png that serves
as a live preview of the look of the theme.
- in the theme(s) folder(s) there should be a file named version-2
- 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 .
Another way to get a .pot file is to use the command "make package-messages"
just after the configuration of the compilation process is done.
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.