<div>Hello all,<br><br>I have been trying to generate the Swift docs with docbook, but am having only partial success. If anyone happens to be familiar with this process, any help would be appreciated.<br><br>I have read the README and wiki link that Michael sent, but there are still a few issues. Here is an overview of everything I have done thus far:<br>
<br>After making some changes to the documentation, I created a symlink to docbooks. <br>I have formatting/docbooks pointing to /home/hategan/docbook/docbook-xsl.<br>I have tried all of the other docbook directories mentioned in the readme and wiki, but they all seem to behave the same<br>
Next when I attempted to run buildguides.sh I got an error message that fop/fop.sh was not found. <br>I found /home/hategan/fop.tar.gz and uncompressed it into the doc directory.<br>That got rid of the fop errors, but then I received "Error: JAVA_HOME is not defined correctly" <br>
Then I followed a maze of symlinks to what I believe is the correct JAVA_HOME on this system (<a href="http://login.ci.uchicago.edu">login.ci.uchicago.edu</a>) at /usr/lib/jvm/jre-1.4.2-gcj<br>Then I received the following errors:<br>
<br>[INFO] Using org.apache.xerces.parsers.SAXParser as SAX2 Parser<br>[Fatal Error] refentry.xsl:314:58: The string "--" is not permitted within comments.<br>[ERROR] javax.xml.transform.TransformerConfigurationException: javax.xml.transform.TransformerException: org.xml.sax.SAXParseException: The string "--" is not permitted within comments.<br>
make: *** [userguide.pdf] Error 2<br><br>I tracked refentry.xsl down and found it in /usr/share/apps/ksgmltools2/docbook/xsl/html/refentry.xsl. <br>I could try to modify the comments but I do not have permission. The error is preventing pdf files from being created.<br>
<br>After this section fails, it moves to create the PHP files. The PHP files get created, and works for the most part except for one nagging problem. <br>Next to each section number (1.1, 1.2, etc) a diamond with a question mark inside of it appears.<br>
I double checked that they do not exist in the xml file, only the php file<br>I think this is some strange character map issue. The PHP file sets the character set to UTF-8. When I change firefox to render the page in ISO8859-15 it works fine. <br>
I have tried changing the character set of the php file, and also tried setting the character set through .htaccess with no luck (the pages are being served out of my public_html directory for testing)<br><br>Any other ideas and suggestions would be appreciated.<br>
<br>Thanks!<br><br>Regards,<br>David<br><br><br></div><blockquote style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;" class="gmail_quote">Message: 2<br>
Date: Tue, 25 May 2010 19:18:57 -0500 (CDT)<br>
From: Michael Wilde <<a href="mailto:wilde@mcs.anl.gov">wilde@mcs.anl.gov</a>><br>
Subject: [Swift-devel] Notes on maintaining the swift web and docs<br>
To: Swift Devel <<a href="mailto:swift-devel@ci.uchicago.edu">swift-devel@ci.uchicago.edu</a>><br>
Message-ID: <5124436.99271274833137828.<div id=":9w" class="ii gt">JavaMail.root@zimbra><br>
Content-Type: text/plain; charset=utf-8<br>
<br>
To help David in creating a procedure for test copies of the Swift web 
and for generating the Swift docs with docbook, I placed notes gleaned 
from swift-devel at:<br>
<br>
  <a href="http://www.ci.uchicago.edu/wiki/bin/view/SWFT/MaintainingSwiftWebContent" target="_blank">http://www.ci.uchicago.edu/wiki/bin/view/SWFT/MaintainingSwiftWebContent</a><br>
<br>
If anyone has tips to refine those instructions, please update that page
 or post suggestions here for David to try and then post for general 
use.<br>
<br>
As suggested on that page, most of the notes should wind up in README 
files at www/ and docs/<br>
<br>
- Mike</div></blockquote>