From 5869aa7119dca906499ff23a11d26b821952d401 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sl=C3=A1vek=20Banko?= Date: Sun, 22 Sep 2013 19:11:05 +0200 Subject: Fix build handbook and translations This resolves Bug 1065 --- doc/AUTHORS | 0 doc/CMakeLists.txt | 26 +- doc/COPYING | 0 doc/ChangeLog | 0 doc/INSTALL | 0 doc/NEWS | 0 doc/README | 0 doc/TODO | 0 doc/common/CMakeLists.txt | 5 - doc/common/kbfx-about.jpg | Bin 25522 -> 0 bytes doc/common/kbfx-fonts.jpg | Bin 22863 -> 0 bytes doc/common/kbfx-layout.jpg | Bin 23403 -> 0 bytes doc/common/kbfx-maindescription.jpg | Bin 66520 -> 0 bytes doc/common/kbfx-plugins.jpg | Bin 18937 -> 0 bytes doc/common/kbfx-startbutton.jpg | Bin 30229 -> 0 bytes doc/common/kbfx-style.jpg | Bin 23408 -> 0 bytes doc/common/kbfx-themes.jpg | Bin 29524 -> 0 bytes doc/common/kbfx-tooltip.jpg | Bin 25521 -> 0 bytes doc/en/CMakeLists.txt | 14 +- doc/en/index.docbook | 2456 +++++++++++++++++++++++++++++++++++ doc/en/index.docbook.in | 2456 ----------------------------------- doc/en/kbfx-about.png | Bin 0 -> 159798 bytes doc/en/kbfx-fonts.png | Bin 0 -> 132607 bytes doc/en/kbfx-layout.png | Bin 0 -> 137647 bytes doc/en/kbfx-maindescription.png | Bin 0 -> 283941 bytes doc/en/kbfx-plugins.png | Bin 0 -> 101366 bytes doc/en/kbfx-startbutton.png | Bin 0 -> 176784 bytes doc/en/kbfx-style.png | Bin 0 -> 138988 bytes doc/en/kbfx-themes.png | Bin 0 -> 175126 bytes doc/en/kbfx-tooltip.png | Bin 0 -> 140620 bytes po/CMakeLists.txt | 13 +- 31 files changed, 2498 insertions(+), 2472 deletions(-) mode change 100755 => 100644 doc/AUTHORS mode change 100755 => 100644 doc/COPYING mode change 100755 => 100644 doc/ChangeLog mode change 100755 => 100644 doc/INSTALL mode change 100755 => 100644 doc/NEWS mode change 100755 => 100644 doc/README mode change 100755 => 100644 doc/TODO delete mode 100644 doc/common/CMakeLists.txt delete mode 100644 doc/common/kbfx-about.jpg delete mode 100644 doc/common/kbfx-fonts.jpg delete mode 100644 doc/common/kbfx-layout.jpg delete mode 100644 doc/common/kbfx-maindescription.jpg delete mode 100644 doc/common/kbfx-plugins.jpg delete mode 100644 doc/common/kbfx-startbutton.jpg delete mode 100644 doc/common/kbfx-style.jpg delete mode 100644 doc/common/kbfx-themes.jpg delete mode 100644 doc/common/kbfx-tooltip.jpg create mode 100644 doc/en/index.docbook delete mode 100644 doc/en/index.docbook.in create mode 100644 doc/en/kbfx-about.png create mode 100644 doc/en/kbfx-fonts.png create mode 100644 doc/en/kbfx-layout.png create mode 100644 doc/en/kbfx-maindescription.png create mode 100644 doc/en/kbfx-plugins.png create mode 100644 doc/en/kbfx-startbutton.png create mode 100644 doc/en/kbfx-style.png create mode 100644 doc/en/kbfx-themes.png create mode 100644 doc/en/kbfx-tooltip.png diff --git a/doc/AUTHORS b/doc/AUTHORS old mode 100755 new mode 100644 diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index bb975d8..14ae1a2 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -1,4 +1,18 @@ -SET(DOCFILES +################################################# +# +# (C) 2013 Slávek Banko +# slavek (DOT) banko (AT) axis.cz +# +# Improvements and feedback are welcome +# +# This file is released under GPL >= 2 +# +################################################# + +add_subdirectory( en ) + +INSTALL( + FILES AUTHORS # ChangeLog # COPYING @@ -11,10 +25,6 @@ SET(DOCFILES # NEWS # README # TODO - ) - -#add_subdirectory( common ) -#add_subdirectory( en ) - -INSTALL(FILES ${DOCFILES} - DESTINATION ${DOC_INSTALL_DIR}/kbfx) + DESTINATION + ${SHARE_INSTALL_PREFIX}/doc/kbfx +) diff --git a/doc/COPYING b/doc/COPYING old mode 100755 new mode 100644 diff --git a/doc/ChangeLog b/doc/ChangeLog old mode 100755 new mode 100644 diff --git a/doc/INSTALL b/doc/INSTALL old mode 100755 new mode 100644 diff --git a/doc/NEWS b/doc/NEWS old mode 100755 new mode 100644 diff --git a/doc/README b/doc/README old mode 100755 new mode 100644 diff --git a/doc/TODO b/doc/TODO old mode 100755 new mode 100644 diff --git a/doc/common/CMakeLists.txt b/doc/common/CMakeLists.txt deleted file mode 100644 index 7871a0c..0000000 --- a/doc/common/CMakeLists.txt +++ /dev/null @@ -1,5 +0,0 @@ -FILE(GLOB JPGFILES *.jpg ) -FILE(GLOB PNGFILES *.png ) - -INSTALL(FILES ${JPGFILES} ${PNGFILES} - DESTINATION ${HTML_INSTALL_DIR}/en/common) diff --git a/doc/common/kbfx-about.jpg b/doc/common/kbfx-about.jpg deleted file mode 100644 index a349e7f..0000000 Binary files a/doc/common/kbfx-about.jpg and /dev/null differ diff --git a/doc/common/kbfx-fonts.jpg b/doc/common/kbfx-fonts.jpg deleted file mode 100644 index 2dd0747..0000000 Binary files a/doc/common/kbfx-fonts.jpg and /dev/null differ diff --git a/doc/common/kbfx-layout.jpg b/doc/common/kbfx-layout.jpg deleted file mode 100644 index 9f8f65d..0000000 Binary files a/doc/common/kbfx-layout.jpg and /dev/null differ diff --git a/doc/common/kbfx-maindescription.jpg b/doc/common/kbfx-maindescription.jpg deleted file mode 100644 index 6ae740d..0000000 Binary files a/doc/common/kbfx-maindescription.jpg and /dev/null differ diff --git a/doc/common/kbfx-plugins.jpg b/doc/common/kbfx-plugins.jpg deleted file mode 100644 index e9e3466..0000000 Binary files a/doc/common/kbfx-plugins.jpg and /dev/null differ diff --git a/doc/common/kbfx-startbutton.jpg b/doc/common/kbfx-startbutton.jpg deleted file mode 100644 index e800577..0000000 Binary files a/doc/common/kbfx-startbutton.jpg and /dev/null differ diff --git a/doc/common/kbfx-style.jpg b/doc/common/kbfx-style.jpg deleted file mode 100644 index 434ccc0..0000000 Binary files a/doc/common/kbfx-style.jpg and /dev/null differ diff --git a/doc/common/kbfx-themes.jpg b/doc/common/kbfx-themes.jpg deleted file mode 100644 index 3d87682..0000000 Binary files a/doc/common/kbfx-themes.jpg and /dev/null differ diff --git a/doc/common/kbfx-tooltip.jpg b/doc/common/kbfx-tooltip.jpg deleted file mode 100644 index fc45e44..0000000 Binary files a/doc/common/kbfx-tooltip.jpg and /dev/null differ diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt index 3eff8c4..48e85c6 100644 --- a/doc/en/CMakeLists.txt +++ b/doc/en/CMakeLists.txt @@ -1,2 +1,12 @@ -KDE3_CREATE_HANDBOOK ( index.docbook ) -KDE3_INSTALL_HANDBOOK ( kbfxconfigapp ) +################################################# +# +# (C) 2013 Slávek Banko +# slavek (DOT) banko (AT) axis.cz +# +# Improvements and feedback are welcome +# +# This file is released under GPL >= 2 +# +################################################# + +tde_create_handbook( LANG en DESTINATION kbfxconfigapp ) diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 0000000..fefb36e --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,2456 @@ + +KBFX Configurator @APPLICATION_VERSION@"> + + + + + + + +]> + + + + + + + + + The &kbfxconfigapp; Handbook + + + + Siraj + + Razick + +
siraj@kdemail.net
+ + + + + + + PhobosK + +
phobosk@mail.kbfx.org
+ + + + + Mensur + Nookie + Zahirovic + +
nookie@mail.kbfx.org
+ + + + + Nathanael + + Gogniat + +
nathanael@mail.kbfx.org
+ + + + + + + + 2007 + KBFX Team + + + + + &FDLNotice; + + + + @APPLICATION_DATE@ + @APPLICATION_VERSION@ + + + + + + KBFX is an alternative to the classical K-Menu button and it's menu. + + + + It improves the user experience by enabling the user to set a bigger (and + thus more visible) start button and by finally replacing the Win95-like K-Menu. + But if you still want the old menu, because you're used to it, it is still + available as an option in KBFX. We recommend, however, that you give the Spinx + bar a try. + + + + + + + KDE + kbfxconfigapp + KBFX + Menu + Configurator + + + + + + + Introduction + + + KBFX is an alternative to the classical K-Menu button and it's menu. + It improves the user experience by enabling the user to set a bigger (and + thus more visible) start button and by finally replacing the Win95-like K-Menu. + But if you still want the old menu, because you're used to it, it is still + available as an option in KBFX. We recommend, however, that you give the Spinx + bar a try. + + +   + + + KBFX features + + + Main KBFX features: + + + + + + Using Plugins. + + + + + + Selecting an Application Group. + + + + + + Scroll up and down the application list. + + + + + + Type and locate an Application. + + + + + + Logout of the Desktop. + + + + + + Lock the Desktop. + + + + + + Launch the KBFX Configurator (the KBFX settings manager). + + + + + + Extra KBFX features: + + + + + + Double buffered Widgets to minimize flicker. + + + + + + Animated scroll bars. + + + + + + New Tooltip. + + + + + + New Control Manager. + + + + + + Drag & Drop Applications' Items support. + + + + + + + + KBFX History + + + KBFX was started on June 5th 2005 as a hobbyist project by Siraj Razick, born out of a spontaneous idea. + + + + The reason was that Siraj didn't like the old K-Menu, which was quite a clone of the old Win95 Start menu. So he started coding. + The first step provided merely the possibility to call the K-Menu via a button, that could have a different shape and size than the original K-Menu button, which has always been an icon of a square size. To change the default KBFX button, one still had to copy an image file to a certain location. + After the first post in mid-June 05, KBFX has spread rapidly and it was nice to see that until end of June, there were already a dozen posts on kde-look with buttons and builds. + + + + Mensur Zahirovic (called Nookie) joined Siraj on 5th of august, after Siraj met him on yahoo. Nookie is responsible for the Web-development and the Q&A. He also arranged the site www.kbfx.org, that replaces the previous site www.linuxlots.com/~siraj/plugin/kde. + + + + After that, things began to speed up. + Now KBFX is no longer just another button design for the K-Menu, but provides an alternative to it, that is in fact more sophisticated than the XP-Start menu. + + + + + KBFX Development + + + KBFX version 0.4.9.3 is a complete rewrite of the old KBFX code eliminating all the negative points of the previous versions. + + + + At the start we had a list of end requirements for version 0.4.9.3 and we developed each of the feature units, testing each and every class as it was developed. + Apart from unit testing, the quality assurance managers periodically checked the quality of the product and the new releases that were made to the KBFX source repository. + The Q&A always checked the product against the requirements that we had set to maximize quality. + This way of development helped us to discover tons of bugs and fix them instantly, and so we debut with a rather clean and bug free KBFX. + + + + It was really helpful to see many users around the world checking out the development release of KBFX from SVN, reporting and posting problems encountered and helping to add more stability and compatibility between distributions. + Because of this, we know the supported platforms even before KBFX is 0.4.9.3 is released. + + + + KBFX has been tested to work with all GCC3.x and GCC4.x compilers. + It has been tested on systems running the distributions of Gentoo, Debian, Ubuntu, Suse, Slackware, Mango, Mandrake, PCLinuxOS and Fedora core. + Unfortunately, compiling on FreeBSD systems is yet to be tested, but we plan to port KBFX to FreeBSD and PcBSD. + + + + + KBFX Concepts + + + The KBFX Spinx Menu does not try to copy the WinXP Start menu. + It is based on a different approach and concept. + Following, the concepts of the traditional hierarchical structure and the new, flat indexed menu are described and compared, although the new menu structure is quite intuitive. + + +   + + + Hierarchical (Traditional) menu structure + + + The KDE K-Menu is a good example of a flat hierarchical menu. + It organizes application shortcuts in a tree link structure, where it can expand and open a submenu, with entries displayed based on some logical order. + This order may be task oriented, type oriented or just ordered alphabetically. + To find and launch an application, the user needs to navigate through the submenus, until he reaches the leaf (leaf node). + This approach is a direct adoption of the Microsoft Windows Start Menu. They introduced it with Windows 95/98/ME/NT/2000. This was certainly a huge usability advantage compared to the Windows 3.1 System with the program manager, but a lot has changed since these days. The Windows XP Start Menu is still based on this concept, although it is enhanced by the functionalities to pin applications to the left column and the automatically pinned most used applications. + But still, a user must move the mouse over the half screen, if his menu has many submenus with other submenus, and the application is not one of his most used or pinned applications. + + +   + + + + + Flat indexed menu structure + + + The KBFX Spinx Menu uses a different approach – the flat indexed menu. + With this type of menu it's very easy to navigate. + On the left hand side, you are given the application categories. + They can be task oriented or type oriented. On the right (middle) side of the menu, there are all the available applications listed that belong to the activated category. + The advantage is evident - the menu reduces the mouse paths, so you can locate your applications very fast. The user sees all the categories at a glance and he can pick it without having to travel along a long list until he finds the end leaf. + The speed of use is further enhanced by moving the most used and recently used applications on the top index, so that the most used applications are just one click away. + + + + + + + + Using KBFX + +   + + + Starting KBFX + + + The KBFX menu button is a starting point for the menu. It first has to be added to a kicker's panel. + To add the KBFX Menu to a panel, proceed as following: + + + + + + Right-click on the kicker's 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 skin the KBFX Start Button see this section. + + + + + + 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. + + + + + + + Using the Spinx Menu + + + Here's a screenshot of the Spinx Menu + + + + + + + + Screenshot of the the Spinx Menu + + + + + + The Spinx Menu looks (depending on the skin) like the picture above. + It consists of following elements. + + + + The picture in the upper left corner is your "dude" icon. + + + + + + In the left and right columns of the menu, the plugins are displayed. + Click on a plugin section, to display it's content in the middle column. + If you click on the plugin's name you can contract its sections. + + + + + + In the middle column of the menu, the menu items of the selected plugin section are displayed. + Usually the menu items are grouped. + If you click on a group it will contract. + There is an option in the KBFX Configurator to start all these groups contracted. + + + You CAN drag and drop items FROM this part of the menu to your desktop, konqueror etc. + + + You CAN NOT drag and drop items TO this part of the menu. + + + + + + The arrows above and below the middle column are used to scroll up and down in the middle column. + + + + + + In the upper right corner, you find a search field, which can help you finding a menu item. + It is "search as you tipe" field. + If you want to clear the search (or the search term) double click on the search icon in the field. + If you type a command in the search field and press "Enter", the command will be started as if it has been typed in the "Run command..." dialog of K-menu. + + + + + + In the lower right corner, you find two buttons, one to log out and one to lock the desktop. + + + + + + + + How to configure KBFX + + + Here you can find how to use the KBFX Configurator. + + +   + + + <anchor id="kbfx_themes" />Choose the KBFX Theme + + + Here's a screenshot of the Themes Section of the KBFX Configurator + + + + + + + + Screenshot of the Themes Section of the KBFX Configurator + + + + + + + + Select default folder + + + Here you can select the folder in which you keep all your themes. + + + + + + + + The other options are self explanatory and have tooltips that can help you use them. + + +   + + + + <anchor id="kbfx_button" />Skin the KBFX Button + + + Here's a screenshot of the Start Button Section of the KBFX Configurator + + + + + + + + Screenshot of the Start Button Section of the KBFX Configurator + + + + + + Here you can skin the button. There are three fields to fill. + The first field is the field for the path to the picture for the default button state (Normal). + The second field is for the picture of the button in pressed state (Pressed). + The third field is for the picture of the button in hovered state (Hover). + You can drag and drop images on the "Preview" place or on the file selector field of each button. + The selected design can be seen in the preview area. Press the "Apply" button to apply the selected look. + + + + + You can skin the KBFX Start Button by selecting three images (Normal, Pressed and Hover) in any file manager, drag and drop them on the KBFX Start Button. In order this to work the images have to have in their name the respective state of the button, i.e. "pressed", "hover" or "normal". Here is an example of valid file names for the button: my_hover_dButton.png, my_pressed_dButton.png, my_normal_dButton.png . + + + + + + Button Fade Transition Effect + + + This allows you to turn ON or OFF the fade effect for the KBFX button. This effect makes transitions between the three images (normal, hover, pressed) animated. Here you can set the time for the fade effect in msec. This time should be greater than 20 msec and less than 1000 msec. If set to 0 the effect will be disabled. + + + + + +   + + + The other options are self explanatory and have tooltips that can help you use them. + + +   + + + + <anchor id="kbfx_fonts" />Set the Fonts of the KBFX Theme + + + Here's a screenshot of the Fonts Section of the KBFX Configurator + + + + + + + + Screenshot of the Fonts Section of the KBFX Configurator + + + + + + Here you can configure all the fonts (colors, points, style etc.) for the current theme. + + + + + + EXPORT KBFXFONTRC FILE + + + Use this button to export your font settings in order to share it with other KBFX users or if you want to create a theme by yourself (how to create your own themes you can find out in this chapter). + + + + + + + + + In the font settings for the tooltip only "Font Name" and "Font Color" are used. + The other settings like "Font Style" and "Font size" are not used. + This may change in future versions. + + + + + The other options are self explanatory and have tooltips that can help you use them. + + +   + + + + <anchor id="kbfx_layout" />Set the Layout of the KBFX Theme + + + Here's a screenshot of the Layout Section of the KBFX Configurator + + + + + + + + Screenshot of the Layout Section of the KBFX Configurator + + + + + + Here you can configure all the layout options for the current theme. + + + + + + Make it 2/3 Panels buttons + + + Use these buttons to force KBFX to auto-configure the current theme to the listed layouts. + + + + + + EXPORT KBFXLAYOUTRC FILE + + + Use this button to export your layout settings in order to share it with other KBFX users or if you want to create a theme by yourself (how to create your own themes you can find out in this chapter). + + + + + + + + The other options are self explanatory and have tooltips that can help you use them. + + +   + + + + <anchor id="kbfx_plugins" />Set the KBFX Plugins + + + Here's a screenshot of the Plugins Section of the KBFX Configurator + + + + + + + + Screenshot of the Plugins Section of the KBFX Configurator + + + + + + Here you can configure the plugins KBFX will use and where to place them - on the left or on the right column of the KBFX Menu. + + + + The other options are self explanatory and have tooltips that can help you use them. + + +   + + + + <anchor id="kbfx_tooltip" />Set the Tooltip of the KBFX Button + + + Here's a screenshot of the Tooltip Section of the KBFX Configurator + + + + + + + + Screenshot of the Tooltip Section of the KBFX Configurator + + + + + + Here you can select if the tooltip is on or off and if the tooltip animation is on or off. + In the field for the Tooltip text, you can change the tooltip text that will appear in the Tooltip balloon. + + + + The other options are self explanatory and have tooltips that can help you use them. + + +   + + + + <anchor id="kbfx_style" />Set the Style of the KBFX Menu + + + Here's a screenshot of the Menu Style Section of the KBFX Configurator + + + + + + + + Screenshot of the Menu Style Section of the KBFX Configurator + + + + + + Here you can select, whether you want to work with the KBFX SPINX or the KDE MENU. + You just have to select the according option and press the "Apply" button. + + + + + + + Questions and Answers + + + + + + I have a question that is not covered by this documentation. Where I can get an answer? + + + + + + You can search the KBFX Forum for an answer OR you can ask your question in the forum. + + + + + + + + How can I contact you live? + + + + + + Come to the #kbfx channel on irc.freenode.org + + + + + + + + + Authors, Credits and License + + + &kbfxconfigapp; + + +   + + + Program Copyright (c) 2007 KBFX Team. + + +   + + + KBFX Team Managers: + + + + Siraj Razick siraj@kdemail.net + + + + + + PhobosK phobosk@kdemail.net + + + + + + Mensur Zahirovic nookie@mail.kbfx.org + + + + + + + Nathanael Gogniat nathanael@mail.kbfx.org + + + + + +   + + + Translations: + + + + Ferenc Stelcz ferenc@stelcz.hu - Hungary (HU) + + + + + + Divilinux divilinux@mail.kbfx.org - Italy (IT) + + + + + + Lexus lexus@mail.kbfx.org - Bulgaria (BG) + + + + + + PhobosK phobosk@kdemail.net - Bulgaria (BG) + + + + + + Monkey 9 monkey9@iae.nl - Netherlands (NL) + + + + + +   + + + Contributors and Credits: + + + + Darwin M. Bautista djclue917@gmail.com - 001.patch + + + + + + Revaline C. Regendra regendra_mail7@yahoo.com - + Author of the Launch button in the default "KBFX Silk TTP" theme. + + + + Copyright (c) 2006 Revaline^Studio + + + Revaline's Launch Menu v4.0 + + + + + + + Petri Damstén damu@iki.fi - Author of the KMFFontChooser class. + KMediaFactory + + + + + +   + + + Documentation Copyright (c) 2007 PhobosK phobosk@mail.kbfx.org + + +   + + + + &underFDL; + +   + + &underGPL; + + + + Installation + + + How to obtain KBFX + + + KBFX can be downloaded from SourceForge project pages. + + + + Sometimes development versions are uploaded in a separate space on SourceForge. + + + + The SVN address of the KBFX project is on the KDE SVN servers. + + + + + Requirements + + + In order to successfully compile and use KBFX, you need at least &kde; 3.4.X and also you need: + + + + + + Cmake - min. version 2.4.2 + + + + + + KDE3 and Qt3 sources - header files/devel packages + + + + + + Strigi -this package is OPTIONAL and is used for files inline search + + + + +   + + + You can find the most recent KBFX's list of changes at KDE SVN. + + + + + Compilation and Installation + + + + + Unpack the sources of KBFX with (x.y.z-XXXXXXXX represents the version of + the KBFX package, for example 0.4.9.3-20070117): + + +> tar xjvf kbfx-x.y.z-XXXXXXXX.tar.bz2 + + + + + + Change into the new directory: + + + +> cd kbfx-x.y.z-XXXXXXXX/ + + + + + + Start the configuration and the compilation using the command: + + + +> ./build.sh + + + + +   + + + Note for Mandriva < 2007 users: + + + The build script (by default) enables the use of menudrake + instead of kmenuedit. + If you want to prevent this behavior then pass ONE of these options to the build script: --menudrake-off OR -m + + + +   + + + Other building options: + + + + + --prefix OR -p to install KBFX in a different than the default folder (default is KDE install folder) for example: + +> ./build.sh -p /home/user + + + + + + + --strigi OR -s to enable Strigi support in KBFX (default is no Strigi support) + + + + + + --kde4 OR -k to build KBFX for KDE4 (default is for KDE3) + + + + + + --verbose OR -v to make the build script give more verbose information + + + + + + --nocheck OR -n to make the build script not to check if an old KBFX version is installed (default is to check) + + + + + + + + Using <command>checkinstall</command> + + + checkinstall is an application used to build distribution specific packages from sources. + + + + checkinstall DOES NOT work with cmake correctly up to this moment. :( + + + + It can be used with additional commands in order to "work properly". + Here is the procedure to follow as user (NOT as ROOT) in order to obtain + the necessary distribution package. + + + + + + + x.y.z-XXXXXXXX represents the version of the KBFX package, in this example it is: 0.4.9.3-20070117 + + + + + + In the example here the version string is replaced only in the checkinstall command but you have to do that everywhere the "x.y.z-XXXXXXXX" string is met. + + + + + + + + +> cd /tmp +> tar xjvf kbfx-x.y.z-XXXXXXXX.tar.bz2 +> cd kbfx-x.y.z-XXXXXXXX/ +> mkdir -p build/package +> cd build +> export DESTDIR=/tmp/kbfx-x.y.z-XXXXXXXX/build/package +> cmake ../ -DCMAKE_INSTALL_PREFIX=`tde-config --prefix` +> make install DESTDIR=/tmp/kbfx-x.y.z-XXXXXXXX/build/package +> find package/|sed s#^package/#./# > installed_files.txt +> cd package/ +> su +> checkinstall -nodoc --pkgname="kbfx" --pkgversion="0.4.9.3" \ +--pkgrelease="20070117" --exclude="/" --include=../installed_files.txt \ +--pakdir=/tmp/kbfx-0.4.9.3-20070117 sleep 1 + + + + When ready, "checkinstall" will show you the folder where the prepared package is, like in this Mandriva Example: + + + +********************************************************************** + +Done. The new package has been saved to + +/tmp/kbfx-0.4.9.3-20070117/kbfx-0.4.9.3-20070117.i386.rpm +You can install it in your system anytime using: + +rpm -i kbfx-0.4.9.3-20070117.i386.rpm + +********************************************************************** + + + + Of course the best way to make RPM packages is to use the "kbfx.spec" file provided in the KBFX sources like described bellow. + + + + + RPM Building Instructions (Mandriva, Fedora, Suse) + + + If you prefer manipulate a RPM, you can build it with the following commands: + + + + + + Build the RPM: + + + +> rpmbuild -tb kbfx-x.y.z-XXXXXXXX.tar.bz2 + + + or (for Mandriva) + + +> rpmbuild --rebuild kbfx-x.y.z-XXXXXXXX-mdv20070.src.rpm + + + or (for Fedora) + + +> rpmbuild --rebuild kbfx-x.y.z-XXXXXXXX-FCx.src.rpm + + + or (for SuSe) + + +> rpmbuild --rebuild kbfx-x.y.z-XXXXXXXX-suseXXX.src.rpm + + + + + + If succeed, you will found the rpm in /usr/src/rpm/RPMS (for Mandriva) or /usr/src/redhat/RPMS (for Fedora) or /usr/src/packages/RPMS (for Suse) according to the platform you have. + + + + + + Install the rpm as usually by: + + + +> rpm -Uvh kbfx-x.y.z-XXXXXXXX.rpm + + + + +   + + + Building RPM from KBFX SVN versions: + + + + + Follow these commands in the sources directory: + + +> ./build.sh + + + + Answer "N" to the question if you want to install KBFX. + + + +> cd build +> make dist + + + + + + A file "kbfx-x.y.z-XXXXXXXX.tar.bz2" will be created in the build directory. + + + + + + Proceed with the steps described in 1., 2., 3. + + + + + + + + Gentoo users + + + In order to use the strigi engine in KBFX you have to do these steps: + + + + + + Copy the "strigi-X.X.X.ebuild" and the "kbfx-0.4.9.X.ebuild" (from the sources directory) to your local portage tree as needed OR use the "kbfx-0.4.9.X-portage-overlay.tar.bz2" + + + + + + Set the flag "strigi" for the kbfx ebuild + + + + + + Emerge "clucene" + + + + + + Emerge "kbfx" + + + + +   + + + There is a Layman overlay resource on the SourceForge SVN. + You can add it by this command: + + + +> layman -f -o https://kbfx.svn.sourceforge.net/svnroot/kbfx/layman/kbfx-overlay.xml \ + -a kbfx + + + + After you add the "kbfx" overlay you can use it as usual. + + + + + + SVN version + + + To download the latest development source, you need to go to KDE SVN and download it from there. The current SVN address of the repository is: svn://anonsvn.kde.org/home/kde/trunk/playground/base/kbfx_plasma + + + + Here are the instructions on how to get a copy of the SVN Repository: + + + + + + Install your distribution's package named "subversion" OR download and install it from subversion's homepage + + + + + + Create a folder where you will compile/install KBFX and enter in it. For example do this: + + + +> mkdir -p ~/usr/src/svn +> cd ~/usr/src/svn + + + + + + Checkout the SVN version of KBFX in this way and proceed as follows: + + + +> svn co svn://anonsvn.kde.org/home/kde/trunk/playground/base/kbfx_plasma +> cd kbfx_plasma + + + + + + Proceed with the compilation/installation of KBFX: + + + +> ./build.sh + + + + + + If you want always to have the latest version of KBFX you may leave the folder "~/usr/src/svn/kbfx_plasma" intact for future use. + When you want to update the source files of KBFX you just need to do svn up in this folder, delete the folder "~/usr/src/svn/kbfx_plasma/build" and start the ./build.sh script i.e: + + + +> cd ~/usr/src/svn/kbfx_plasma +> svn up +> rm -fR build +> ./build.sh + + + + + + + + How To + + + + <anchor id="howto-themes" />How to create themes for KBFX + + + 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 + + + + + + + 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" ! + + + + + +   + + + Images in KBFX + + + Here's a screenshot of all the images used in KBFX Menu + + + + + + + + Screenshot of all the images used in KBFX Menu + + + + + + This image is showing you all the images which are used in KBFX 0.4.9.3. + The most simple way to create a theme at this point is to take some of the images from the "default" theme and just change colors on some and see how that effects your menu. + + + + + DO NOT EVER CHANGE ANY IMAGE IN THE DEFAULT FOLDER! + + + + The images there are used as fallback when there is a missing image in your own theme. + We suggest rather to work with a copy folder of the default theme (the name of the folder containing your theme of course should be not "default" ;) ). + + + +   + + + + topbg.png + + + + + + + + + topbg.png + + + + + + This is an image that is at the top of the menu. + + + + Width = 504px and Height = 95px + + +   + + + + + dudebox.png + + + + + + + + + dudebox.png + + + + + + This is the background image where your personal image is displayed. + + + + Width = 95px and Height = 88px + + +   + + + + + menu_top_image_person.png + + + + + + + + + menu_top_image_person.png + + + + + + This image is used for theme's default personal image. + + + + Width = 48px and Height = 48px + + +   + + + + + find.png + + + + + + + + + find.png + + + + + + This is a small image displayed in the search field. + + + + Width = 22px and Height = 21px + + +   + + + + + rhstile.png + + + + + + + + + rhstile.png + + + + + + This is normal image displayed in categories. + + + + Width = 132px and Height = 23px + + +   + + + + + rhshovertile.png + + + + + + + + + rhshovertile.png + + + + + + This is a hover image for categories. Used as hover image for rhstile.png + + + + Width = 132px and Height = 23px + + +   + + + + + scrollnormal.png / scrollnormalbot.png + + + + + + + + + scrollnormal.png + + + + + + These images are used as top and bottom scrollbars. + + + + Width = 240px and Height = 10px + + +   + + + + + separator.png / indexseparator.png + + + + + + + + + separator.png + + + + + + These are the separator images which separate your different subcategories. + + + + Width = 240px and Height = 27px + + +   + + + + + tilenormal.png + + + + + + + + + tilenormal.png + + + + + + This is the normal image where your applications are showed. + + + + Width = 240px and Height = 46px + + +   + + + + + tilehover.png + + + + + + + + + tilehover.png + + + + + + This is the hover image where your applications are showed. + + + + Width = 240px and Height = 46px + + +   + + + + + listboxbg.png + + + + + + + + + listboxbg.png + + + + + + This is the background under the categories. + It can be viewed on description on both sides of the menu. + + + + Width = 108px and Height = 23px + + +   + + + + + middleboxbg.png + + + + + + + + + middleboxbg.png + + + + + + This is the background of the middle part of the menu. + + + + Width = 200px and Height = 270px + + +   + + + + + botbg.png + + + + + + + + + botbg.png + + + + + + This is the background image at the bottom of the menu. + + + + Width = 504px and Height = 38px + + +   + + + + + lock.png + + + + + + + + + lock.png + + + + + + This is the lock image. + + + + Width = 84px and Height = 38px + + +   + + + + + lockhover.png + + + + + + + + + lockhover.png + + + + + + This is the lock hover image. + + + + Width = 84px and Height = 38px + + +   + + + + + logout.png + + + + + + + + + logout.png + + + + + + This is the logout image. + + + + Width = 84px and Height = 38px + + +   + + + + + logouthover.png + + + + + + + + + logouthover.png + + + + + + This is the logout hover image. + + + + Width = 84px and Height = 38px + + +   + + + + + mask.png + + + + + + + + + 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 and Height = 513px + + +   + + + + + logo.png + + + + + + + + + logo.png + + + + + + This 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 = 100px and Height = 100px + + +   + + + + + preview.png + + + + + + + + + preview.png + + + + + + This 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 = 170px and Height = 205px + + +   + + + + + normal.png / hover.png / pressed.png + + + + + + + + + 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 our homepage here + + +   + + + + "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 in the folder ~/.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. + + + + + + + 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 + + + +   + + + + + + "version-2" file + + + + + + 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 + + +   + + + Now we wish you all good luck when creating themes. + We are looking forward to all your good looking themes out there for the KBFX! + + +   + + + + + 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(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 for KBFX + + + 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 and use KBabel or poEdit to make the translation. + + + + Next send the .po file to my mail phobosk@mail.kbfx.org. + + + + + 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. + + + +   + + + Thanks in advance for this help. + + + + + + Useful links + + + KBFX Homepage + + + + KBFX SourceForge project page + + + + KBFX Releases + + + + KBFX Forum + + + + KBFX Bugs + + +&documentation.index; + + + + diff --git a/doc/en/index.docbook.in b/doc/en/index.docbook.in deleted file mode 100644 index 1e2b01c..0000000 --- a/doc/en/index.docbook.in +++ /dev/null @@ -1,2456 +0,0 @@ - -KBFX Configurator @APPLICATION_VERSION@"> - - - - - - - -]> - - - - - - - - - The &kbfxconfigapp; Handbook - - - - Siraj - - Razick - -
siraj@kdemail.net
- - - - - - - PhobosK - -
phobosk@mail.kbfx.org
- - - - - Mensur - Nookie - Zahirovic - -
nookie@mail.kbfx.org
- - - - - Nathanael - - Gogniat - -
nathanael@mail.kbfx.org
- - - - - - - - 2007 - KBFX Team - - - - - &FDLNotice; - - - - @APPLICATION_DATE@ - @APPLICATION_VERSION@ - - - - - - KBFX is an alternative to the classical K-Menu button and it's menu. - - - - It improves the user experience by enabling the user to set a bigger (and - thus more visible) start button and by finally replacing the Win95-like K-Menu. - But if you still want the old menu, because you're used to it, it is still - available as an option in KBFX. We recommend, however, that you give the Spinx - bar a try. - - - - - - - KDE - kbfxconfigapp - KBFX - Menu - Configurator - - - - - - - Introduction - - - KBFX is an alternative to the classical K-Menu button and it's menu. - It improves the user experience by enabling the user to set a bigger (and - thus more visible) start button and by finally replacing the Win95-like K-Menu. - But if you still want the old menu, because you're used to it, it is still - available as an option in KBFX. We recommend, however, that you give the Spinx - bar a try. - - -   - - - KBFX features - - - Main KBFX features: - - - - - - Using Plugins. - - - - - - Selecting an Application Group. - - - - - - Scroll up and down the application list. - - - - - - Type and locate an Application. - - - - - - Logout of the Desktop. - - - - - - Lock the Desktop. - - - - - - Launch the KBFX Configurator (the KBFX settings manager). - - - - - - Extra KBFX features: - - - - - - Double buffered Widgets to minimize flicker. - - - - - - Animated scroll bars. - - - - - - New Tooltip. - - - - - - New Control Manager. - - - - - - Drag & Drop Applications' Items support. - - - - - - - - KBFX History - - - KBFX was started on June 5th 2005 as a hobbyist project by Siraj Razick, born out of a spontaneous idea. - - - - The reason was that Siraj didn't like the old K-Menu, which was quite a clone of the old Win95 Start menu. So he started coding. - The first step provided merely the possibility to call the K-Menu via a button, that could have a different shape and size than the original K-Menu button, which has always been an icon of a square size. To change the default KBFX button, one still had to copy an image file to a certain location. - After the first post in mid-June 05, KBFX has spread rapidly and it was nice to see that until end of June, there were already a dozen posts on kde-look with buttons and builds. - - - - Mensur Zahirovic (called Nookie) joined Siraj on 5th of august, after Siraj met him on yahoo. Nookie is responsible for the Web-development and the Q&A. He also arranged the site www.kbfx.org, that replaces the previous site www.linuxlots.com/~siraj/plugin/kde. - - - - After that, things began to speed up. - Now KBFX is no longer just another button design for the K-Menu, but provides an alternative to it, that is in fact more sophisticated than the XP-Start menu. - - - - - KBFX Development - - - KBFX version 0.4.9.3 is a complete rewrite of the old KBFX code eliminating all the negative points of the previous versions. - - - - At the start we had a list of end requirements for version 0.4.9.3 and we developed each of the feature units, testing each and every class as it was developed. - Apart from unit testing, the quality assurance managers periodically checked the quality of the product and the new releases that were made to the KBFX source repository. - The Q&A always checked the product against the requirements that we had set to maximize quality. - This way of development helped us to discover tons of bugs and fix them instantly, and so we debut with a rather clean and bug free KBFX. - - - - It was really helpful to see many users around the world checking out the development release of KBFX from SVN, reporting and posting problems encountered and helping to add more stability and compatibility between distributions. - Because of this, we know the supported platforms even before KBFX is 0.4.9.3 is released. - - - - KBFX has been tested to work with all GCC3.x and GCC4.x compilers. - It has been tested on systems running the distributions of Gentoo, Debian, Ubuntu, Suse, Slackware, Mango, Mandrake, PCLinuxOS and Fedora core. - Unfortunately, compiling on FreeBSD systems is yet to be tested, but we plan to port KBFX to FreeBSD and PcBSD. - - - - - KBFX Concepts - - - The KBFX Spinx Menu does not try to copy the WinXP Start menu. - It is based on a different approach and concept. - Following, the concepts of the traditional hierarchical structure and the new, flat indexed menu are described and compared, although the new menu structure is quite intuitive. - - -   - - - Hierarchical (Traditional) menu structure - - - The KDE K-Menu is a good example of a flat hierarchical menu. - It organizes application shortcuts in a tree link structure, where it can expand and open a submenu, with entries displayed based on some logical order. - This order may be task oriented, type oriented or just ordered alphabetically. - To find and launch an application, the user needs to navigate through the submenus, until he reaches the leaf (leaf node). - This approach is a direct adoption of the Microsoft Windows Start Menu. They introduced it with Windows 95/98/ME/NT/2000. This was certainly a huge usability advantage compared to the Windows 3.1 System with the program manager, but a lot has changed since these days. The Windows XP Start Menu is still based on this concept, although it is enhanced by the functionalities to pin applications to the left column and the automatically pinned most used applications. - But still, a user must move the mouse over the half screen, if his menu has many submenus with other submenus, and the application is not one of his most used or pinned applications. - - -   - - - - - Flat indexed menu structure - - - The KBFX Spinx Menu uses a different approach – the flat indexed menu. - With this type of menu it's very easy to navigate. - On the left hand side, you are given the application categories. - They can be task oriented or type oriented. On the right (middle) side of the menu, there are all the available applications listed that belong to the activated category. - The advantage is evident - the menu reduces the mouse paths, so you can locate your applications very fast. The user sees all the categories at a glance and he can pick it without having to travel along a long list until he finds the end leaf. - The speed of use is further enhanced by moving the most used and recently used applications on the top index, so that the most used applications are just one click away. - - - - - - - - Using KBFX - -   - - - Starting KBFX - - - The KBFX menu button is a starting point for the menu. It first has to be added to a kicker's panel. - To add the KBFX Menu to a panel, proceed as following: - - - - - - Right-click on the kicker's 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 skin the KBFX Start Button see this section. - - - - - - 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. - - - - - - - Using the Spinx Menu - - - Here's a screenshot of the Spinx Menu - - - - - - - - Screenshot of the the Spinx Menu - - - - - - The Spinx Menu looks (depending on the skin) like the picture above. - It consists of following elements. - - - - The picture in the upper left corner is your "dude" icon. - - - - - - In the left and right columns of the menu, the plugins are displayed. - Click on a plugin section, to display it's content in the middle column. - If you click on the plugin's name you can contract its sections. - - - - - - In the middle column of the menu, the menu items of the selected plugin section are displayed. - Usually the menu items are grouped. - If you click on a group it will contract. - There is an option in the KBFX Configurator to start all these groups contracted. - - - You CAN drag and drop items FROM this part of the menu to your desktop, konqueror etc. - - - You CAN NOT drag and drop items TO this part of the menu. - - - - - - The arrows above and below the middle column are used to scroll up and down in the middle column. - - - - - - In the upper right corner, you find a search field, which can help you finding a menu item. - It is "search as you tipe" field. - If you want to clear the search (or the search term) double click on the search icon in the field. - If you type a command in the search field and press "Enter", the command will be started as if it has been typed in the "Run command..." dialog of K-menu. - - - - - - In the lower right corner, you find two buttons, one to log out and one to lock the desktop. - - - - - - - - How to configure KBFX - - - Here you can find how to use the KBFX Configurator. - - -   - - - <anchor id="kbfx_themes" />Choose the KBFX Theme - - - Here's a screenshot of the Themes Section of the KBFX Configurator - - - - - - - - Screenshot of the Themes Section of the KBFX Configurator - - - - - - - - Select default folder - - - Here you can select the folder in which you keep all your themes. - - - - - - - - The other options are self explanatory and have tooltips that can help you use them. - - -   - - - - <anchor id="kbfx_button" />Skin the KBFX Button - - - Here's a screenshot of the Start Button Section of the KBFX Configurator - - - - - - - - Screenshot of the Start Button Section of the KBFX Configurator - - - - - - Here you can skin the button. There are three fields to fill. - The first field is the field for the path to the picture for the default button state (Normal). - The second field is for the picture of the button in pressed state (Pressed). - The third field is for the picture of the button in hovered state (Hover). - You can drag and drop images on the "Preview" place or on the file selector field of each button. - The selected design can be seen in the preview area. Press the "Apply" button to apply the selected look. - - - - - You can skin the KBFX Start Button by selecting three images (Normal, Pressed and Hover) in any file manager, drag and drop them on the KBFX Start Button. In order this to work the images have to have in their name the respective state of the button, i.e. "pressed", "hover" or "normal". Here is an example of valid file names for the button: my_hover_dButton.png, my_pressed_dButton.png, my_normal_dButton.png . - - - - - - Button Fade Transition Effect - - - This allows you to turn ON or OFF the fade effect for the KBFX button. This effect makes transitions between the three images (normal, hover, pressed) animated. Here you can set the time for the fade effect in msec. This time should be greater than 20 msec and less than 1000 msec. If set to 0 the effect will be disabled. - - - - - -   - - - The other options are self explanatory and have tooltips that can help you use them. - - -   - - - - <anchor id="kbfx_fonts" />Set the Fonts of the KBFX Theme - - - Here's a screenshot of the Fonts Section of the KBFX Configurator - - - - - - - - Screenshot of the Fonts Section of the KBFX Configurator - - - - - - Here you can configure all the fonts (colors, points, style etc.) for the current theme. - - - - - - EXPORT KBFXFONTRC FILE - - - Use this button to export your font settings in order to share it with other KBFX users or if you want to create a theme by yourself (how to create your own themes you can find out in this chapter). - - - - - - - - - In the font settings for the tooltip only "Font Name" and "Font Color" are used. - The other settings like "Font Style" and "Font size" are not used. - This may change in future versions. - - - - - The other options are self explanatory and have tooltips that can help you use them. - - -   - - - - <anchor id="kbfx_layout" />Set the Layout of the KBFX Theme - - - Here's a screenshot of the Layout Section of the KBFX Configurator - - - - - - - - Screenshot of the Layout Section of the KBFX Configurator - - - - - - Here you can configure all the layout options for the current theme. - - - - - - Make it 2/3 Panels buttons - - - Use these buttons to force KBFX to auto-configure the current theme to the listed layouts. - - - - - - EXPORT KBFXLAYOUTRC FILE - - - Use this button to export your layout settings in order to share it with other KBFX users or if you want to create a theme by yourself (how to create your own themes you can find out in this chapter). - - - - - - - - The other options are self explanatory and have tooltips that can help you use them. - - -   - - - - <anchor id="kbfx_plugins" />Set the KBFX Plugins - - - Here's a screenshot of the Plugins Section of the KBFX Configurator - - - - - - - - Screenshot of the Plugins Section of the KBFX Configurator - - - - - - Here you can configure the plugins KBFX will use and where to place them - on the left or on the right column of the KBFX Menu. - - - - The other options are self explanatory and have tooltips that can help you use them. - - -   - - - - <anchor id="kbfx_tooltip" />Set the Tooltip of the KBFX Button - - - Here's a screenshot of the Tooltip Section of the KBFX Configurator - - - - - - - - Screenshot of the Tooltip Section of the KBFX Configurator - - - - - - Here you can select if the tooltip is on or off and if the tooltip animation is on or off. - In the field for the Tooltip text, you can change the tooltip text that will appear in the Tooltip balloon. - - - - The other options are self explanatory and have tooltips that can help you use them. - - -   - - - - <anchor id="kbfx_style" />Set the Style of the KBFX Menu - - - Here's a screenshot of the Menu Style Section of the KBFX Configurator - - - - - - - - Screenshot of the Menu Style Section of the KBFX Configurator - - - - - - Here you can select, whether you want to work with the KBFX SPINX or the KDE MENU. - You just have to select the according option and press the "Apply" button. - - - - - - - Questions and Answers - - - - - - I have a question that is not covered by this documentation. Where I can get an answer? - - - - - - You can search the KBFX Forum for an answer OR you can ask your question in the forum. - - - - - - - - How can I contact you live? - - - - - - Come to the #kbfx channel on irc.freenode.org - - - - - - - - - Authors, Credits and License - - - &kbfxconfigapp; - - -   - - - Program Copyright (c) 2007 KBFX Team. - - -   - - - KBFX Team Managers: - - - - Siraj Razick siraj@kdemail.net - - - - - - PhobosK phobosk@kdemail.net - - - - - - Mensur Zahirovic nookie@mail.kbfx.org - - - - - - - Nathanael Gogniat nathanael@mail.kbfx.org - - - - - -   - - - Translations: - - - - Ferenc Stelcz ferenc@stelcz.hu - Hungary (HU) - - - - - - Divilinux divilinux@mail.kbfx.org - Italy (IT) - - - - - - Lexus lexus@mail.kbfx.org - Bulgaria (BG) - - - - - - PhobosK phobosk@kdemail.net - Bulgaria (BG) - - - - - - Monkey 9 monkey9@iae.nl - Netherlands (NL) - - - - - -   - - - Contributors and Credits: - - - - Darwin M. Bautista djclue917@gmail.com - 001.patch - - - - - - Revaline C. Regendra regendra_mail7@yahoo.com - - Author of the Launch button in the default "KBFX Silk TTP" theme. - - - - Copyright (c) 2006 Revaline^Studio - - - Revaline's Launch Menu v4.0 - - - - - - - Petri Damstén damu@iki.fi - Author of the KMFFontChooser class. - KMediaFactory - - - - - -   - - - Documentation Copyright (c) 2007 PhobosK phobosk@mail.kbfx.org - - -   - - - - &underFDL; - -   - - &underGPL; - - - - Installation - - - How to obtain KBFX - - - KBFX can be downloaded from SourceForge project pages. - - - - Sometimes development versions are uploaded in a separate space on SourceForge. - - - - The SVN address of the KBFX project is on the KDE SVN servers. - - - - - Requirements - - - In order to successfully compile and use KBFX, you need at least &kde; 3.4.X and also you need: - - - - - - Cmake - min. version 2.4.2 - - - - - - KDE3 and Qt3 sources - header files/devel packages - - - - - - Strigi -this package is OPTIONAL and is used for files inline search - - - - -   - - - You can find the most recent KBFX's list of changes at KDE SVN. - - - - - Compilation and Installation - - - - - Unpack the sources of KBFX with (x.y.z-XXXXXXXX represents the version of - the KBFX package, for example 0.4.9.3-20070117): - - -> tar xjvf kbfx-x.y.z-XXXXXXXX.tar.bz2 - - - - - - Change into the new directory: - - - -> cd kbfx-x.y.z-XXXXXXXX/ - - - - - - Start the configuration and the compilation using the command: - - - -> ./build.sh - - - - -   - - - Note for Mandriva < 2007 users: - - - The build script (by default) enables the use of menudrake - instead of kmenuedit. - If you want to prevent this behavior then pass ONE of these options to the build script: --menudrake-off OR -m - - - -   - - - Other building options: - - - - - --prefix OR -p to install KBFX in a different than the default folder (default is KDE install folder) for example: - -> ./build.sh -p /home/user - - - - - - - --strigi OR -s to enable Strigi support in KBFX (default is no Strigi support) - - - - - - --kde4 OR -k to build KBFX for KDE4 (default is for KDE3) - - - - - - --verbose OR -v to make the build script give more verbose information - - - - - - --nocheck OR -n to make the build script not to check if an old KBFX version is installed (default is to check) - - - - - - - - Using <command>checkinstall</command> - - - checkinstall is an application used to build distribution specific packages from sources. - - - - checkinstall DOES NOT work with cmake correctly up to this moment. :( - - - - It can be used with additional commands in order to "work properly". - Here is the procedure to follow as user (NOT as ROOT) in order to obtain - the necessary distribution package. - - - - - - - x.y.z-XXXXXXXX represents the version of the KBFX package, in this example it is: 0.4.9.3-20070117 - - - - - - In the example here the version string is replaced only in the checkinstall command but you have to do that everywhere the "x.y.z-XXXXXXXX" string is met. - - - - - - - - -> cd /tmp -> tar xjvf kbfx-x.y.z-XXXXXXXX.tar.bz2 -> cd kbfx-x.y.z-XXXXXXXX/ -> mkdir -p build/package -> cd build -> export DESTDIR=/tmp/kbfx-x.y.z-XXXXXXXX/build/package -> cmake ../ -DCMAKE_INSTALL_PREFIX=`tde-config --prefix` -> make install DESTDIR=/tmp/kbfx-x.y.z-XXXXXXXX/build/package -> find package/|sed s#^package/#./# > installed_files.txt -> cd package/ -> su -> checkinstall -nodoc --pkgname="kbfx" --pkgversion="0.4.9.3" \ ---pkgrelease="20070117" --exclude="/" --include=../installed_files.txt \ ---pakdir=/tmp/kbfx-0.4.9.3-20070117 sleep 1 - - - - When ready, "checkinstall" will show you the folder where the prepared package is, like in this Mandriva Example: - - - -********************************************************************** - -Done. The new package has been saved to - -/tmp/kbfx-0.4.9.3-20070117/kbfx-0.4.9.3-20070117.i386.rpm -You can install it in your system anytime using: - -rpm -i kbfx-0.4.9.3-20070117.i386.rpm - -********************************************************************** - - - - Of course the best way to make RPM packages is to use the "kbfx.spec" file provided in the KBFX sources like described bellow. - - - - - RPM Building Instructions (Mandriva, Fedora, Suse) - - - If you prefer manipulate a RPM, you can build it with the following commands: - - - - - - Build the RPM: - - - -> rpmbuild -tb kbfx-x.y.z-XXXXXXXX.tar.bz2 - - - or (for Mandriva) - - -> rpmbuild --rebuild kbfx-x.y.z-XXXXXXXX-mdv20070.src.rpm - - - or (for Fedora) - - -> rpmbuild --rebuild kbfx-x.y.z-XXXXXXXX-FCx.src.rpm - - - or (for SuSe) - - -> rpmbuild --rebuild kbfx-x.y.z-XXXXXXXX-suseXXX.src.rpm - - - - - - If succeed, you will found the rpm in /usr/src/rpm/RPMS (for Mandriva) or /usr/src/redhat/RPMS (for Fedora) or /usr/src/packages/RPMS (for Suse) according to the platform you have. - - - - - - Install the rpm as usually by: - - - -> rpm -Uvh kbfx-x.y.z-XXXXXXXX.rpm - - - - -   - - - Building RPM from KBFX SVN versions: - - - - - Follow these commands in the sources directory: - - -> ./build.sh - - - - Answer "N" to the question if you want to install KBFX. - - - -> cd build -> make dist - - - - - - A file "kbfx-x.y.z-XXXXXXXX.tar.bz2" will be created in the build directory. - - - - - - Proceed with the steps described in 1., 2., 3. - - - - - - - - Gentoo users - - - In order to use the strigi engine in KBFX you have to do these steps: - - - - - - Copy the "strigi-X.X.X.ebuild" and the "kbfx-0.4.9.X.ebuild" (from the sources directory) to your local portage tree as needed OR use the "kbfx-0.4.9.X-portage-overlay.tar.bz2" - - - - - - Set the flag "strigi" for the kbfx ebuild - - - - - - Emerge "clucene" - - - - - - Emerge "kbfx" - - - - -   - - - There is a Layman overlay resource on the SourceForge SVN. - You can add it by this command: - - - -> layman -f -o https://kbfx.svn.sourceforge.net/svnroot/kbfx/layman/kbfx-overlay.xml \ - -a kbfx - - - - After you add the "kbfx" overlay you can use it as usual. - - - - - - SVN version - - - To download the latest development source, you need to go to KDE SVN and download it from there. The current SVN address of the repository is: svn://anonsvn.kde.org/home/kde/trunk/playground/base/kbfx_plasma - - - - Here are the instructions on how to get a copy of the SVN Repository: - - - - - - Install your distribution's package named "subversion" OR download and install it from subversion's homepage - - - - - - Create a folder where you will compile/install KBFX and enter in it. For example do this: - - - -> mkdir -p ~/usr/src/svn -> cd ~/usr/src/svn - - - - - - Checkout the SVN version of KBFX in this way and proceed as follows: - - - -> svn co svn://anonsvn.kde.org/home/kde/trunk/playground/base/kbfx_plasma -> cd kbfx_plasma - - - - - - Proceed with the compilation/installation of KBFX: - - - -> ./build.sh - - - - - - If you want always to have the latest version of KBFX you may leave the folder "~/usr/src/svn/kbfx_plasma" intact for future use. - When you want to update the source files of KBFX you just need to do svn up in this folder, delete the folder "~/usr/src/svn/kbfx_plasma/build" and start the ./build.sh script i.e: - - - -> cd ~/usr/src/svn/kbfx_plasma -> svn up -> rm -fR build -> ./build.sh - - - - - - - - How To - - - - <anchor id="howto-themes" />How to create themes for KBFX - - - 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 - - - - - - - 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" ! - - - - - -   - - - Images in KBFX - - - Here's a screenshot of all the images used in KBFX Menu - - - - - - - - Screenshot of all the images used in KBFX Menu - - - - - - This image is showing you all the images which are used in KBFX 0.4.9.3. - The most simple way to create a theme at this point is to take some of the images from the "default" theme and just change colors on some and see how that effects your menu. - - - - - DO NOT EVER CHANGE ANY IMAGE IN THE DEFAULT FOLDER! - - - - The images there are used as fallback when there is a missing image in your own theme. - We suggest rather to work with a copy folder of the default theme (the name of the folder containing your theme of course should be not "default" ;) ). - - - -   - - - - topbg.png - - - - - - - - - topbg.png - - - - - - This is an image that is at the top of the menu. - - - - Width = 504px and Height = 95px - - -   - - - - - dudebox.png - - - - - - - - - dudebox.png - - - - - - This is the background image where your personal image is displayed. - - - - Width = 95px and Height = 88px - - -   - - - - - menu_top_image_person.png - - - - - - - - - menu_top_image_person.png - - - - - - This image is used for theme's default personal image. - - - - Width = 48px and Height = 48px - - -   - - - - - find.png - - - - - - - - - find.png - - - - - - This is a small image displayed in the search field. - - - - Width = 22px and Height = 21px - - -   - - - - - rhstile.png - - - - - - - - - rhstile.png - - - - - - This is normal image displayed in categories. - - - - Width = 132px and Height = 23px - - -   - - - - - rhshovertile.png - - - - - - - - - rhshovertile.png - - - - - - This is a hover image for categories. Used as hover image for rhstile.png - - - - Width = 132px and Height = 23px - - -   - - - - - scrollnormal.png / scrollnormalbot.png - - - - - - - - - scrollnormal.png - - - - - - These images are used as top and bottom scrollbars. - - - - Width = 240px and Height = 10px - - -   - - - - - separator.png / indexseparator.png - - - - - - - - - separator.png - - - - - - These are the separator images which separate your different subcategories. - - - - Width = 240px and Height = 27px - - -   - - - - - tilenormal.png - - - - - - - - - tilenormal.png - - - - - - This is the normal image where your applications are showed. - - - - Width = 240px and Height = 46px - - -   - - - - - tilehover.png - - - - - - - - - tilehover.png - - - - - - This is the hover image where your applications are showed. - - - - Width = 240px and Height = 46px - - -   - - - - - listboxbg.png - - - - - - - - - listboxbg.png - - - - - - This is the background under the categories. - It can be viewed on description on both sides of the menu. - - - - Width = 108px and Height = 23px - - -   - - - - - middleboxbg.png - - - - - - - - - middleboxbg.png - - - - - - This is the background of the middle part of the menu. - - - - Width = 200px and Height = 270px - - -   - - - - - botbg.png - - - - - - - - - botbg.png - - - - - - This is the background image at the bottom of the menu. - - - - Width = 504px and Height = 38px - - -   - - - - - lock.png - - - - - - - - - lock.png - - - - - - This is the lock image. - - - - Width = 84px and Height = 38px - - -   - - - - - lockhover.png - - - - - - - - - lockhover.png - - - - - - This is the lock hover image. - - - - Width = 84px and Height = 38px - - -   - - - - - logout.png - - - - - - - - - logout.png - - - - - - This is the logout image. - - - - Width = 84px and Height = 38px - - -   - - - - - logouthover.png - - - - - - - - - logouthover.png - - - - - - This is the logout hover image. - - - - Width = 84px and Height = 38px - - -   - - - - - mask.png - - - - - - - - - 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 and Height = 513px - - -   - - - - - logo.png - - - - - - - - - logo.png - - - - - - This 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 = 100px and Height = 100px - - -   - - - - - preview.png - - - - - - - - - preview.png - - - - - - This 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 = 170px and Height = 205px - - -   - - - - - normal.png / hover.png / pressed.png - - - - - - - - - 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 our homepage here - - -   - - - - "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 in the folder ~/.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. - - - - - - - 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 - - - -   - - - - - - "version-2" file - - - - - - 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 - - -   - - - Now we wish you all good luck when creating themes. - We are looking forward to all your good looking themes out there for the KBFX! - - -   - - - - - 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(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 for KBFX - - - 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 and use KBabel or poEdit to make the translation. - - - - Next send the .po file to my mail phobosk@mail.kbfx.org. - - - - - 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. - - - -   - - - Thanks in advance for this help. - - - - - - Useful links - - - KBFX Homepage - - - - KBFX SourceForge project page - - - - KBFX Releases - - - - KBFX Forum - - - - KBFX Bugs - - -&documentation.index; - - - - diff --git a/doc/en/kbfx-about.png b/doc/en/kbfx-about.png new file mode 100644 index 0000000..5e3d0c9 Binary files /dev/null and b/doc/en/kbfx-about.png differ diff --git a/doc/en/kbfx-fonts.png b/doc/en/kbfx-fonts.png new file mode 100644 index 0000000..e0fd559 Binary files /dev/null and b/doc/en/kbfx-fonts.png differ diff --git a/doc/en/kbfx-layout.png b/doc/en/kbfx-layout.png new file mode 100644 index 0000000..ef3f0b0 Binary files /dev/null and b/doc/en/kbfx-layout.png differ diff --git a/doc/en/kbfx-maindescription.png b/doc/en/kbfx-maindescription.png new file mode 100644 index 0000000..69bf9bc Binary files /dev/null and b/doc/en/kbfx-maindescription.png differ diff --git a/doc/en/kbfx-plugins.png b/doc/en/kbfx-plugins.png new file mode 100644 index 0000000..e093c06 Binary files /dev/null and b/doc/en/kbfx-plugins.png differ diff --git a/doc/en/kbfx-startbutton.png b/doc/en/kbfx-startbutton.png new file mode 100644 index 0000000..0a01d9b Binary files /dev/null and b/doc/en/kbfx-startbutton.png differ diff --git a/doc/en/kbfx-style.png b/doc/en/kbfx-style.png new file mode 100644 index 0000000..c8e639b Binary files /dev/null and b/doc/en/kbfx-style.png differ diff --git a/doc/en/kbfx-themes.png b/doc/en/kbfx-themes.png new file mode 100644 index 0000000..1907b6c Binary files /dev/null and b/doc/en/kbfx-themes.png differ diff --git a/doc/en/kbfx-tooltip.png b/doc/en/kbfx-tooltip.png new file mode 100644 index 0000000..62c5a4a Binary files /dev/null and b/doc/en/kbfx-tooltip.png differ diff --git a/po/CMakeLists.txt b/po/CMakeLists.txt index 7f31392..49627dd 100644 --- a/po/CMakeLists.txt +++ b/po/CMakeLists.txt @@ -1 +1,12 @@ -ADD_POFILES("kbfxconfigapp") +################################################# +# +# (C) 2013 Slávek Banko +# slavek (DOT) banko (AT) axis.cz +# +# Improvements and feedback are welcome +# +# This file is released under GPL >= 2 +# +################################################# + +tde_create_translation( LANG auto OUTPUT_NAME kbfxconfigapp ) -- cgit v1.2.1