Rick Hillegas <[email protected]> writes: > I ran a quick experiment: I removed fo2html.xsl and verified that I > could build the frames html docs. Here are some solutions listed in > declining order of effort: > > 1) Remove fo2html.xsl. > > + Easy. > - We will lose the no-frames version of the html docs. I do use the > no-frames version when citing doc passages in posts to derby-user. > That is my only use for the no-frames version. Passage citations would > be a little more cumbersome, but I could live with that.
I never use the no-frames version myself, and wouldn't have a problem with this solution. But others may prefer that version, for all I know. > 2) Track down Nikolai Grigoriev and get him to open source this file > under Apache 2.0. He's listed as the author, not the copyright holder. The file header says the copyright belongs to RenderX, so they're probably the ones that would need to be contacted about this. There is contact information on http://www.renderx.com/ if someone wants to go down that road. > + Preserves the no-frames version of the docs. > + Relatively low effort on our part. > - Unbounded problem. We're not certain that we can track him down or > that he would agree to use the Apache 2.0 license. > > 3) Replace fo2html.xsl with an xsl transformation which we write ourselves. > > + Preserves the no-frames version of the docs. > - Probably outside the current skill sets of our current contributors. > > 4) Convert the docs to another source format. > > + Would be an opportunity to address our dissatisfactions with DITA, > including its accessibility problems and our inability to generate a > doc index. > - Big effort. > > Thanks, > -Rick -- Knut Anders
