[documentation-guide] Updated the introductory part of the chapter about Publican.

jhradile jhradile at fedoraproject.org
Sat Mar 22 03:56:27 UTC 2014


commit 8635294de219bb7844d312ec2676957f3680b7a8
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Sat Mar 22 02:34:59 2014 +0100

    Updated the introductory part of the chapter about Publican.

 en-US/publican.xml |    7 +++----
 1 files changed, 3 insertions(+), 4 deletions(-)
---
diff --git a/en-US/publican.xml b/en-US/publican.xml
index 80f20a0..08fe235 100644
--- a/en-US/publican.xml
+++ b/en-US/publican.xml
@@ -5,15 +5,14 @@
 ]>
 <chapter id="chap-publican">
   <title>Publican</title>
-  <!-- jhradilek: The following text is not a final; don't worry, I'll fix it. -->
   <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.
+    <application>Publican</application> is an open-source publishing system for documentation authored in DocBook XML. It can be used to create and build individual articles and books, manage multiple book sets, or to maintain entire documentation websites. In addition, it can also be used to create RPM packages for easy distribution of documentation builds to other machines.
   </para>
   <para>
-    <application>Publican</application> is a command line interface (CLI) program that uses several commands for creating user files from DocBook XML source code.  <application>Publican</application> will take care of several tasks for you including building a new book or article, build the book in several formats, and create an RPM package that can be used to install the document locally onto a computer.
+    Publican produces high-quality documents in a number of commonly used file formats such as HTML, PDF, or EPUB. To ensure that all documents produced for a specific project have a consistent look, it uses so called <firstterm>brands</firstterm> to add logos, define color schemes, and set the overall visual style of the output files.
   </para>
   <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. At the top right of every HTML page, the Fedora brand includes a link back to the Fedora documentation site, from a graphic containing the English word "Documentation". We can localise this graphic so that the word "Documentation appears in the same language into which the document itself is translated.
+    The Fedora Documentation Project uses Publican to produce all documents located on the <ulink url="http://docs.fedoraproject.org/">Fedora Documentation</ulink> website.
   </para>
   <section id="sect-publican-installing">
     <title>Installing Publican</title>


More information about the docs-commits mailing list