Red Hat Bugzilla – Bug 614259
Problems in Publican Website docs
Last modified: 2010-11-23 23:19:54 EST
Posted in Publican list by firstname.lastname@example.org:
I built a Publican website the other day, and took the notes below on the user docs.
Anyone else tried to follow them and noticed similar things?
Notes on section 6.2 in the Publican User Guide:
1. Should be a procedure, rather than an orderedlist.
2. Step 8 fails with "langs is a mandatory argument"
3. Adding --langs=en-US, fails with
"Beginning work on en-US
Cannot locate main XML file: 'JBoss_Enterprise_Application_Platform.xml' at /usr/bin/publican line 622"
- this is caused by editing Article_Info.xml in accordance with step 3
Instruction should be given:
mv en-US/Home_Page.xml en-US/<replaceable><title></replaceable>.xml
mv en-US/Home_Page.ent en-US/<replaceable><title></replaceable>.ent
Where <replaceable><title></replaceable> is the value you entered in Article_Info.xml
4. Step 4 covers two completely different things - web_home, and search. Should be split up
Thanks for these, Josh; I've just checked in a revised version of the chapter. I'm responding to some specific points below:
> 1. Should be a procedure, rather than an orderedlist.
It's always been a procedure, never an orderedlist.
> 2. Step 8 fails with "langs is a mandatory argument"
Fixed -- thanks
> 3. Adding --langs=en-US, fails with
> "Beginning work on en-US
> Cannot locate main XML file: 'JBoss_Enterprise_Application_Platform.xml' at
> /usr/bin/publican line 622"
This happened because you changed the contents of the <title> tag; the same thing would happen if you altered the <title> tag of any document built in Publican. The home page for a Publican website is just an <article> like any other -- the sole difference being the "web_home: 1" set in the publican.cfg file.
The original wording of step 3 did not list <title> among the tags that you could change. However, I've now modified both step 1 and step 3 to discuss the implications of the <title> tag in more detail, including how to prevent the title displaying on the home page.
> 4. Step 4 covers two completely different things - web_home, and search. Should
> be split up
Step 4 covers editing the publican.cfg file. Since all but one of the changes there are purely optional, I'm reluctant to split each possible change discussed into its own step. However, I've changed the presentation of the optional parameters to clarify them slightly (I hope).
Thanks again for helping make the documentation better!
*** Bug 638811 has been marked as a duplicate of this bug. ***
Found a minor typo in the path:
6.2.4. Installing, updating and removing documents
"Publican builds an RPM package and places it in the /tmp/rpms/noarch/"
- There was no /tmp/rpms directory
- Perhaps this ./tmp/rpm/noarch/ is the location?