Bug 587489

FYI the Fedora docbook-style-xsl package does not ship the eclipse XSL, so you will need to open a bug to get that changed before this can be addressed. 

Something like this is required:

$ cvs diff -u docbook-style-xsl.Makefile
Index: docbook-style-xsl.Makefile
===================================================================
RCS file: /cvs/pkgs/rpms/docbook-style-xsl/devel/docbook-style-xsl.Makefile,v
retrieving revision 1.8
diff -u -r1.8 docbook-style-xsl.Makefile
--- docbook-style-xsl.Makefile  23 Feb 2009 10:40:22 -0000      1.8
+++ docbook-style-xsl.Makefile  4 May 2010 04:42:46 -0000
@@ -6,11 +6,12 @@
 install: install-xsl install-img install-extensions install-misc install-epub
 
 install-xsl:
-       mkdir -p $(DESTDIR)/{common,fo,html,htmlhelp/doc,javahelp,lib,template,xhtml,xhtml-1_1,manpages,profiling,highlighting,roundtrip,website}
+       mkdir -p $(DESTDIR)/{common,eclipse,fo,html,htmlhelp/doc,javahelp,lib,template,xhtml,xhtml-1_1,manpages,profiling,highlighting,roundtrip,website}
        cp common/*.dtd $(DESTDIR)/common
        cp common/*.ent $(DESTDIR)/common
        cp common/*.xml $(DESTDIR)/common
        cp common/*.xsl $(DESTDIR)/common
+       cp eclipse/*.xsl $(DESTDIR)/eclipse
        cp fo/*.xml $(DESTDIR)/fo
        cp fo/*.xsl $(DESTDIR)/fo
        cp html/*.xml $(DESTDIR)/html

Thanks Jeff, I have opened a bug for docbook-style-xsl as you have suggested, with the fix you suggest. That bug is linked to this one.

Added eclipse xsl and handling code. Added 3 new config parameters:


ec_id:
     Eclipse plugin ID. Defaults to "$product.$docname"

ec_name:
     Eclipse plugin name. Defaults to "$product $docname"

ec_provider:
     Eclipse plugin provider. Defaults to "Publican-Publican::VERSION"



Example plugin.xml:

$ cat build/en-US/eclipse/plugin.xml 
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<plugin name="Publican Users_Guide" id="Publican.Users_Guide" version="1.0" provider-name="Publican-1.6.2">
  <extension point="org.eclipse.help.toc">
    <toc file="toc.xml" primary="true"/>
  </extension>
  <extension point="org.eclipse.help.index">
    <index file="index.xml"/>
  </extension>
</plugin>

You won't be able to test this unless you rebuild your docbook-style-xsl package.

confirmed that with docbook-style-xsl-1.75.2, publican 1.6.3.t150 builds a set of files for the eclipse target.

The plugin loads in Eclipse successfully. Branded styles are not present though.

I note that the JDocBook eclipse plugin includes the JBoss community styles:

<format>
  <formatName>eclipse</formatName>
  <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource>
  <finalName>index.html</finalName>
</format>

The majority of Eclipse Help (including Hibernate Developer Guide) have little or no styling.

Can we include the styles as it will add to the presentation or is styling not recommended in Eclipse Help to minimise the package size?

(In reply to comment #5)
> The plugin loads in Eclipse successfully. Branded styles are not present
> though.
> 
> I note that the JDocBook eclipse plugin includes the JBoss community styles:
> 
> <format>
>   <formatName>eclipse</formatName>
>  
> <stylesheetResource>classpath:/xslt/org/jboss/eclipse.xsl</stylesheetResource>
>   <finalName>index.html</finalName>
> </format>
> 
> The majority of Eclipse Help (including Hibernate Developer Guide) have little
> or no styling.
> 
> Can we include the styles as it will add to the presentation or is styling not
> recommended in Eclipse Help to minimise the package size?    

It was an oversight, fixes XSL to pull in branding elements.

verified that brands are applied to HTML files in version 1.6.2.t169

publican-1.6.3-0.fc13 has been submitted as an update for Fedora 13.
http://admin.fedoraproject.org/updates/publican-1.6.3-0.fc13

publican-1.6.3-0.fc12 has been submitted as an update for Fedora 12.
http://admin.fedoraproject.org/updates/publican-1.6.3-0.fc12

Thanks for all the hard work in making this happen :D

publican-1.6.3-0.fc12 has been pushed to the Fedora 12 testing repository.  If problems still persist, please make note of it in this bug report.
 If you want to test the update, you can install it with 
 su -c 'yum --enablerepo=updates-testing update publican'.  You can provide feedback for this update here: http://admin.fedoraproject.org/updates/publican-1.6.3-0.fc12

publican-1.6.3-0.fc13 has been pushed to the Fedora 13 testing repository.  If problems still persist, please make note of it in this bug report.
 If you want to test the update, you can install it with 
 su -c 'yum --enablerepo=updates-testing update publican'.  You can provide feedback for this update here: http://admin.fedoraproject.org/updates/publican-1.6.3-0.fc13

publican-1.6.3-0.fc13 has been pushed to the Fedora 13 stable repository.  If problems still persist, please make note of it in this bug report.

publican-1.6.3-0.fc12 has been pushed to the Fedora 12 stable repository.  If problems still persist, please make note of it in this bug report.