Mailing List Archive

Answered questions #1 & #3 myself. I'll adapt the forest-css skin to use a stylesheet that hides the stuff I don't want to see in the docs generated for Eclipse.

#2 is still up for grabs though!

Geoff

Geoffrey Longman
Intelligent Works Inc.


----- Original Message -----
From: "Geoff Longman" <glongman@intelligentworks.com>
To: <forrest-user@xml.apache.org>
Sent: Thursday, June 03, 2004 3:48 PM
Subject: newbie with some questions


Just downloaded Forrest and playing with it now. Evaluating Forrest as a tool to generate documentation for my Eclipse plug-in (http://spindle.sourceforge.net).

Here are some questions that I have not found answers for yet. Warning, my knowledge of XSL is minimal at best so if these questions are dumb, just say so!

1. Is it possible to build a version of a static site that has no tabs (or toc) and one that does? The docs delivered with the plugin would not need the tabs but the version on the Spindle website would need them.

2. How hard would it be to generate an eclipse specific toc file (a simple xml file in a format Eclipse understands) from the site.xml. this toc file would replace the tabs that normally appear in a Forrest generated site.

3. Is there a "skinning Forrest for dummies" link somewhere? Need to build a *very* simple skin that looks like the page at the following link: http://spindle.sourceforge.net/jettylauncher/

Thx,

Geoff

Geoffrey Longman
Intelligent Works Inc.

Geoff Longman wrote:
...
> 2. How hard would it be to generate an eclipse specific toc file (a simple xml file in a format Eclipse understands) from the site.xml. this toc file would replace the tabs that normally appear in a Forrest generated site.

Could you please elaborate more? I use eclipse myself but am not aware
of an eclipse specific toc file.

--
Nicola Ken Barozzi nicolaken@apache.org
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------

Sorry, I could describe it but it would make more sense if I give a link to the Eclipse docs themselves (one page that describes the format)

http://help.eclipse.org/help21/topic/org.eclipse.platform.doc.isv/guide/help_plugin_toc.htm

The file is used to build the entries in the "contents" window of the Eclipse help window.

Geoff


Geoffrey Longman
Intelligent Works Inc.

----- Original Message -----
From: "Nicola Ken Barozzi" <nicolaken@apache.org>
To: <forrest-user@xml.apache.org>
Sent: Friday, June 04, 2004 4:01 AM
Subject: Re: newbie with some questions


> Geoff Longman wrote:
> ...
> > 2. How hard would it be to generate an eclipse specific toc file (a simple xml file in a format Eclipse understands) from the site.xml. this toc file would replace the tabs that normally appear in a Forrest generated site.
>
> Could you please elaborate more? I use eclipse myself but am not aware
> of an eclipse specific toc file.
>
> --
> Nicola Ken Barozzi nicolaken@apache.org
> - verba volant, scripta manent -
> (discussions get forgotten, just code remains)
> ---------------------------------------------------------------------
>

Geoff Longman wrote:
> Sorry, I could describe it but it would make more sense if I give a link to the Eclipse docs themselves (one page that describes the format)
>
> http://help.eclipse.org/help21/topic/org.eclipse.platform.doc.isv/guide/help_plugin_toc.htm
>
> The file is used to build the entries in the "contents" window of the Eclipse help window.

Thanks for the info, much appreciated.

Well, there has already been requests for a Javahelp format and I had
done myself also winhelp format, and they are very similar to this.

IOW I would like to add this to the things to do along with the other
help formats... if you could add this to JIRA it would be nice. TIA

--
Nicola Ken Barozzi nicolaken@apache.org
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------

> IOW I would like to add this to the things to do along with the other
> help formats... if you could add this to JIRA it would be nice. TIA

Done. thanks

Geoff