You are viewing a plain text version of this content. The canonical link for it is here.
Posted to xml-commons-dev@xerces.apache.org by Michael Glavassevich <mr...@ca.ibm.com> on 2006/11/20 02:58:04 UTC
Problems building the resolver documentation
Hi all,
I tried doing a complete build of the resolver distribution yesterday and
got the following errors:
htmldocs:
[echo] Building docs for xml-commons-resolver ...
[java] (Location of error unknown)XSLT Error
(javax.xml.transform.TransformerConfigurationException):
javax.xml.transform.TransformerException: java.io.FileNotFoundException:
C:\eclipse3.2.0\eclipse\workspace\docbook\html\docbook.xsl (The system
cannot find the path specified)
[java] Java Result: -1
[java] Cannot find CatalogManager.properties
[java] (Location of error unknown)XSLT Error
(javax.xml.transform.TransformerConfigurationException):
javax.xml.transform.TransformerException: java.io.FileNotFoundException:
C:\eclipse3.2.0\eclipse\workspace\docbook\html\docbook.xsl (The system
cannot find the path specified)
[java] Java Result: -1
Obviously I'm missing docbook.xsl, though I can't seem to find it in SVN.
There's a comment within the 'htmldocs' target which says: "Note: The docs
are built in two ways until we stabilise the doc generation. Both ways
have system-specific pathnames, so both may bust on your system." Has
anyone managed to build the HTML docs successfully?
Thanks.
Michael Glavassevich
XML Parser Development
IBM Toronto Lab
E-mail: mrglavas@ca.ibm.com
E-mail: mrglavas@apache.org
Re: Problems building the resolver documentation
Posted by Michael Glavassevich <mr...@ca.ibm.com>.
David Crossley <cr...@apache.org> wrote on 11/20/2006 09:28:49 PM:
> Jeremias Maerki wrote:
> > The DocBook stylesheets don't seem to be in SVN, no. I have a local
> > install and when I adjust the path in src/documentation/sitemap.xmap,
it
> > works for me.
>
> I think that Norm recently tweaked the build system so that
> it doesn't need Forrest to build that Resolver article document
> when building the resolver distribution.
> See java/resolver.xml
>
> However it still needs the person running the build to install
> the DocBook XSL on their local system.
That's precisely what I did and it worked.
> See notes in the build file.
> Too big to add in to our SVN for such a limited use.
<snip/>
Michael Glavassevich
XML Parser Development
IBM Toronto Lab
E-mail: mrglavas@ca.ibm.com
E-mail: mrglavas@apache.org
Re: Problems building the resolver documentation
Posted by David Crossley <cr...@apache.org>.
Jeremias Maerki wrote:
> The DocBook stylesheets don't seem to be in SVN, no. I have a local
> install and when I adjust the path in src/documentation/sitemap.xmap, it
> works for me.
I think that Norm recently tweaked the build system so that
it doesn't need Forrest to build that Resolver article document
when building the resolver distribution.
See java/resolver.xml
However it still needs the person running the build to install
the DocBook XSL on their local system. See notes in the build file.
Too big to add in to our SVN for such a limited use.
> Another trick is to set the URL in sitemap.xmap to
> http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl
> (which loads it directly from the Internet) :-)
>
> Obviously, that's not optimal. I saw that in Forrest 0.8, they have a
> "Simplified Docbook" Plug-in, but since I'm still working with the 0.7
> branch I haven't tried it, yet. Maybe that would help and could even
> integrate the pages directly within the Forrest site structure. Maybe
> one of the Forrest people here (David?) has a good idea here. Adding the
> DocBook stylesheets to SVN could, of course, be an option but the XHTML
> variant alone uses up 1MB. Not sure what to do here.
I would not recommend doing that. That plugin is too basic.
That is why i set up the Forrest for xml-commons to not
use that.
-David
> DocBook Download:
> http://sourceforge.net/project/showfiles.php?group_id=21935#files
>
> On 20.11.2006 02:58:04 Michael Glavassevich wrote:
> > Hi all,
> >
> > I tried doing a complete build of the resolver distribution yesterday and
> > got the following errors:
> >
> > htmldocs:
> > [echo] Building docs for xml-commons-resolver ...
> > [java] (Location of error unknown)XSLT Error
> > (javax.xml.transform.TransformerConfigurationException):
> > javax.xml.transform.TransformerException: java.io.FileNotFoundException:
> > C:\eclipse3.2.0\eclipse\workspace\docbook\html\docbook.xsl (The system
> > cannot find the path specified)
> > [java] Java Result: -1
> > [java] Cannot find CatalogManager.properties
> > [java] (Location of error unknown)XSLT Error
> > (javax.xml.transform.TransformerConfigurationException):
> > javax.xml.transform.TransformerException: java.io.FileNotFoundException:
> > C:\eclipse3.2.0\eclipse\workspace\docbook\html\docbook.xsl (The system
> > cannot find the path specified)
> > [java] Java Result: -1
> >
> > Obviously I'm missing docbook.xsl, though I can't seem to find it in SVN.
> > There's a comment within the 'htmldocs' target which says: "Note: The docs
> > are built in two ways until we stabilise the doc generation. Both ways
> > have system-specific pathnames, so both may bust on your system." Has
> > anyone managed to build the HTML docs successfully?
> >
> > Thanks.
> >
> > Michael Glavassevich
> > XML Parser Development
> > IBM Toronto Lab
> > E-mail: mrglavas@ca.ibm.com
> > E-mail: mrglavas@apache.org
>
>
>
> Jeremias Maerki
Re: Problems building the resolver documentation
Posted by Jeremias Maerki <de...@jeremias-maerki.ch>.
The DocBook stylesheets don't seem to be in SVN, no. I have a local
install and when I adjust the path in src/documentation/sitemap.xmap, it
works for me.
Another trick is to set the URL in sitemap.xmap to
http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl
(which loads it directly from the Internet) :-)
Obviously, that's not optimal. I saw that in Forrest 0.8, they have a
"Simplified Docbook" Plug-in, but since I'm still working with the 0.7
branch I haven't tried it, yet. Maybe that would help and could even
integrate the pages directly within the Forrest site structure. Maybe
one of the Forrest people here (David?) has a good idea here. Adding the
DocBook stylesheets to SVN could, of course, be an option but the XHTML
variant alone uses up 1MB. Not sure what to do here.
DocBook Download:
http://sourceforge.net/project/showfiles.php?group_id=21935#files
On 20.11.2006 02:58:04 Michael Glavassevich wrote:
> Hi all,
>
> I tried doing a complete build of the resolver distribution yesterday and
> got the following errors:
>
> htmldocs:
> [echo] Building docs for xml-commons-resolver ...
> [java] (Location of error unknown)XSLT Error
> (javax.xml.transform.TransformerConfigurationException):
> javax.xml.transform.TransformerException: java.io.FileNotFoundException:
> C:\eclipse3.2.0\eclipse\workspace\docbook\html\docbook.xsl (The system
> cannot find the path specified)
> [java] Java Result: -1
> [java] Cannot find CatalogManager.properties
> [java] (Location of error unknown)XSLT Error
> (javax.xml.transform.TransformerConfigurationException):
> javax.xml.transform.TransformerException: java.io.FileNotFoundException:
> C:\eclipse3.2.0\eclipse\workspace\docbook\html\docbook.xsl (The system
> cannot find the path specified)
> [java] Java Result: -1
>
> Obviously I'm missing docbook.xsl, though I can't seem to find it in SVN.
> There's a comment within the 'htmldocs' target which says: "Note: The docs
> are built in two ways until we stabilise the doc generation. Both ways
> have system-specific pathnames, so both may bust on your system." Has
> anyone managed to build the HTML docs successfully?
>
> Thanks.
>
> Michael Glavassevich
> XML Parser Development
> IBM Toronto Lab
> E-mail: mrglavas@ca.ibm.com
> E-mail: mrglavas@apache.org
Jeremias Maerki
Re: Problems building the resolver documentation
Posted by Michael Glavassevich <mr...@ca.ibm.com>.
Hi Norm,
Norman Walsh <nd...@nwalsh.com> wrote on 11/22/2006 06:56:47 AM:
> / Michael Glavassevich <mr...@ca.ibm.com> was heard to say:
> | I tried doing a complete build of the resolver distribution yesterday
and
> | got the following errors:
>
> Sorry for the delay.
That's okay. I managed to figured it out with some tips from Jeremias.
Thanks for looking at this though.
> | htmldocs:
> | [echo] Building docs for xml-commons-resolver ...
> | [java] (Location of error unknown)XSLT Error
> | (javax.xml.transform.TransformerConfigurationException):
> | javax.xml.transform.TransformerException:
java.io.FileNotFoundException:
> | C:\eclipse3.2.0\eclipse\workspace\docbook\html\docbook.xsl (The system
> | cannot find the path specified)
>
> Hmm. Don't know where that came from. Using
>
> http://docbook.sf.net/release/xsl/current/html/docbook.xsl
>
> should work.
>
> | Obviously I'm missing docbook.xsl, though I can't seem to find it in
SVN.
> | There's a comment within the 'htmldocs' target which says: "Note: The
docs
> | are built in two ways until we stabilise the doc generation. Both ways
> | have system-specific pathnames, so both may bust on your system." Has
> | anyone managed to build the HTML docs successfully?
>
> Odd. I don't remember writing that comment either.
>
> Be seeing you,
> norm
>
> --
> Norman Walsh
> XML Standards Architect
> Sun Microsystems, Inc.
Michael Glavassevich
XML Parser Development
IBM Toronto Lab
E-mail: mrglavas@ca.ibm.com
E-mail: mrglavas@apache.org
Re: Problems building the resolver documentation
Posted by Norman Walsh <nd...@nwalsh.com>.
/ Michael Glavassevich <mr...@ca.ibm.com> was heard to say:
| I tried doing a complete build of the resolver distribution yesterday and
| got the following errors:
Sorry for the delay.
| htmldocs:
| [echo] Building docs for xml-commons-resolver ...
| [java] (Location of error unknown)XSLT Error
| (javax.xml.transform.TransformerConfigurationException):
| javax.xml.transform.TransformerException: java.io.FileNotFoundException:
| C:\eclipse3.2.0\eclipse\workspace\docbook\html\docbook.xsl (The system
| cannot find the path specified)
Hmm. Don't know where that came from. Using
http://docbook.sf.net/release/xsl/current/html/docbook.xsl
should work.
| Obviously I'm missing docbook.xsl, though I can't seem to find it in SVN.
| There's a comment within the 'htmldocs' target which says: "Note: The docs
| are built in two ways until we stabilise the doc generation. Both ways
| have system-specific pathnames, so both may bust on your system." Has
| anyone managed to build the HTML docs successfully?
Odd. I don't remember writing that comment either.
Be seeing you,
norm
--
Norman Walsh
XML Standards Architect
Sun Microsystems, Inc.