application/x-abiword
AbiWord
Fri Sep 6 15:56:46 2002
AbiWord Help: How To Tweak the Preferences in AbiWord
Copyright (C) 2002 David Chart

How To Tweak the Preferences

There are some properties of AbiWord that can be set in the preferences, but which do not yet have an entry in the Preferences dialog. To set these, you have to edit the preferences file by hand. On Linux and similar systems, this file is in the .AbiSuite folder in your home directory. This is a hidden directory; you will need to set your file manager to show such directories, or type the name by hand.

The file is called AbiWord.Profile, and you should open it in a text editor, not in AbiWord. When you do, you will notice that the comment information at the beginning of the file tells you not to edit the file by hand. If AbiWord came with any warranty, doing so would void the warranty. As it doesn't, you should simply make sure you save a copy of your preferences file before changing anything. Then, if everything goes wrong, you can replace the broken copy with the saved copy.

Most of the relevant options are in the Scheme sections. The first Scheme is the built-in scheme. It has name="_builtin_" as its first value. Do not bother editing this scheme, as it is reset whenever the application starts up. It provides default values, so that you only need to alter things when you want something different.

Your preferences are in the second scheme, with name="_custom_" as its first value. You should add lines to this scheme to set the additional preferences.

Useful values include:

DefaultSaveFormat=".abw" (Replace .abw with the suffix for any other file type to save as that file type by default.)

Various color preferences, allowing you to change the color that AbiWord uses for highlighting selections, and similar. These have a general format of ColorOption="xxxxxx", where xxxxxx is a hexadecimal RGB color code. The options available are:

ColorSelBackground: the color used to highlight selections.

ColorSquiggle: the color of the squiggle under mis-spelled words.

ColorHyperLink: the color of hyperlinks.

ColorRevision1: the color used to indicate the first revision. ColorRevision2 through 10 set the colors for the subsequent revisions.

ColorShowPara: the color used for rendering the hidden features revealed by Show Paragraphs.

ColorFieldOffset: the amount by which the background color of fields is offset from the normal background color. This value is subtracted from the value of the background color to get the final color for field backgrounds. A value of 000000 will make fields look like ordinary text. Something like 0c0c0c will make them darker, while something like f4f4f4 will make them brighter, if you have a dark background color.

ToolbarAppearance="icon" (Replace icon with both to get text labels on toolbar buttons. This makes the buttons significantly larger, and they may not fit on your screen.)

Geometry: The height and width values set the height and width of new AbiWord windows. These values are measured in pixels. Note that this section is after the _custom_ scheme.