Chapter 1. Installing Publican

1.1. Installing Publican on Linux operating systems

Important — Availability in repositories

The procedures documented in this section assume that Publican and its various dependencies are available in repositories to which your system has access.

1.1.1. Installing Publican on Fedora

Open a terminal.
Change to the root user: su -
Run the following command to install the publican package and the publican-doc documentation package:
```
 yum install publican publican-doc
```

Several brand packages are available for use with Publican. Run the following command as the root user to install packages for building branded books:

 yum install publican-brand

Replace brand with, for example, redhat, fedora, jboss, ovirt, or gimp. Refer to Chapter 4, Branding for more information on branding.

1.1.2. Installing Publican on Red Hat Enterprise Linux 5

Important — Unsupported software

Publican is not part of the Red Hat Enterprise Linux distribution. Therefore, Red Hat does not offer support for Publican.

Important — Dependencies available only internally to Red Hat

Installing Publican on Red Hat Enterprise Linux 5 requires a number of dependencies that are presently available only in yum repositories that are internal to Red Hat.

Open a terminal.
Change to the root user: su -
Run the following command to install the publican package and the publican-doc documentation package:
```
 yum install publican publican-doc
```

Several brand packages are available for use with Publican. Run the following command as the root user to install packages for building branded books:

 yum install publican-brand

Replace brand with, for example, redhat, fedora, jboss, ovirt, or gimp. Refer to Chapter 4, Branding for more information on branding.

1.1.3. Installing Publican on Debian

Warning — Complete this procedure

Complete every step of this procedure. If you do not undo the changes that you make to the /etc/apt/sources.list file as described, your system might become unstable.

Publican is not available in the current stable version of Debian (version 5.0, "Lenny"), but is available in the current testing version ("Squeeze"). To install Publican on a computer that runs Debian, temporarily enable access to the squeeze repository. When you enable access to this repository, you allow your computer to install newer software and newer versions of existing software than what is available in the current stable version of Debian. However, not all of the software available in the testing repository has completed quality assurance testing yet. If you do not disable access to this repository after you install Publican, the next time that your system updates, it will replace software packages on your system with newer but possibly untested versions of those packages that it downloads from the testing repository.

Open a terminal.
Open your /etc/apt/sources.list file in a text editor. For example, to edit the file in gedit run:
```
sudo gedit /etc/apt/sources.list
```

Add the following line to the end of the file:

deb http://ftp.debian.org/debian/ squeeze main

Save the file and close the text editor.
Run the following command to update the list of packages available to your computer:
```
sudo apt-get update
```
Run the following command to install the publican package:
```
sudo apt-get install publican
```
Open your /etc/apt/sources.list file again, and delete the extra line that you added in this procedure.

Note that until the release of "Squeeze" as the stable version of Debian, you must manually enable and disable access to the testing repository as described in this procedure whenever a new version of Publican becomes available in the testing repository. You can find up-to-date information about the status of Publican for Debian at http://packages.debian.org/squeeze/publican, including the version number of Publican available in the repository (1.0 at the time of writing).

When "Squeeze" becomes the stable version of Debian, you will not need to enable or disable access to extra repositories to install Publican on systems that run that version of the operating system.

1.1.4. Installing Publican on Ubuntu

Warning — Complete this procedure

Complete every step of this procedure. If you do not undo the changes that you make to the /etc/apt/sources.list file as described, your system might become unstable.

Publican is not available in the current stable version of Ubuntu (version 9.10, "Karmic Koala"), but is available in the current testing version ("Lucid Lynx"). To install Publican on a computer that runs Ubuntu, temporarily enable access to the lucid repository. When you enable access to this repository, you allow your computer to install newer software and newer versions of existing software than what is available in the current stable version of Ubuntu. However, not all of the software available in the testing repository has completed quality assurance testing yet. If you do not disable access to this repository after you install Publican, the next time that your system updates, it will replace software packages on your system with newer but possibly untested versions of those packages that it downloads from the testing repository.

Open a terminal.
Open your /etc/apt/sources.list file in a text editor. For example, to edit the file in gedit run:
```
sudo gedit /etc/apt/sources.list
```

Add the following line to the end of the file:

deb http://archive.ubuntu.com/ubuntu/ lucid main restricted universe

Save the file and close the text editor.
Run the following command to update the list of packages available to your computer:
```
sudo apt-get update
```
Run the following command to install the fop package:
```
sudo apt-get install fop
```
Run the following command to install the publican package:
```
sudo apt-get install publican
```
Open your /etc/apt/sources.list file again, and delete the extra line that you added in this procedure.

Note that until the release of "Lucid Lynx" as the stable version of Ubuntu, you must manually enable and disable access to the testing repository as described in this procedure whenever a new version of Publican becomes available in the testing repository. You can find up-to-date information about the status of Publican for Ubuntu at http://packages.ubuntu.com/lucid/publican, including the version number of Publican available in the repository (1.0 at the time of writing).

When "Lucid Lynx" becomes the stable version of Ubuntu, you will not need to enable or disable access to extra repositories to install Publican on systems that run that version of the operating system.