[jbosstools-issues] [JBoss JIRA] Commented: (JBDS-241) Documentation plugins and context Help for all Tools components

[Anatoly Fedosik (JIRA)]

    [ http://jira.jboss.com/jira/browse/JBDS-241?page=comments#action_12394813 ] 
            
Anatoly Fedosik commented on JBDS-241:
--------------------------------------

The first results are:
There is no problem to use the Eclipse help system with our docbook html files (see attached image). It's ok with Eclipse 3.2.x version. 
I have an error in Eclipse 3.3.x version:

An error occured while processing the requested document: 
org.xml.sax.SAXParseException: The entity "nbsp" was referenced, but not declared.
	at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
	at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
	at org.eclipse.help.internal.dynamic.DocumentReader.read(DocumentReader.java:56)
	at org.eclipse.help.internal.dynamic.XMLProcessor.process(XMLProcessor.java:49)
	at org.eclipse.help.internal.xhtml.DynamicXHTMLProcessor.process(DynamicXHTMLProcessor.java:66)
	at org.eclipse.help.internal.webapp.servlet.DynamicXHTMLFilter$1.close(DynamicXHTMLFilter.java:79)
	at java.io.FilterOutputStream.close(Unknown Source)
	at org.eclipse.help.internal.webapp.servlet.FilterHTMLHeadAndBodyOutputStream

Xerces parser provokes an error. Notice that parser works only with html files. If I change the html extension on "jsp" it will work. Seems like parser needs an "xhtml", not simply "html". That is why I have "nbsp" error, <link> element is not closed etc...


> Documentation plugins and context Help for all Tools components
> ---------------------------------------------------------------
>
>                 Key: JBDS-241
>                 URL: http://jira.jboss.com/jira/browse/JBDS-241
>             Project: Developer Studio
>          Issue Type: Task
>          Components: documentation
>    Affects Versions: 1.0.0.GA
>            Reporter: Anatoly Fedosik
>         Assigned To: Anatoly Fedosik
>             Fix For: 1.0.1
>
>
> Max Rydahl Andersen wrote: 
> "This is a standard eclipse feature which allows us to bundle documentation in plugins and 
> with proper setup allow for F1 to show the relevant help.
> Using google gives alot of info, e.g. http://www.ibm.com/developerworks/opensource/library/os-echelp/
> What I hope is that we can use our docbooks directly since docbook has an eclipse compatible output format.
> Moving to jboss.org maven based docbook build would also be very relevant here i think".

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.jboss.com/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira