Menu
▾
▴
[Maven-plugins-developer] Re: how to transform docbook documents with Maven? -WAS Re: Docbook
|
From: Feilpe V. S. <fg...@gm...> - 2004-11-15 12:26:12
|
Dear Goeschl,
All my project docbook sources are available through CVS in the
Schoolbus project:
Check out source code with a CVS client. For example:
cvs -d :pserver:gu...@cv...:/cvs login
followed by
cvs -d :pserver:gu...@cv...:/cvs checkout schoolbus
the current "under progress" documentation can be found into the folder:
schoolbus/schoolbus-quaestio/docs/requirements/en
the main document ios "master.xml" and for now I'm producing the PDF
and Html outputs using an ANT task - called from Maven. In order to
produce the output, just type "maven docbooks" into the folder
schoolbus/schoolbus-quaestio/docs/requirements
it will create a folder called "build" containing all produced documentatio=
n.
My frustration is about the need of ANT instead of a pure maven
solution. I know that solution is possible but at now I can't figure
out how to. I tryied the default maven docbook plugin but the results
are a bit strange - then I think I'm doing something wrong :)
The usage of my project documentation as a "plugin test bed" would be
greateful. I will help you with all feeback I can. The Schoolbus have
70 members, much of them involved in this phase of documentation. We
all will give you the feedback.
Please copy your questions to the li...@sc... - the
other members should also help.
thank you very much by your friendly support,
Felipe Ga=FAcho
Schoolbus owner
https://schoolbus.dev.java.net/
On Mon, 15 Nov 2004 08:21:51 +0100, Siegfried Goeschl
<sie...@it...> wrote:
> Hi Felipe,
>=20
> don't know if this is coincidence or not but we have some activities on
> the maven-plugins site regarding the sdocbooc plugin (see below)
>=20
> > The soggested plugin is messy and produces a bad formatted
> > documentation.. Can you help me on how to use the default plugin
>=20
> Can you send me/us a sample so that we can reproduce the behaviour?! In
> the case of a real problem it would be helpful if we could use your
> document as test sample.
>=20
> >Provider org.apache.xalan.processor.TransformerFactoryImpl not found
> >com.werken.werkz.UnattainableGoalException: Unable to obtain goal [docbo=
ok:trans
> >form] -- C:\Documents and Settings\Administrador\.maven\cache\maven-docb=
ook-plug
> >in-1.2\plugin.jelly:42:9: <ant:style> Provider org.apache.xalan.processo=
r.Transf
> >ormerFactoryImpl not found
> > at com.werken.werkz.Goal.fire(Goal.java:646)
> > at com.werken.werkz.Goal.attain(Goal.java:575)
> > at com.werken.werkz.WerkzProject.attainGoal(WerkzProject.java:19=
3)
> > at org.apache.maven.plugin.PluginManager.attainGoals(PluginManag=
er.java:
> >634)
>=20
> This looks like not finding XALAN on the classpath. Having said that I'm =
not sure about your version since the latest is 1.4 SNAPSHOT ...
>=20
> Cheers,
>=20
> Siegfried Goeschl
>=20
> ?-------- Original Message --------
> Subject: Maven-plugins-developer digest, Vol 1 #65 - 2 msgs
> Date: Sun, 14 Nov 2004 20:21:47 -0800
> From: mav...@li...
> Reply-To: mav...@li...
> To: mav...@li...
>=20
> Send Maven-plugins-developer mailing list submissions to
> mav...@li...
>=20
> To subscribe or unsubscribe via the World Wide Web, visit
> https://lists.sourceforge.net/lists/listinfo/maven-plugins-develo=
per
> or, via email, send a message with subject or body 'help' to
> mav...@li...
>=20
> You can reach the person managing the list at
> mav...@li...
>=20
> When replying, please edit your Subject line so it is more specific
> than "Re: Contents of Maven-plugins-developer digest..."
>=20
> Today's Topics:
>=20
> 1. Re: Docbook (Per Olesen)
> 2. RE: Docbook (Carlos Sanchez)
>=20
> --__--__--
>=20
> Message: 1
> From: Per Olesen <po...@no...>
> Organization: Nordija A/S
> To: mav...@li...
> Subject: Re: [Maven-plugins-developer] Docbook
> Date: Sun, 14 Nov 2004 09:45:57 +0100
> Cc: "Carlos Sanchez" <ap...@ca...>
>=20
> Hi Carlos,
>=20
> > I see last sdocbook plugin version is quite old, is it discontinued?
>=20
> It is not discontinued, it has just not had any release in a long time :-=
) I
> put up the current 1.4-SNAPSHOT a long time ago with the intention of
> releasing it when it had had some testing. That is some time ago now.
>=20
> > Can I improve and release it?
>=20
> Certainly, do you have anything special in mind? If it is simple, maybe i=
t is
> easiest if you simply provide me with a patch!?
>=20
> I myself would like to include newest version of the docbooks stylesheets=
,
> even though you can point to outside installation of those now.
>=20
> > Maybe it's a good idea substitute the maven docbook plugin by this one.
>=20
> Maybe and maybe not. I do not really know how much relation these two pro=
jects
> have with eachother (maven and maven-plugins), how maven controls their
> plugins, how many users the other plugin has etc. (I do not even know if =
this
> plugin has few or many users, though I would guess on few).
>=20
> /Per
>=20
> --
> Per Olesen @ Nordija A/S - www.nordija.com - main#: +45 70 20 25 10
> email: po...@no... - cell#: +45 23 38 95 81
>=20
> --__--__--
>=20
> Message: 2
> From: "Carlos Sanchez" <ca...@ap...>
> To: "'Per Olesen'" <po...@no...>,
> "'Maven-plugins-developer'" <Mav...@li...urce=
forge.net>
> Subject: RE: [Maven-plugins-developer] Docbook
> Date: Sun, 14 Nov 2004 16:14:10 +0100
>=20
> This is a multi-part message in MIME format.
>=20
> ------=3D_NextPart_000_0003_01C4CA64.FB3E9720
> Content-Type: text/plain;
> charset=3D"us-ascii"
> Content-Transfer-Encoding: 7bit
>=20
> Hi,
>=20
> I'd like this patch to be applied and release a new version of the plugin=
. You should also remove the maven.xml.
>=20
> I think maven docbook should be removed as it seems to be discontinued an=
d not very useful, and this one renamed from sdocbook to
> docbook. It shouldn't be included in maven as it depends in jimi, which c=
an't be redistributed. What do you think about?
>=20
> I have used this code in maven.xml to use another stylesheet version and =
custom stylesheets. It'd be great if the plugin could be
> more customizable, in the meantime it can be added to the docs.
>=20
> <postGoal name=3D"sdocbook:prepare-filesystem">
> <j:set var=3D"unzipped" value=3D"false" />
> <util:available file=3D"${maven.sdocbook.generated.fo}">
> <j:set var=3D"unzipped" value=3D"true" />
> <echo>Using previusly unzipped docbook files</echo>
> </util:available>
> <j:if test=3D"${!unzipped}">
> <!-- unzip docbook files -->
> <ant:unzip dest=3D"${maven.build.dir}"
> src=3D"${pom.getDependencyPath('docbook:docbook-xsl')}"/>
>=20
> <!-- use a custom fo stylesheet -->
> <move file=3D"${maven.sdocbook.stylesheets.dir}/fo/docbook.xs=
l"
> tofile=3D"${maven.sdocbook.stylesheets.dir}/fo/docbook-ba=
k.xsl"/>
> <copy file=3D"${maven.sdocbook.src.dir}/styles/fo/docbook.xsl=
"
> todir=3D"${maven.sdocbook.stylesheets.dir}/fo"/>
>=20
> <!-- use a custom html stylesheet -->
> <move file=3D"${maven.sdocbook.stylesheets.dir}/html/docbook.=
xsl"
> tofile=3D"${maven.sdocbook.stylesheets.dir}/html/docbook-=
bak.xsl"/>
> <copy file=3D"${maven.sdocbook.src.dir}/styles/html/docbook.x=
sl"
> todir=3D"${maven.sdocbook.stylesheets.dir}/html"/>
>=20
> <copy todir=3D"${maven.sdocbook.stylesheets.dir}">
> <fileset dir=3D"${maven.sdocbook.src.dir}/images"/>
> </copy>
> </j:if>
>=20
> </postGoal>
>=20
> With this properties:
> maven.sdocbook.resources.include=3D**/*.gif,**/*.svg,**/*.jpg
> maven.sdocbook.stylesheets.dir=3D${maven.build.dir}/docbook-xsl-1.66.1
>=20
> and
> <dependency>
> <groupId>docbook</groupId>
> <artifactId>docbook-xsl</artifactId>
> <version>1.66.1</version>
> <url>http://docbook.sourceforge.net</url>
> <type>zip</type>
> </dependency>
>=20
> Custom stylesheets can be found at http://cvs.sourceforge.net/viewcvs.py/=
acegisecurity/acegisecurity/docbook/styles/html/ and
> http://cvs.sourceforge.net/viewcvs.py/acegisecurity/acegisecurity/docbook=
/styles/fo
> It needs some testing, maybe for a 1.5 version
>=20
> Regards
>=20
> > -----Original Message-----
> > From: mav...@li...
> > [mailto:mav...@li...]
> > On Behalf Of Per Olesen
> > Sent: Sunday, November 14, 2004 9:46 AM
> > To: mav...@li...
> > Cc: Carlos Sanchez
> > Subject: Re: [Maven-plugins-developer] Docbook
> >
> > Hi Carlos,
> >
> > > I see last sdocbook plugin version is quite old, is it discontinued?
> >
> > It is not discontinued, it has just not had any release in a
> > long time :-) I put up the current 1.4-SNAPSHOT a long time
> > ago with the intention of releasing it when it had had some
> > testing. That is some time ago now.
> >
> > > Can I improve and release it?
> >
> > Certainly, do you have anything special in mind? If it is
> > simple, maybe it is easiest if you simply provide me with a patch!?
> >
> > I myself would like to include newest version of the docbooks
> > stylesheets, even though you can point to outside
> > installation of those now.
> >
> > > Maybe it's a good idea substitute the maven docbook plugin
> > by this one.
> >
> > Maybe and maybe not. I do not really know how much relation
> > these two projects have with eachother (maven and
> > maven-plugins), how maven controls their plugins, how many
> > users the other plugin has etc. (I do not even know if this
> > plugin has few or many users, though I would guess on few).
> >
> > /Per
> >
> > --
> > Per Olesen @ Nordija A/S - www.nordija.com - main#: +45 70 20 25 10
> > email: po...@no... - cell#: +45 23 38 95 81
> >
> >
> > -------------------------------------------------------
> > This SF.Net email is sponsored by: InterSystems CACHE
> > FREE OODBMS DOWNLOAD - A multidimensional database that combines
> > robust object and relational technologies, making it a perfect match
> > for Java, C++,COM, XML, ODBC and JDBC. www.intersystems.com/match8
> > _______________________________________________
> > Maven-plugins-developer mailing list
> > Mav...@li...
> > https://lists.sourceforge.net/lists/listinfo/maven-plugins-developer
> >
> >
>=20
> ------=3D_NextPart_000_0003_01C4CA64.FB3E9720
> Content-Type: text/plain;
> name=3D"patch.txt"
> Content-Transfer-Encoding: quoted-printable
> Content-Disposition: attachment;
> filename=3D"patch.txt"
>=20
> Index: plugin.jelly
> =3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D=
3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D
> =3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D=
3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D
> =3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D3D=3D=
3D=3D3D=3D3D
> RCS file: /cvsroot/maven-plugins/maven-plugins/sdocbook/plugin.jelly,v
> retrieving revision 1.5
> diff -u -r1.5 plugin.jelly
> --- plugin.jelly 12 Apr 2004 09:42:05 -0000 1.5
> +++ plugin.jelly 13 Nov 2004 21:04:02 -0000
> @@ -92,7 +92,7 @@
> <j:set var=3D3D"basename" =3D
> value=3D3D"${file.name.substring(0,index)}"/>
> =3D20
> <!-- Use XSLT processor to transform DOCBOOK into HTML --> =3D=
20
> - <java classname=3D3D"org.apache.xalan.xslt.Process" fork=3D3D"yes"=
>
> + <java classname=3D3D"org.apache.xalan.xslt.Process" fork=3D3D"yes"=
=3D
> failonerror=3D3D"true">
> <jvmarg value=3D3D"-Xbootclasspath/p:${_bootclasspath}"/>
> <classpath> =3D20
> <pathelement =3D
> location=3D3D"${plugin.getDependencyPath('avalon-framework')}"/>
> @@ -181,7 +181,7 @@
> <j:set var=3D3D"index" value=3D3D"${file.name.lastIndexOf('.')}"/>
> <j:set var=3D3D"basename" =3D
> value=3D3D"${file.name.substring(0,index)}"/>
> =3D20
> - <java classname=3D3D"org.apache.xalan.xslt.Process" fork=3D3D"yes"=
>
> + <java classname=3D3D"org.apache.xalan.xslt.Process" fork=3D3D"yes"=
=3D
> failonerror=3D3D"true">
> <jvmarg value=3D3D"-Xbootclasspath/p:${_bootclasspath}"/>
> <classpath> =3D20
> <pathelement =3D
> location=3D3D"${maven.sdocbook.stylesheets.dir}/extensions/xalan25.jar"/>
> @@ -191,9 +191,11 @@
> <pathelement location=3D3D"${catalogManagerPropertiesDir}"/>=
=3D
> <!-- includes the users CatalogManager.properties in classpath -->
> </j:if>
> </classpath>
> +
> <sysproperty key=3D3D"user.language" value=3D3D"en"/>
> <sysproperty key=3D3D"javax.xml.parsers.DocumentBuilderFactory" =
=3D
> value=3D3D"org.apache.xerces.jaxp.DocumentBuilderFactoryImpl"/>
> <sysproperty key=3D3D"javax.xml.parsers.SAXParserFactory" =3D
> value=3D3D"org.apache.xerces.jaxp.SAXParserFactoryImpl"/>
> +
> <j:if test=3D3D"${useEntityResolver =3D3D=3D3D 'true'}">
> <arg value=3D3D"-ENTITYRESOLVER"/>
> <arg =3D
> value=3D3D"org.apache.xml.resolver.tools.CatalogResolver"/>
> @@ -206,6 +208,7 @@
> <arg value=3D3D"${maven.sdocbook.generated.fo}/${basename}.fo"/>
> <arg value=3D3D"-xsl"/>
> <arg =3D
> value=3D3D"${maven.sdocbook.stylesheets.dir}/fo/docbook.xsl"/>
> +
> <arg line=3D3D"${maven.sdocbook.fo.params}"/>
> </java>
> =3D20
> @@ -249,7 +252,7 @@
> <j:set var=3D3D"basename" =3D
> value=3D3D"${file.name.substring(0,index)}"/>
> =3D20
> <!-- Run FOP to transform FO into PDF -->
> - <java classname=3D3D"org.apache.fop.apps.Fop" fork=3D3D"yes">
> + <java classname=3D3D"org.apache.fop.apps.Fop" fork=3D3D"yes" =3D
> failonerror=3D3D"true">
> <jvmarg value=3D3D"-Xbootclasspath/p:${_bootclasspath}"/>
> <classpath> =3D20
> <pathelement =3D
> location=3D3D"${plugin.getDependencyPath('avalon-framework')}"/>
> @@ -261,6 +264,7 @@
> <sysproperty key=3D3D"user.language" value=3D3D"en"/>
> <sysproperty key=3D3D"javax.xml.parsers.DocumentBuilderFactory" =
=3D
> value=3D3D"org.apache.xerces.jaxp.DocumentBuilderFactoryImpl"/>
> <sysproperty key=3D3D"javax.xml.parsers.SAXParserFactory" =3D
> value=3D3D"org.apache.xerces.jaxp.SAXParserFactoryImpl"/>
> +
> <arg value=3D3D"-fo"/>
> <arg value=3D3D"${file.absolutePath}"/>
> <arg value=3D3D"-pdf"/>
>=20
> ------=3D_NextPart_000_0003_01C4CA64.FB3E9720--
>=20
> --__--__--
>=20
> _______________________________________________
> Maven-plugins-developer mailing list
> Mav...@li...
> https://lists.sourceforge.net/lists/listinfo/maven-plugins-developer
>=20
> End of Maven-plugins-developer Digest
>=20
> __________ NOD32 1.922 (20041112) Information __________
>=20
> Diese E-Mail wurde vom NOD32 Antivirus System gepr=FCft
> http://www.nod32.com
>=20
> --
> Siegfried Goeschl
>=20
> IT20one GmbH
> Bandgasse 2/22
> 1070 Wien
>=20
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: use...@ma...
> For additional commands, e-mail: use...@ma...
>=20
>
|
