[documentation-guide] Adjusted the "Installing Publican" section.

Jaromir Hradilek jhradile at fedoraproject.org
Sun Oct 2 21:32:16 UTC 2011


commit 0de7a0124723c6667c7e2f84b874af2f3c369b25
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Sun Oct 2 18:00:35 2011 +0200

    Adjusted the "Installing Publican" section.

 en-US/publican.xml |   13 ++++++++++---
 1 files changed, 10 insertions(+), 3 deletions(-)
---
diff --git a/en-US/publican.xml b/en-US/publican.xml
index 481f731..dd61e89 100644
--- a/en-US/publican.xml
+++ b/en-US/publican.xml
@@ -3,15 +3,22 @@
 <!ENTITY % BOOK_ENTITIES SYSTEM "Documentation_Guide.ent">
 %BOOK_ENTITIES;
 ]>
-<chapter id="chap-documentation_guide-publican">
+<chapter id="chap-publican">
   <title>Publican</title>
   <para>
     <application>Publican</application> is a program that creates the end product that our customers see.  The program creates html, html-single, PDF, and ePub formatted files from DocBook XML source code.  The files that Publican builds can then be uploaded to a website or packaged in an RPM.
   </para>
-  <section id="chap-documentation_guide-publican-installing">
+  <section id="sect-publican-installing">
     <title>Installing Publican</title>
     <para>
-      Installing <package>Publican</package> is quite easy to do.  Running <command>yum install publican-fedora</command> as root will install not only the Fedora brand, which will be explained later, but will bring in the <application>Publican</application> package and its dependencies.
+      To install <application>Publican</application> itself and the <systemitem>fedora</systemitem> brand that is used by the Fedora Documentation Project, type the following at a shell prompt as <systemitem class="username">root</systemitem>:
+    </para>
+    <synopsis><command>yum</command> <option>install</option> <option>publican</option> <option>publican-fedora</option></synopsis>
+    <para>
+      <application>Publican</application> uses modules called <firstterm>brands</firstterm> to add logos and color schemes to documents produced for a specific project, and thus ensures that the look of these documents is consistent. By default, only the <systemitem>common</systemitem> brand is installed with the <package>publican</package> package.
+    </para>
+    <para>
+      There are many brands in the Fedora repositories, such as <systemitem>oVirt</systemitem> (<package>publican-ovirt</package>), <systemitem>JBoss</systemitem> (<package>publican-jboss</package>), or <systemitem>genome</systemitem> (<package>publican-genome</package>). For a full list of available brands, refer to the <citetitle pubwork="book">Publican Users' Guide</citetitle>.
     </para>
   </section>
   <section id="chap-documentation_guide-publican-workflow">


More information about the docs-commits mailing list