User: user57
Date: 01/08/29 02:19:34
Modified: . build.xml
Log:
o moved xml docs to xdocs to make the build a little easier & seperate things
a little bit.
o moved howto docs to xdocs/howto
o renamed jboss.xsl to fancy.xsl
o added plain.xsl & printable.xsl
o changed html-* targets to docs-html-* for consitency
o using SAXON for XSLT for all docs-html-* targets
o docs-html will now build the fancy and printable docs by default, use the
docs-html-plain for the basic chunked docbook format (minus the jboss
fancy header and footer).
Revision Changes Path
1.13 +107 -47 manual/build.xml
Index: build.xml
===================================================================
RCS file: /cvsroot/jboss/manual/build.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- build.xml 2001/08/28 23:51:42 1.12
+++ build.xml 2001/08/29 09:19:34 1.13
@@ -10,7 +10,7 @@
<!-- -->
<!-- ====================================================================== -->
-<!-- $Id: build.xml,v 1.12 2001/08/28 23:51:42 user57 Exp $ -->
+<!-- $Id: build.xml,v 1.13 2001/08/29 09:19:34 user57 Exp $ -->
<project default="main">
@@ -74,7 +74,7 @@
<!-- Module name(s) & version -->
<property name="module.name" value="manual"/>
<property name="module.Name" value="JBoss Manual"/>
- <property name="module.version" value="1.0"/>
+ <property name="module.version" value="unspecified"/>
<!-- ================================================================== -->
@@ -84,6 +84,7 @@
<!-- DocBook -->
<property name="oasis.docbook.xml.root"
value="${thirdparty.root}/oasis/docbook-xml"/>
<property name="oasis.docbook.xsl.root"
value="${thirdparty.root}/oasis/docbook-xsl"/>
+ <property name="oasis.docbook.xsl.chunker.quiet" value="0"/>
<!-- FOP -->
<taskdef name="fop" classname="org.apache.fop.tools.anttasks.Fop"/>
@@ -146,13 +147,16 @@
<property name="source.examples" value="${module.source}/examples"/>
<property name="source.stylesheets" value="${module.source}/stylesheets"/>
<property name="source.docs" value="${module.source}/docs"/>
+ <property name="source.xdocs" value="${module.source}/xdocs"/>
-
<!-- Where build generated files will go -->
<property name="build.docs" value="${module.build}/docs"/>
+ <property name="build.xdocs" value="${module.build}/xdocs"/>
<property name="build.stylesheets" value="${module.build}/stylesheets"/>
<property name="build.html" value="${module.build}/html"/>
- <property name="build.html-printable" value="${module.build}/html-printable"/>
+ <property name="build.html.fancy" value="${build.html}/fancy"/>
+ <property name="build.html.plain" value="${build.html}/plain"/>
+ <property name="build.html.printable" value="${build.html}/printable"/>
<property name="build.pdf" value="${module.build}/pdf"/>
<property name="build.jars" value="${module.build}/lib"/>
@@ -205,7 +209,7 @@
</copy>
</target>
- <!-- Compile xml doc sources -->
+ <!-- Compile doc sources & support files -->
<target name="compile-docs" depends="init">
<mkdir dir="${build.docs}"/>
<copy todir="${build.docs}" filtering="yes">
@@ -214,11 +218,20 @@
<exclude name="**/images/**"/>
</fileset>
</copy>
+
+ <!-- Make sure images do not get filtered -->
<copy todir="${build.docs}" filtering="no">
<fileset dir="${source.docs}">
<include name="**/images/**"/>
</fileset>
</copy>
+
+ <mkdir dir="${build.xdocs}"/>
+ <copy todir="${build.xdocs}" filtering="yes">
+ <fileset dir="${source.xdocs}">
+ <include name="**/*"/>
+ </fileset>
+ </copy>
</target>
@@ -226,10 +239,9 @@
<!-- Build Jars -->
<!-- ================================================================== -->
- <!--
- | Build all jar files.
- -->
+ <!-- Build all jar files. -->
<target name="jars" depends="compile" description="Builds all jar files.">
+ <!-- This module creates no jar files. -->
</target>
@@ -242,65 +254,114 @@
|
| This target should depend on other docs-* targets for each
| different type of docuementation that is to be generated.
- --> <!--removed pdf - it breaks build -->
- <target name="docs" depends="html"
- description="Builds all [non pdf until pdf works] documentation."/>
-
- <!-- Generate all HTML manual formats -->
- <target name="html" depends="html-default, html-printable"/>
-
- <!-- Generate the default HTML manual -->
- <target name="html-default" depends="compile">
-
- <!--
- | Create chunked tutorial
- | destdir parameter is ignored due to chunking
- | so we move all chunked html files to destination
- -->
-
- <mkdir dir="${build.html}"/>
- <style basedir="${build.docs}"
- style="${build.stylesheets}/jboss.xsl"
+ -->
+ <target name="docs" depends="docs-html"
+ description="Builds the default documentation."/>
+
+ <!-- Generate most HTML manual formats -->
+ <target name="docs-html"
+ depends="docs-html-fancy, docs-html-printable"/>
+
+ <!-- Generate the fancy HTML manual -->
+ <target name="docs-html-fancy" depends="compile">
+
+ <!-- Force the use of SAXON XSLT -->
+ <property system="true"
+ name="javax.xml.transform.TransformerFactory"
+ value="com.icl.saxon.TransformerFactoryImpl"/>
+
+ <mkdir dir="${build.html.fancy}"/>
+ <style style="${build.stylesheets}/fancy.xsl"
+ processor="trax"
extension=".html"
- destdir="output/html">
+ basedir="${build.xdocs}"
+ destdir="${build.html.fancy}">
<include name="jbossdocs.xml"/>
+ <param name="quiet" expression="${oasis.docbook.xsl.chunker.quiet}"/>
+ <param name="base.dir" expression="${build.html.fancy}${file.separator}"/>
</style>
+
+ <!-- this file is empty -->
+ <delete file="${build.html.fancy}/jbossdocs.html"/>
- <copy todir="${build.html}">
+ <copy todir="${build.html.fancy}">
<fileset dir="${build.docs}">
<include name="**/*"/>
- <exclude name="*.xml"/>
</fileset>
</copy>
</target>
- <!-- Generate the printable HTML manual -->
- <target name="html-printable" depends="compile">
+ <!-- Generate the plain HTML manual -->
+ <target name="docs-html-plain" depends="compile">
- <mkdir dir="${build.html-printable}"/>
- <style basedir="${build.docs}"
- destdir="${build.html-printable}"
- style="${oasis.docbook.xsl.root}/html/docbook.xsl"
- extension=".html">
+ <!-- Force the use of SAXON XSLT -->
+ <property system="true"
+ name="javax.xml.transform.TransformerFactory"
+ value="com.icl.saxon.TransformerFactoryImpl"/>
+
+ <mkdir dir="${build.html.plain}"/>
+ <style style="${build.stylesheets}/plain.xsl"
+ processor="trax"
+ extension=".html"
+ basedir="${build.xdocs}"
+ destdir="${build.html.plain}">
<include name="jbossdocs.xml"/>
+ <param name="quiet" expression="${oasis.docbook.xsl.chunker.quiet}"/>
+ <param name="base.dir" expression="${build.html.plain}${file.separator}"/>
</style>
+
+ <!-- this file is empty -->
+ <delete file="${build.html.plain}/jbossdocs.html"/>
- <copy todir="${build.html-printable}">
+ <copy todir="${build.html.plain}">
<fileset dir="${build.docs}">
<include name="**/*"/>
- <exclude name="*.xml"/>
</fileset>
</copy>
</target>
- <!-- Generate the PDF manual -->
- <target name="pdf" depends="compile">
+ <!-- Generate the printable HTML manual -->
+ <target name="docs-html-printable" depends="compile">
+
+ <!-- Force the use of SAXON XSLT -->
+ <property system="true"
+ name="javax.xml.transform.TransformerFactory"
+ value="com.icl.saxon.TransformerFactoryImpl"/>
+
+ <mkdir dir="${build.html.printable}"/>
+ <style style="${build.stylesheets}/printable.xsl"
+ processor="trax"
+ extension=".html"
+ basedir="${build.xdocs}"
+ in="${build.xdocs}/jbossdocs.xml"
+ out="${build.html.printable}/manual.html">
+ </style>
+
+ <copy todir="${build.html.printable}">
+ <fileset dir="${build.docs}">
+ <include name="**/*"/>
+ </fileset>
+ </copy>
+ </target>
+
+ <!--
+ | Generate the PDF manual.
+ |
+ | This currently does not work very well, your mileage will vary.
+ -->
+ <target name="docs-pdf" depends="compile">
+
+ <!-- Force the use of SAXON XSLT -->
+ <property system="true"
+ name="javax.xml.transform.TransformerFactory"
+ value="com.icl.saxon.TransformerFactoryImpl"/>
<mkdir dir="${build.pdf}"/>
- <style basedir="${build.docs}"
- destdir="${build.pdf}"
- style="${oasis.docbook.xsl.root}/fo/docbook.xsl"
- extension=".fo">
+ <style style="${oasis.docbook.xsl.root}/fo/docbook.xsl"
+ processor="trax"
+ extension=".fo"
+ basedir="${build.xdocs}"
+ destdir="${build.pdf}">
<include name="jbossdocs.xml"/>
</style>
@@ -322,7 +383,6 @@
<copy todir="${release.manual}" filtering="no">
<fileset dir="${module.build}">
<include name="html/**/*"/>
- <include name="html-printable/**/*"/>
<include name="pdf/**/*.pdf"/>
</fileset>
</copy>
@@ -403,7 +463,7 @@
description="Builds everything."/>
<target name="most" depends="docs"
- description="Builds html and printable html"/>
+ description="Builds almost everything."/>
<target name="min" depends="compile"
description="Builds a minimal subset."/>
_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
http://lists.sourceforge.net/lists/listinfo/jboss-development
