Red Hat Bugzilla – Bug 727739
Publican Eclipse output doesn't work
Last modified: 2015-07-13 00:49:29 EDT
Description of problem:
Generated Eclipse plug-in output doesn't work. Placed "as is" into an eclipse plug-in directory forces the program to hang on start-up. With modification to adhere to eclipse standards (naming etc..), eclipse will start but parse errors will be shown when accessing the document in eclipse help (instead of content).
Version-Release number of selected component (if applicable):
Steps to Reproduce (Hanging):
1. Unzip attached eclipse.zip file and copy folder into your eclipse plugin directory
2. Start eclipse
3. Eclipse hangs
Steps to Reproduce (Error):
1. Unzip attached com.jboss.developer.studio.beginners.guide_1.0.0.zip file and copy folder into your eclipse plugin directory
2. Start eclipse
3. Eclipse opens
4. Go to Help -> Help Contents
5. Expand "Beginners Guide"
6. Click on any child link
7. Error appears on the right where the content should appear
Hanging or error (see above for further details).
Output folder named correctly with plugin.xml containing correct information in the "id" field and "version" field as it applies to Eclipse (see attached examples).
That the folder can be dropped into an eclipse plugin directory, eclipse started and the content able to be used - branded - as expected.
The attached files are as follows:
eclipse.zip -> eclipse output of the JBDS Beginners Guide, untouched after publican generation
com.jboss.developer.studio.beginners.guide_1.0.0.zip -> publican generated content modified to adhere to eclipse convention and links (in the toc.xml) that refer to anchors commented out for testing purposes
com.redhat.eap6.doc_1.0.0.zip -> output from internal program created by mcasperson that works as an eclipse plugin.
SVN location of book (anonymous check-out):
Created attachment 516432 [details]
Normal publican output
Created attachment 516433 [details]
Modified publican output
This page may be of assistance:
Nothing to do with Fedora's packaging of Publican: redirecting upstream.
The presence of the DOCTYPE line in xml and html output was causing eclipse to barf. Suppressed output of DOCTYPE for eclipse output.
Applied to branches/publican-2x and trunk.
Committed revision 1869.
Publican 2.7 has been release and includes a fix for this issue.