Abiword Unix Administrator's Guide

v. 0.1.1

Larry Kollar, July 20, 1999

<mailto:lkollar@my-dejanews.com>

This manual is intended for Unix system administrators who have multiple users of AbiWord. Thus, the author has made no attempt to remove or explain jargon. This manual is currently incomplete, and applies to 0.7.x distributions of AbiWord. Please send any suggestions for further improvements to the author.

Installation

AbiWord is available in binary packages for a number of systems (mainly on i386 platforms). A source distribution is also available for many other systems, and for those who prefer to compile their software. The procedure in this section is intended for those compiling AbiWord from scratch.

Follow these steps:

1. Download the following tarballs from <http://www.abisource.com>:

- abi-0.7.x.tar.gz

- abidistfiles-0.7.x.tar.gz

- expat-0.7.x.tar.gz

- libwv-0.7.x.tar.gz

- unixfonts-0.7.x.tar.gz

2. Unpack all five tarballs in the same directory - that is, ls should look something like this:

abi-0.7.x/ abidistfiles/ expat/ unixfonts/ libwv

3. Compile AbiWord using the following commands:

cd abi-0.7.x

make UNIX_CAN_BUILD_STATIC=0

This will take at least 10 minutes, even on a faster machine. If your system is set up to build statically-linked applications, you can simply type "make."

For more build options, see "Build variables" later in this document.

4. If you want to install AbiWord in /usr/local/bin (or /usr/local), type "make install" and proceed to "Setting up a Default Profile." Otherwise, continue with step 5.

5. Designate a directory to contain the AbiWord files. The following steps in the procedure use the directory /opt/AbiSuite as an example.

6. Place AbiWord and its support files in appropriate places under its directory. The following is an example tree.

/opt/AbiSuite/

bin/AbiWord

lib/

fonts/(contents of unixfonts folder)

share/

help/

icons/

sample/

strings/

7. Proceed to "Setting up a default profile."

Setting up a default profile

With AbiWord 0.7.3 and later versions, a first-time user can simply start AbiWord and get a default profile with everything set up properly. This section applies mainly to older versions and possibly non-US versions.

Each AbiWord user needs a file called .AbiSuite/AbiWord.Profile in the home directory. Use a text editor to create a profile to use as a template in AbiWord's directory (in the example above, the "share" directory would be a logical location. The contents of the profile should be as follows:

<AbiPreferences app="AbiWord" ver="1.0">

<Select

scheme="normal"

autosaveprefs="1" />

<Scheme

name="normal"

SpellCheckDirectory="/usr/lib/ispell/"

SpellCheckWordList="american.hash"

UnixFontPath="/opt/AbiSuite/fonts"

AutoSpellCheck="1"

KeyBindings="default"

MenuLabelSet="EnUS"

MenuLayouts="Main"

RulerUnits="in"

StringSet="EnUS"

StringSetDirectory="AbiWord/strings"

ToolbarAppearance="icon"

ToolbarLabelSet="EnUS"

ToolbarLayouts="FileEditOps FormatOps"

/>

</AbiPreferences>

Change the value of each of the attributes as necessary. Especially make sure that the directories for UnixFontPath and SpellCheckDirectory are correct for your installation. Outside the US, make sure that the values of SpellCheckWordList, MenuLabelSet, and ToolbarLabelSet are reasonable for the locale.

Fonts

AbiSource makes the collection of GhostScript fonts available for use with AbiWord. More information about how AbiWord uses fonts is available in the unixfonts.txt file in /abi/docs directory.

Before running AbiWord, make sure that AbiWord's fonts are in the X11 font list. The following script add the font directory if needed, then launches AbiWord:

#!/bin/sh

# Assumes a default "make install"

grep abisuite `xset q` || xset fp+ /usr/share/abisuite/fonts

exec /usr/X11/bin/AbiWord

(need some info here - GhostScript uses .pfb files, Abi uses .pfa - also need to suggest edits to fonts.dir)

(how to add fonts that AW can recognize)

(how to combine all PostScript fonts into a single directory that all apps can access)

Build variables

The AbiWord Makefile script recognizes a number of different options. Some of the more useful ones are listed here.

'compile' or default target:

UNIX_CAN_BUILD_STATIC=[1,0]

If set to 0, make will not try to build a static version of the AbiSuite binaries. The default value is determined by your platform configuration makefile.

UNIX_CAN_BUILD_DYNAMIC=[1,0]

If set to 0, make will not try to build a dynamic version of the AbiSuite binaries. The default value is determined by your platform configuration makefile.

ABI_OPT_GNOME=[1,0]

If set to 1, make will compile AbiWord for use with the GNOME desktop. As of 0.7.7, this option is not set by default since we would like people to try out the GNOME support and let us know when it is complete.

XCFLAGS=[...]

The value of this variable is included in the compiler options for each target that produces an object file. The default value is empty. Usually this will not be needed.

XLDFLAGS=[...]

The value of this variable is tacked onto the link line for your compiler. The default value is empty. Usually this will not be needed.

ABI_OPT_DEBUG

This variable builds AbiWord in debug mode.

'install' target:

prefix=[...]

The value of this variable should be a directory under which the 'install' target will create AbiSuite/ and bin/ directories, under which the program and symbolic links to it will be respectively installed.