You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fop-dev@xmlgraphics.apache.org by Vincent Hennebert <vi...@anyware-tech.com> on 2008/02/26 11:12:49 UTC

Compliance document

Hi,

What’s the status of the compliance.ihtml file we can find in the xdocs 
directory? It looks like this file was automatically generated, and 
indeed there are compliance2*.xsl files in the resources/stylesheets 
directory. But those stylesheets don’t seem to be referenced anywhere, 
and I can’t find the original xml file either, if any. Is this file now 
the original one? If there is anything to modify, should that be done in 
this file?

Thanks,
Vincent


-- 
Vincent Hennebert                            Anyware Technologies
http://people.apache.org/~vhennebert         http://www.anyware-tech.com
Apache FOP Committer                         FOP Development/Consulting

Re: Compliance document

Posted by Jeremias Maerki <de...@jeremias-maerki.ch>.
I can help with the release notes and changes. These are generated
through XSLT and probably just need a bit of tweaking in the sitemap.
The same probably applies to the compliance page. Maybe it was just a
small sitemap problem. I'm still for keeping the versioned docs. Maybe
you could upload what you've done to a branch (not to delay the release).
We can then try to fix the remaining issues.

On 27.02.2008 15:25:03 The Web Maestro wrote:
> Howdy,
> 
> On Tue, Feb 26, 2008 at 3:55 AM, Jeremias Maerki <de...@jeremias-maerki.ch> wrote:
> > On 26.02.2008 12:39:22 Vincent Hennebert wrote:
> >  > Jeremias Maerki wrote:
> >  > > Clay removed the XML file to work around a problem in Forrest in 2004. The
> >  > > stylesheets are indeed obsolete if the original file is deleted. You
> >  > > should change the ihtml if you need to do any changes.
> >  >
> >  > What was the problem?
> >
> >  Please look in the archives or wait until Clay can answer. I don't
> >  really remember.
> 
> The compliance transformation stylesheets were broken, we needed a
> mechanism to add information. The .ihtml document essentially gets
> passed through Forrest so you can easily edit the file with an HTML
> editor (WYSIWYG if you prefer!).
> 
> >  > Any chance that it could work with Forrest 0.8? If
> >  > yes, would it make sense to restore the xml file? If no, can we remove
> >  > the stylesheets? Why ihtml and not simply html?
> >
> >  I'd prefer working off the XML file but porting back all the changes
> >  into the XML since 2004 is going to be hard work!
> 
> I think of it as 'it would be nice' but it'll take a lot of work for
> IMHO not that much of a gain.
> 
> >  > That allows me to jump to the next subject: Clay, have you had any
> >  > chance to make progress on the transition to Forrest 0.8? If not (which
> >  > is ok), could you commit you current changes to a branch, so that other
> >  > people can take over the work? Thanks!
> >  >
> >  > Also, what's the status of plugging FOP Trunk into Forrest? From what
> >  > I could find in the Forrest archive it looks like it's almost done. Will
> >  > it be available in Forrest 0.8?
> >
> >  It's done. Everyone is happy. People from more than three projects were
> >  involved to make this happen (XML Graphics, Cocoon, Forrest). Ferdinand
> >  Soethe tells me there are some problems with 0.8 but trunk seems to work
> >  just fine now. Since we've used the 0.7 branch until now, we could just
> >  as well define that we use a particular trunk revision for the time
> >  being.
> 
> I have FOP built off of 0.8, but I have issues with the links to the
> generated files like release notes, changes, etc.[1] (any ideas about
> those links?). In addition I need to redo my refactoring of the web
> site[2]. That shouldn't take long, as I think I've got a pretty clear
> direction.
> 
> As for Forrest:Views, I've spent some time trying to get forrest:views
> to work, but it was largely unsuccessful. I don't believe it was ever
> finished, and I believe they're moving on to using a new system for
> managing 'themes' in the upcoming Forrest 0.90 release
> 
> http://forrest.apache.org/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.html.
> 
> In any event, I think I'll focus on making the site more usable. I'll
> use the ideas in the Refactoring website (was Re: Next release -
> when?) thread as a guide.
> 
> [1] (search for 'forrest.validate.xdocs.excludes') for the issues...
> http://people.apache.org/~clay/fop_refactored/
> 
> [2]
> http://www.nabble.com/Next-release---when--td14738961.html
> 
> Regards,
> 
> The Web Maestro
> -- 
> <th...@gmail.com> - <http://homepage.mac.com/webmaestro/>
> My religion is simple. My religion is kindness.
> - HH The 14th Dalai Lama of Tibet




