The K Desktop Environment

Next Previous Table of Contents

3. Configuration

3.1 General Info

All configuration information of WebMaker is stored in two files: ~/.kde/share/config/webmakerrc and ~/.kde/share/config/webmaker-toolbarrc. The first is for all options except toolbar customizing and the second is for customization of toolbars. All options from webmakerrc can be configurable through the GUI.

3.2 General configuration

All ordinal configuration of WebMaker can be made from menu "Options", its submenus and appearing dialogs.

3.3 Toolbar customizing

All toolbars (except main toolbar) can be customized. This can be done by manual editing of file ~/.kde/share/config/webmaker-toolbarrc. This file has the following simple format:

[ToolbarN]
ButtonM=TextOrTagToInsert,ToolTip,ButtonPixmap.xpm,Action
ButtonM+1=TextOrTagToInsert,ToolTip,ButtonPixmap.xpm,Action
...

Explanation:

ToolbarN, ButtonM

- toolbar & button with real number, for example: Toolbar1, Button3;

TextOrTagToInsert

- text or tag to insert, for example: DIV align="center",  

ToolTip

- short text that appears when mouse is over button;

ButtonPixmap.xpm

- pixmap for button;

Action

- one of the following: insertTag (insert given text with rules applicable to this tag: with surrounding < and >, with closing tag where needed etc.), insertEntity (just insert text), editTag (like insertTag + opens edit dialog for given tag).

You can use --- as TextOrTagToInsert, in this case all other parameters can be ommited and separator is inserted into toolbar (ex.: Button8=---).

3.4 Configuration of filters

There is three types of filters: import, export and real filters (sections [Import Plugins], [Export Plugins] and [Filter Plugins] in webmakerrc). Every section has the following format:

NameN=MenuEntry
CommandN=CommandLine
NameN+1=MenuEntry
CommandN+1=CommandLine
...

Explanation:

NameN, CommandN

- indicate the number of filter;

MenuEntry

- text for menu entry;

CommandLine

- command line for starting a filter. Import and export filters can include %s - this will be replaced with the current filename.

Import filters must take a filename and put converted text to standard output; export - must take text from standard input and put it after conversion to the given filename; filters must take text from stdin, convert it and put into stdout.

You can use filters to open/save files in different formats and encodings, to print them and so on.
Example of import filter:

Name1=Import WinWord 97 File...
Command1=mswordview -o - %s
For additional examples you can look into supplied webmakerrc.

Next Previous Table of Contents