commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Juozas Baliuka" <bali...@centras.lt>
Subject Re: [math] documentation principles
Date Sat, 17 May 2003 15:55:15 GMT
I use beta-8 and I found some workarounds on windows today:
1) plugin.jelly changed to :
      <arg value="file:/${docsSrc}/navigation.xml"/>
      <arg value="-out"/>
      <arg value="${docsDest}/project.fo"/>
      <arg value="-xsl"/>
      <arg value="file:/${plugin.resources}/project2fo.xslt"/>
      <arg value="-param"/>
      <arg value="basePath"/>

2) changed line 187 in project2fo.xslt  to:
select="document( concat( $basePath, '/', substring-before( @href, '.' ),
'.xml' ) )/document"/>
3) Added documents I want to include to navigation.xml

This pluggin generates pdf, but without tables and doe's not handles <pre>
tag, is it some known workarounds or replacement
for <pre> tag ?
As I understand fop has  problems with tables and I will not fix it in
project2fo.xslt
And I am afraid maven will download snapshots with "autodection" way and
will break my workarounds next time, doe's not it ?


----- Original Message -----
From: <dion@multitask.com.au>
To: "Jakarta Commons Developers List" <commons-dev@jakarta.apache.org>
Sent: Saturday, May 17, 2003 2:15 PM
Subject: Re: [math] documentation principles


> Tables are a known problem, but the PDF gen should work still....which
> maven version is this?
>
> It works ok for me on 1.0-beta-10-SNAPSHOT.
> --
> dIon Gillard, Multitask Consulting
> Blog:      http://www.freeroller.net/page/dion/Weblog
> Work:      http://www.multitask.com.au
>
>
> "Juozas Baliuka" <baliuka@centras.lt> wrote on 17/05/2003 05:05:40 PM:
>
> >
> > Yes, it has pdf target, but I do not think it works:
> >
> > xdoc:init:
> >
> > pdf:init:
> >
> > fo:fo:
> >     [echo] Generating C:\home\voruta/target/docs/project.fo ...
> >     [java]
> >     [java] (Location of error unknown)XSLT Error
> > (javax.xml.transform.Transforme
> > rConfigurationException): javax.xml.transform.TransformerException:
> > java.net.Unk
> > nownHostException: C
> >
> > BUILD FAILED
> > Java returned: -1
> > Total time:  14 seconds
> >
> > It seems it tries to parse filename as URL.
> >  I saw some pdfs generated by maven, possible it works on linux,
> > but all generated docs are without tables.
> >
> >
> > > Tim,
> > >
> > > fwiw, Maven also has a facility to convert xdoc to PDF.
> > > --
> > > dIon Gillard, Multitask Consulting
> > > Blog:      http://www.freeroller.net/page/dion/Weblog
> > > Work:      http://www.multitask.com.au
> > >
> > >
> > > tobrien@transolutions.net (O'brien, Tim) wrote on 17/05/2003 04:13:00
> AM:
> > >
> > > > On Fri, 2003-05-16 at 13:00, Phil Steitz wrote:
> > > > > --- robert burrell donkin
> > > > > <robertburrelldonkin@blueyonder.co.uk> wrote:
> > > >
> > > > > > On Thursday, May 15, 2003, at 10:34 PM, Phil Steitz
> > > > > We can look into this as we get further along.  For
> > > > > now, I assume it is OK to add links to external
> > > > > sources as appropriate in the javadoc.
> > > >
> > > > Not to sound like a Maven partisan, but linkcheck is integrated as a
> > > > Maven report,
> http://jakarta.apache.org/commons/codec/linkcheck.html.  I
> > > > think it is fine to add references to external documentation as long
> as
> > > > we make sure that our links are working - i.e. make getting
> linkcheck
> > > > down to zero errors a condition for a release.
> > > >
> > > > ( Question, so why doesn't codec have a zero length linkcheck?  I
> plead
> > > > guilty. )
> > > >
> > > > > Here again, something to think about as we get further
> > > > > along. One last point before letting this drop (for
> > > > > now).  Mathematical documentation in HTML is painful,
> > > > > trying to embed it in javadoc is cruel and unusual
> > > > > punishment. This is another reason to externalize the
> > > > > user's guide.  The eventual user's guide will need to
> > > > > include images and/or possibly be distributed as pdf,
> > > > > tex, or postcript.  Probably should not have just
> > > > > opened up that can of worms...Something to think about
> > > > > down the road.
> > > >
> > > > I remember that Forrest has a nice little feature of converting your
> > > > xdoc to PDF - click on the PDF link on http://xml.apache.org.
> Although
> > > > it seems a little twisted, we could use Maven for site generation,
> and
> > > > Forrest for documentation - unless I'm missing some Maven plugin
> that
> > > > generates PDF output.
> > > >
> > > >
> > > >
> > > >
> > > >
> ---------------------------------------------------------------------
> > > > To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> > > > For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> > > >
> > >
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> > > For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> > >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> > For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>


---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message