Jeremias Maerki


Re: Compliance document

Posted by The Web Maestro <th...@gmail.com>.
Howdy,

On Tue, Feb 26, 2008 at 3:55 AM, Jeremias Maerki <de...@jeremias-maerki.ch> wrote:
> On 26.02.2008 12:39:22 Vincent Hennebert wrote:
>  > Jeremias Maerki wrote:
>  > > Clay removed the XML file to work around a problem in Forrest in 2004. The
>  > > stylesheets are indeed obsolete if the original file is deleted. You
>  > > should change the ihtml if you need to do any changes.
>  >
>  > What was the problem?
>
>  Please look in the archives or wait until Clay can answer. I don't
>  really remember.

The compliance transformation stylesheets were broken, we needed a
mechanism to add information. The .ihtml document essentially gets
passed through Forrest so you can easily edit the file with an HTML
editor (WYSIWYG if you prefer!).

>  > Any chance that it could work with Forrest 0.8? If
>  > yes, would it make sense to restore the xml file? If no, can we remove
>  > the stylesheets? Why ihtml and not simply html?
>
>  I'd prefer working off the XML file but porting back all the changes
>  into the XML since 2004 is going to be hard work!

I think of it as 'it would be nice' but it'll take a lot of work for
IMHO not that much of a gain.

>  > That allows me to jump to the next subject: Clay, have you had any
>  > chance to make progress on the transition to Forrest 0.8? If not (which
>  > is ok), could you commit you current changes to a branch, so that other
>  > people can take over the work? Thanks!
>  >
>  > Also, what's the status of plugging FOP Trunk into Forrest? From what
>  > I could find in the Forrest archive it looks like it's almost done. Will
>  > it be available in Forrest 0.8?
>
>  It's done. Everyone is happy. People from more than three projects were
>  involved to make this happen (XML Graphics, Cocoon, Forrest). Ferdinand
>  Soethe tells me there are some problems with 0.8 but trunk seems to work
>  just fine now. Since we've used the 0.7 branch until now, we could just
>  as well define that we use a particular trunk revision for the time
>  being.

I have FOP built off of 0.8, but I have issues with the links to the
generated files like release notes, changes, etc.[1] (any ideas about
those links?). In addition I need to redo my refactoring of the web
site[2]. That shouldn't take long, as I think I've got a pretty clear
direction.

As for Forrest:Views, I've spent some time trying to get forrest:views
to work, but it was largely unsuccessful. I don't believe it was ever
finished, and I believe they're moving on to using a new system for
managing 'themes' in the upcoming Forrest 0.90 release

http://forrest.apache.org/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.html.

In any event, I think I'll focus on making the site more usable. I'll
use the ideas in the Refactoring website (was Re: Next release -
when?) thread as a guide.

[1] (search for 'forrest.validate.xdocs.excludes') for the issues...
http://people.apache.org/~clay/fop_refactored/

[2]
http://www.nabble.com/Next-release---when--td14738961.html

Regards,

The Web Maestro
-- 
<th...@gmail.com> - <http://homepage.mac.com/webmaestro/>
My religion is simple. My religion is kindness.
- HH The 14th Dalai Lama of Tibet

Re: Compliance document

Posted by Jeremias Maerki <de...@jeremias-maerki.ch>.
On 26.02.2008 12:39:22 Vincent Hennebert wrote:
> Jeremias Maerki wrote:
> > Clay removed the XML file to work around a problem in Forrest in 2004. The
> > stylesheets are indeed obsolete if the original file is deleted. You
> > should change the ihtml if you need to do any changes.
> 
> What was the problem?

Please look in the archives or wait until Clay can answer. I don't
really remember.

> Any chance that it could work with Forrest 0.8? If 
> yes, would it make sense to restore the xml file? If no, can we remove 
> the stylesheets? Why ihtml and not simply html?

I'd prefer working off the XML file but porting back all the changes
into the XML since 2004 is going to be hard work!

