Building the docs site

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
Line 5: Line 5:
 
==0. Set up an el6 machine==
 
==0. Set up an el6 machine==
  
For this test, I set up a fresh el6.5 machine.
+
For this test, I set up a fresh el6.5 Server machine and started httpd.
  
 
==1. Connect repos==
 
==1. Connect repos==
Line 54: Line 54:
  
 
[http://jfearn.fedorapeople.org/en-US/Publican/4.0/html/Users_Guide/chap-Publican-Users_Guide-Building_a_website_with_Publican.html#sect-Publican-Users_Guide-Creating_installing_and_updating_the_home_page-rpm PUG 7.2.2, step 3]
 
[http://jfearn.fedorapeople.org/en-US/Publican/4.0/html/Users_Guide/chap-Publican-Users_Guide-Building_a_website_with_Publican.html#sect-Publican-Users_Guide-Creating_installing_and_updating_the_home_page-rpm PUG 7.2.2, step 3]
 +
 +
==5. Install a document==
 +
I built and installed the ''Fedora 20 Release Notes''
 +
 +
$ sudo yum install Fedora-Release_Notes-20-web-en-US
 +
 +
==Done!==
 +
The site is visible at '''localhost/docs/'''

Revision as of 05:38, 27 March 2014

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.

Contents

0. Set up an el6 machine

For this test, I set up a fresh el6.5 Server machine and started httpd.

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

4. Install the homepage

$ sudo yum install Fedora_Documentation-web-home

PUG 7.2.2, step 3

5. Install a document

I built and installed the Fedora 20 Release Notes

$ sudo yum install Fedora-Release_Notes-20-web-en-US

Done!

The site is visible at localhost/docs/