This page describes the process to build the Publican-driven Fedora docs site, referencing the Publican 4.0 User Guide.
The site is based on an EL6 machine, pulling packages from the el6-docs repo in Koji.
0. Set up an el6 machine
For this test, I set up a fresh el6.5 machine.
1. Connect repos
1.1 optional subchannel
Activate the optional subchannel in RHN. Instructions here
1.2 EPEL
$ sudo yum localinstall http://mirror.as24220.net/pub/epel/6/i386/epel-release-6-8.noarch.rpm
1.3 el6-docs
Create /etc/yum.repos.d/el6-docs.repo with the following contents:
[el6-docs] name=Packages for the Fedora docs site baseurl=http://kojipkgs.fedoraproject.org/repos/el6-docs/latest/x86_64/ enabled=1 gpgcheck=0
2. Install Publican
$ sudo yum install publican publican-common-web
PUG 7.2.1, step 3 NB: package names out-of-date
3. Configure the website
$ sudo vi /etc/publican-website.cfg
For this test, I set:
# where will the content be published to? toc_path: /var/www/html/docs # Where are the templates to build the TOCs? tmpl_path: /usr/share/publican/templates # Where is the database? db_file: /usr/share/publican/default.db title: "Fedora Documentation" search: <p/> dump: 1 dump_file: /var/www/html/docs/DUMP.xml web_style: 2
The publican-website.cfg file used in production should have the host: parameter set too.
PUG 7.2.1, step 4 NB: web_style parameter undocumented