> That allows me to jump to the next subject: Clay, have you had any 
> chance to make progress on the transition to Forrest 0.8? If not (which 
> is ok), could you commit you current changes to a branch, so that other 
> people can take over the work? Thanks!
> 
> Also, what’s the status of plugging FOP Trunk into Forrest? From what 
> I could find in the Forrest archive it looks like it’s almost done. Will 
> it be available in Forrest 0.8?

It's done. Everyone is happy. People from more than three projects were
involved to make this happen (XML Graphics, Cocoon, Forrest). Ferdinand
Soethe tells me there are some problems with 0.8 but trunk seems to work
just fine now. Since we've used the 0.7 branch until now, we could just
as well define that we use a particular trunk revision for the time
being.

> Thanks,
> Vincent
> 
> > 
> > On 26.02.2008 11:12:49 Vincent Hennebert wrote:
> >> Hi,
> >>
> >> What’s the status of the compliance.ihtml file we can find in the xdocs 
> >> directory? It looks like this file was automatically generated, and 
> >> indeed there are compliance2*.xsl files in the resources/stylesheets 
> >> directory. But those stylesheets don’t seem to be referenced anywhere, 
> >> and I can’t find the original xml file either, if any. Is this file now 
> >> the original one? If there is anything to modify, should that be done in 
> >> this file?
> >>
> >> Thanks,
> >> Vincent
> 
> 
> -- 
> Vincent Hennebert                            Anyware Technologies
> http://people.apache.org/~vhennebert         http://www.anyware-tech.com
> Apache FOP Committer                         FOP Development/Consulting




Jeremias Maerki


Re: Compliance document

Posted by Vincent Hennebert <vi...@anyware-tech.com>.
Jeremias Maerki wrote:
> Clay removed the XML file to work around a problem in Forrest in 2004. The
> stylesheets are indeed obsolete if the original file is deleted. You
> should change the ihtml if you need to do any changes.

What was the problem? Any chance that it could work with Forrest 0.8? If 
yes, would it make sense to restore the xml file? If no, can we remove 
the stylesheets? Why ihtml and not simply html?

That allows me to jump to the next subject: Clay, have you had any 
chance to make progress on the transition to Forrest 0.8? If not (which 
is ok), could you commit you current changes to a branch, so that other 
people can take over the work? Thanks!

Also, what’s the status of plugging FOP Trunk into Forrest? From what 
I could find in the Forrest archive it looks like it’s almost done. Will 
it be available in Forrest 0.8?

Thanks,
Vincent

> 
> On 26.02.2008 11:12:49 Vincent Hennebert wrote:
>> Hi,
>>
>> What’s the status of the compliance.ihtml file we can find in the xdocs 
>> directory? It looks like this file was automatically generated, and 
>> indeed there are compliance2*.xsl files in the resources/stylesheets 
>> directory. But those stylesheets don’t seem to be referenced anywhere, 
>> and I can’t find the original xml file either, if any. Is this file now 
>> the original one? If there is anything to modify, should that be done in 
>> this file?
>>
>> Thanks,
>> Vincent


-- 
Vincent Hennebert                            Anyware Technologies
http://people.apache.org/~vhennebert         http://www.anyware-tech.com
Apache FOP Committer                         FOP Development/Consulting

Re: Compliance document

Posted by Jeremias Maerki <de...@jeremias-maerki.ch>.
Clay removed the XML file to work around a problem in Forrest in 2004. The
stylesheets are indeed obsolete if the original file is deleted. You
should change the ihtml if you need to do any changes.

On 26.02.2008 11:12:49 Vincent Hennebert wrote:
> Hi,
> 
> What’s the status of the compliance.ihtml file we can find in the xdocs 
> directory? It looks like this file was automatically generated, and 
> indeed there are compliance2*.xsl files in the resources/stylesheets 
> directory. But those stylesheets don’t seem to be referenced anywhere, 
> and I can’t find the original xml file either, if any. Is this file now 
> the original one? If there is anything to modify, should that be done in 
> this file?
> 
> Thanks,
> Vincent
> 
> 
> -- 
> Vincent Hennebert                            Anyware Technologies
> http://people.apache.org/~vhennebert         http://www.anyware-tech.com
> Apache FOP Committer                         FOP Development/Consulting




Jeremias Maerki