4 Running ActBook

Once ActBook has been successfully installed, it can be used via the Evolution shell. Before you use it, though, you may have to create a local configuration folder in your home directory. If you have not used Evolution before installing ActBook, there is nothing you need to do - since ActBook installs its configuration files in the Evolution data directory, they will be copied to your home directory when it is initialized at the first start of Evolution. If, however, you have already used Evolution, and you already have a evolution/local/ directory in your home directory, you may need to copy the ActBook configuration data there by hand.

  1. Locate the Evolution default_user/ directory

    ActBook installs its configuration files under the default_user/ directory where Evolution was installed. (Note: installed, not built). Usually, the default_user/ directory a subdirectory of either /usr/X11R6/share/gnome/evolution/, or /usr/share/gnome/evolution/, or /usr/local/share/gnome/evolution/.

    Once you find the Evolution default_user/ directory, look for a subdirectory named local/ContACT/. This is where ActBook has installed its configuration files.

  2. Create your ContACT/ configuration directory

    To let Evolution know that you want to use ActBook, you need to create a local/ContACT/ subdirectory of the evolution/ in your home directory. You can do this using the command:

        % mkdir ~/evolution/local/ContACT
    
  3. Copy the ActBook configuration files

    Simply execute the command (one single long line):

        % cp /usr/X11R6/share/gnome/evolution/default_user/local/ContACT/* ~/evolution/local/ContACT/
    

    You may need to substitute the directory you located in the first step for /usr/X11R6/share/gnome/.

With this, the ActBook configuration files have been copied to your home directory. Now you can start Evolution and there should be a new folder named ContACT in its folder list. Clicking on it starts ActBook. You may use the Evolution folder context menu to create a shortcut for ActBook, so you can start it with a single click in the Evolution shortcut bar.

This, and other documents, can be downloaded from http://devel.ringlet.net/.

For questions about this documentation, e-mail <roam@ringlet.net>.