maven-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Feilpe Vieira Silva <fgau...@gmail.com>
Subject Re: how to transform docbook documents with Maven? -WAS Re: Docbook
Date Mon, 15 Nov 2004 12:26:10 GMT
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:guest@cvs.dev.java.net:/cvs login

      followed by

      cvs -d :pserver:guest@cvs.dev.java.net:/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 documentation.

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 listdev@schoolbus.dev.java.net - the
other members should also help.

thank you very much by your friendly support,

    Felipe Gaúcho
    Schoolbus owner
    https://schoolbus.dev.java.net/









On Mon, 15 Nov 2004 08:21:51 +0100, Siegfried Goeschl
<siegfried.goeschl@it20one.at> wrote:
> Hi Felipe,
> 
> 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)
> 
>  > The soggested plugin is messy and produces a bad formatted
> >  documentation.. Can you help me on how to use the default plugin
> 
> 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.
> 
> >Provider org.apache.xalan.processor.TransformerFactoryImpl not found
> >com.werken.werkz.UnattainableGoalException: Unable to obtain goal [docbook:trans
> >form] -- C:\Documents and Settings\Administrador\.maven\cache\maven-docbook-plug
> >in-1.2\plugin.jelly:42:9: <ant:style> Provider org.apache.xalan.processor.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:193)
> >        at org.apache.maven.plugin.PluginManager.attainGoals(PluginManager.java:
> >634)
> 
> 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 ...
> 
> Cheers,
> 
> Siegfried Goeschl
> 
> ?-------- Original Message --------
> Subject:        Maven-plugins-developer digest, Vol 1 #65 - 2 msgs
> Date:   Sun, 14 Nov 2004 20:21:47 -0800
> From:   maven-plugins-developer-request@lists.sourceforge.net
> Reply-To:       maven-plugins-developer@lists.sourceforge.net
> To:     maven-plugins-developer@lists.sourceforge.net
> 
> Send Maven-plugins-developer mailing list submissions to
>         maven-plugins-developer@lists.sourceforge.net
> 
> To subscribe or unsubscribe via the World Wide Web, visit
>         https://lists.sourceforge.net/lists/listinfo/maven-plugins-developer
> or, via email, send a message with subject or body 'help' to
>         maven-plugins-developer-request@lists.sourceforge.net
> 
> You can reach the person managing the list at
>         maven-plugins-developer-admin@lists.sourceforge.net
> 
> When replying, please edit your Subject line so it is more specific
> than "Re: Contents of Maven-plugins-developer digest..."
> 
> Today's Topics:
> 
>    1. Re: Docbook (Per Olesen)
>    2. RE: Docbook (Carlos Sanchez)
> 
> --__--__--
> 
> Message: 1
> From: Per Olesen <polesen@nordija.com>
> Organization: Nordija A/S
> To: maven-plugins-developer@lists.sourceforge.net
> Subject: Re: [Maven-plugins-developer] Docbook
> Date: Sun, 14 Nov 2004 09:45:57 +0100
> Cc: "Carlos Sanchez" <apache@carlos.cousas.net>
> 
> 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: polesen@nordija.com - cell#: +45 23 38 95 81
> 
> --__--__--
> 
> Message: 2
> From: "Carlos Sanchez" <carlos@apache.org>
> To: "'Per Olesen'" <polesen@nordija.com>,
>         "'Maven-plugins-developer'" <Maven-plugins-developer@lists.sourceforge.net>
> Subject: RE: [Maven-plugins-developer] Docbook
> Date: Sun, 14 Nov 2004 16:14:10 +0100
> 
> This is a multi-part message in MIME format.
> 
> ------=_NextPart_000_0003_01C4CA64.FB3E9720
> Content-Type: text/plain;
>         charset="us-ascii"
> Content-Transfer-Encoding: 7bit
> 
> Hi,
> 
> I'd like this patch to be applied and release a new version of the plugin. You should
also remove the maven.xml.
> 
> I think maven docbook should be removed as it seems to be discontinued and not very useful,
and this one renamed from sdocbook to
> docbook. It shouldn't be included in maven as it depends in jimi, which can't be redistributed.
What do you think about?
> 
> 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.
> 
>     <postGoal name="sdocbook:prepare-filesystem">
>         <j:set var="unzipped" value="false" />
>         <util:available file="${maven.sdocbook.generated.fo}">
>             <j:set var="unzipped" value="true" />
>             <echo>Using previusly unzipped docbook files</echo>
>         </util:available>
>         <j:if test="${!unzipped}">
>             <!-- unzip docbook files -->
>             <ant:unzip dest="${maven.build.dir}"
>                 src="${pom.getDependencyPath('docbook:docbook-xsl')}"/>
> 
>             <!-- use a custom fo stylesheet -->
>             <move file="${maven.sdocbook.stylesheets.dir}/fo/docbook.xsl"
>                 tofile="${maven.sdocbook.stylesheets.dir}/fo/docbook-bak.xsl"/>
>             <copy file="${maven.sdocbook.src.dir}/styles/fo/docbook.xsl"
>                 todir="${maven.sdocbook.stylesheets.dir}/fo"/>
> 
>             <!-- use a custom html stylesheet -->
>             <move file="${maven.sdocbook.stylesheets.dir}/html/docbook.xsl"
>                 tofile="${maven.sdocbook.stylesheets.dir}/html/docbook-bak.xsl"/>
>             <copy file="${maven.sdocbook.src.dir}/styles/html/docbook.xsl"
>                 todir="${maven.sdocbook.stylesheets.dir}/html"/>
> 
>             <copy todir="${maven.sdocbook.stylesheets.dir}">
>                 <fileset dir="${maven.sdocbook.src.dir}/images"/>
>             </copy>
>         </j:if>
> 
>     </postGoal>
> 
> With this properties:
> maven.sdocbook.resources.include=**/*.gif,**/*.svg,**/*.jpg
> maven.sdocbook.stylesheets.dir=${maven.build.dir}/docbook-xsl-1.66.1
> 
> and
>     <dependency>
>       <groupId>docbook</groupId>
>       <artifactId>docbook-xsl</artifactId>
>       <version>1.66.1</version>
>       <url>http://docbook.sourceforge.net</url>
>       <type>zip</type>
>     </dependency>
> 
> 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
> 
> Regards
> 
> > -----Original Message-----
> > From: maven-plugins-developer-admin@lists.sourceforge.net
> > [mailto:maven-plugins-developer-admin@lists.sourceforge.net]
> > On Behalf Of Per Olesen
> > Sent: Sunday, November 14, 2004 9:46 AM
> > To: maven-plugins-developer@lists.sourceforge.net
> > 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: polesen@nordija.com - 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
> > Maven-plugins-developer@lists.sourceforge.net
> > https://lists.sourceforge.net/lists/listinfo/maven-plugins-developer
> >
> >
> 
> ------=_NextPart_000_0003_01C4CA64.FB3E9720
> Content-Type: text/plain;
>         name="patch.txt"
> Content-Transfer-Encoding: quoted-printable
> Content-Disposition: attachment;
>         filename="patch.txt"
> 
> Index: plugin.jelly
> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
> 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=3D"basename" =
> value=3D"${file.name.substring(0,index)}"/>
> =20
>        <!-- Use XSLT processor to transform DOCBOOK into HTML -->     =20
> -      <java classname=3D"org.apache.xalan.xslt.Process" fork=3D"yes">
> +      <java classname=3D"org.apache.xalan.xslt.Process" fork=3D"yes" =
> failonerror=3D"true">
>          <jvmarg value=3D"-Xbootclasspath/p:${_bootclasspath}"/>
>          <classpath>    =20
>            <pathelement =
> location=3D"${plugin.getDependencyPath('avalon-framework')}"/>
> @@ -181,7 +181,7 @@
>        <j:set var=3D"index" value=3D"${file.name.lastIndexOf('.')}"/>
>        <j:set var=3D"basename" =
> value=3D"${file.name.substring(0,index)}"/>
> =20
> -      <java classname=3D"org.apache.xalan.xslt.Process" fork=3D"yes">
> +      <java classname=3D"org.apache.xalan.xslt.Process" fork=3D"yes" =
> failonerror=3D"true">
>          <jvmarg value=3D"-Xbootclasspath/p:${_bootclasspath}"/>
>          <classpath>    =20
>            <pathelement =
> location=3D"${maven.sdocbook.stylesheets.dir}/extensions/xalan25.jar"/>
> @@ -191,9 +191,11 @@
>              <pathelement location=3D"${catalogManagerPropertiesDir}"/> =
> <!-- includes the users CatalogManager.properties in classpath -->
>            </j:if>
>          </classpath>
> +
>          <sysproperty key=3D"user.language" value=3D"en"/>
>          <sysproperty key=3D"javax.xml.parsers.DocumentBuilderFactory" =
> value=3D"org.apache.xerces.jaxp.DocumentBuilderFactoryImpl"/>
>          <sysproperty key=3D"javax.xml.parsers.SAXParserFactory" =
> value=3D"org.apache.xerces.jaxp.SAXParserFactoryImpl"/>
> +
>          <j:if test=3D"${useEntityResolver =3D=3D 'true'}">
>            <arg value=3D"-ENTITYRESOLVER"/>
>            <arg =
> value=3D"org.apache.xml.resolver.tools.CatalogResolver"/>
> @@ -206,6 +208,7 @@
>          <arg value=3D"${maven.sdocbook.generated.fo}/${basename}.fo"/>
>          <arg value=3D"-xsl"/>
>          <arg =
> value=3D"${maven.sdocbook.stylesheets.dir}/fo/docbook.xsl"/>
> +
>          <arg line=3D"${maven.sdocbook.fo.params}"/>
>        </java>
>         =20
> @@ -249,7 +252,7 @@
>        <j:set var=3D"basename" =
> value=3D"${file.name.substring(0,index)}"/>
> =20
>        <!-- Run FOP to transform FO into PDF -->
> -      <java classname=3D"org.apache.fop.apps.Fop" fork=3D"yes">
> +      <java classname=3D"org.apache.fop.apps.Fop" fork=3D"yes" =
> failonerror=3D"true">
>          <jvmarg value=3D"-Xbootclasspath/p:${_bootclasspath}"/>
>          <classpath>    =20
>            <pathelement =
> location=3D"${plugin.getDependencyPath('avalon-framework')}"/>
> @@ -261,6 +264,7 @@
>          <sysproperty key=3D"user.language" value=3D"en"/>
>          <sysproperty key=3D"javax.xml.parsers.DocumentBuilderFactory" =
> value=3D"org.apache.xerces.jaxp.DocumentBuilderFactoryImpl"/>
>          <sysproperty key=3D"javax.xml.parsers.SAXParserFactory" =
> value=3D"org.apache.xerces.jaxp.SAXParserFactoryImpl"/>
> +
>          <arg value=3D"-fo"/>
>          <arg value=3D"${file.absolutePath}"/>
>          <arg value=3D"-pdf"/>
> 
> ------=_NextPart_000_0003_01C4CA64.FB3E9720--
> 
> --__--__--
> 
> _______________________________________________
> Maven-plugins-developer mailing list
> Maven-plugins-developer@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/maven-plugins-developer
> 
> End of Maven-plugins-developer Digest
> 
> __________ NOD32 1.922 (20041112) Information __________
> 
> Diese E-Mail wurde vom NOD32 Antivirus System geprüft
> http://www.nod32.com
> 
> --
> Siegfried Goeschl
> 
> IT20one GmbH
> Bandgasse 2/22
> 1070 Wien
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
> 
>

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Mime
View raw message