| <?xml version="1.0"?> |
| |
| <!-- =========================================================================== |
| |
| |
| * ================= * |
| | How to build Fop | |
| * ================= * |
| |
| Adaption from the Cocoon build.xml written by Stefano Mazzocchi |
| by Giacomo Pati with some addition by Fotis Jannidis |
| |
| |
| Introduction |
| ============ |
| |
| FOP is the world's first print formatter driven by XSL formatting objects. It |
| is a Java 1.2 application that reads a formatting object tree and then turns |
| it into a PDF document. The formatting object tree, can be in the form of an |
| XML document (output by an XSLT engine like Xalan) or can be passed in |
| memory as a DOM Document or SAX events. |
| |
| FOP is part of Apache's XML project. The homepage of FOP is |
| http:/xml.apache.org/fop |
| |
| HTML-Documentation can be found in the subdirectory ./docs. |
| |
| |
| Installing the build tools |
| ========================== |
| |
| The Fop build system is based on Jakarta Ant, which is a Java building tool |
| originally developed for the Jakarta Tomcat project but now used in many other |
| Apache projects and extended by many developers. |
| |
| Ant is a little but very handy tool that uses a build file written in XML |
| (this file) as building instructions. For more information refer to |
| "http://jakarta.apache.org/ant/". |
| |
| To make things easier for you, the Fop distribution contains a |
| precompiled version of Ant and the build scripts take care of all the |
| classpath issues except the following: |
| |
| You need to have xerces.jar and xalan.jar in your classpath. You can get |
| those from http://xml.apache.org/xerces and http://xml.apache.org/xalan |
| respectively. |
| |
| Additionaly you have to make sure, that the "JAVA_HOME" environment |
| property should be set to match the JVM you want to use. That's it. |
| |
| |
| Building instructions |
| ===================== |
| |
| First, make sure your current working directory is where this very file is |
| located. Then type |
| |
| ./build.sh (unix) |
| .\build.bat (win32) |
| |
| if everything is right and all the required packages are visible, this action |
| will generate a file called "fop.jar" in the "./build" directory. Note, that |
| if you do further development, compilation time is reduced since Ant is able |
| to detect which files have changed an to recompile them at need. |
| |
| If something went wrong, go to the FAQ section below. |
| |
| Also, you'll note that reusing a single JVM instance for each task, increases |
| tremendously the performance of the whole build system, compared to other |
| tools (i.e. make or shell scripts) where a new JVM is started for each task. |
| |
| |
| Build targets |
| ============= |
| |
| The build system is not only responsible of compiling Fop into a jar file, |
| but is also responsible for creating the HTML documentation, javadocs, |
| distributions and web site. In fact, the file you have here is _exactly_ what |
| is used by fop maintainers to take care of everything in the Fop |
| project, no less and no more. (only partially implemented) |
| |
| These are the meaningful targets for this build file: |
| |
| - package [default] -> creates ./build/fop.jar |
| - usage -> shows a help screen |
| - codegen -> generates needed java sources from xml resources |
| - htmldoc -> generates the HTML documentation in ./build/docs/html-docs |
| - javadocs -> generates the API documentation in ./build/javadocs |
| - pdfdoc -> generates the PDF documentation in ./build/docs/xml-docs |
| - dist -> generates the Fop distribution |
| - clean -> restores the distribution to its original and clean state |
| (excepting dist files) |
| - distclean -> restores the distribution to its original and clean state |
| - site -> generates the web site in ../xml-site/targets/fop (not yet impl.) |
| |
| ====================================== FAQ ===================================== |
| |
| 1) Why some of the classes present in the original jar are not built anymore? |
| |
| The fop build system is very flexible: if a module requires a package that |
| is not present in the classpath at build time, the module is skipped but |
| the built process is not stopped. |
| |
| 2) I see a lot of warnings starting like this: "Warning: file modified in the future:" |
| Sometimes ant gives out this warnings, but the build is finished without any problems |
| |
| ============================================================================ --> |
| |
| <project default="package" basedir="."> |
| |
| <fileset dir="${basedir}" id="dist.bin"> |
| <include name="conf/**"/> |
| <include name="docs/**"/> |
| <include name="hyph/**"/> |
| <include name="CHANGES"/> |
| <include name="LICENSE"/> |
| <include name="README"/> |
| <include name="STATUS"/> |
| <include name="fop.bat"/> |
| <include name="fop.sh"/> |
| <exclude name="src/**"/> |
| <exclude name="dist/**"/> |
| <exclude name="build/**"/> |
| <exclude name="lib/**"/> |
| </fileset> |
| |
| <fileset dir="${basedir}" id="dist.bin.lib"> |
| <include name="lib/xerces-1.4.3.jar"/> |
| <include name="lib/xalan-2.2D11.jar"/> |
| <include name="lib/batik.jar"/> |
| <include name="lib/avalon-framework-cvs-20020315.jar"/> |
| <include name="lib/jimi*"/> |
| </fileset> |
| |
| <fileset dir="${basedir}" id="dist.src"> |
| <exclude name="lib/classes/**"/> |
| <exclude name="lib/org/**"/> |
| <exclude name="lib/src/**"/> |
| <exclude name="build/**"/> |
| <include name="src/**"/> |
| <include name="conf/**"/> |
| <include name="docs/**"/> |
| <include name="hyph/**"/> |
| <include name="lib/**"/> |
| <include name="CHANGES"/> |
| <include name="LICENSE"/> |
| <include name="README"/> |
| <include name="STATUS"/> |
| <include name="build*"/> |
| <include name="fop.bat"/> |
| <include name="fop.sh"/> |
| </fileset> |
| |
| <path id="libs-run-classpath"> |
| <fileset dir="lib"> |
| <include name="*.jar"/> |
| </fileset> |
| <fileset dir="build"> |
| <include name="fop.jar"/> |
| </fileset> |
| </path> |
| |
| <path id="libs-build-classpath"> |
| <fileset dir="lib"> |
| <include name="stylebook*.jar"/> |
| <include name="xalan*.jar"/> |
| <include name="xerces*.jar"/> |
| </fileset> |
| </path> |
| |
| <!-- =================================================================== --> |
| <!-- Initialization target --> |
| <!-- =================================================================== --> |
| <target name="init" depends="init-avail, init-filters-xalan2"> |
| <tstamp/> |
| <property name="Name" value="Fop"/> |
| <property name="name" value="fop"/> |
| <property name="version" value="1.0dev"/> |
| <filter token="version" value="${version}"/> |
| <property name="year" value="1999-2002"/> |
| |
| <echo message="------------------- ${Name} ${version} [${year}] ----------------"/> |
| |
| <property name="build.compiler" value="classic"/> |
| <property name="debug" value="on"/> |
| <property name="optimize" value="off"/> |
| <property name="deprecation" value="off"/> |
| |
| <property name="src.dir" value="./src"/> |
| <property name="src.codegen" value="./src/codegen"/> |
| <property name="docs.dir" value="./docs"/> |
| <property name="lib.dir" value="./lib"/> |
| <property name="hyph.dir" value="./hyph"/> |
| <property name="conf.dir" value="./conf"/> |
| <property name="packages" value="org.apache.fop.*"/> |
| |
| <property name="docs" value="docs/html-docs"/> |
| <property name="xdocs" value="docs/xml-docs"/> |
| <property name="skins" value="docs/xml-docs/skins/xml.apache.org/"/> |
| <property name="doc.generator" value="org.apache.stylebook.StyleBook"/> |
| <property name="doc.generator.package" value="${lib.dir}/stylebook-1.0-b2.jar"/> |
| |
| <property name="viewer.resources.src.dir" value="./src/org/apache/fop/viewer/resources"/> |
| <property name="viewer.images.src.dir" value="./src/org/apache/fop/viewer/Images"/> |
| |
| <property name="build.dir" value="./build"/> |
| <property name="build.src" value="./build/src"/> |
| <property name="build.codegen" value="./build/src/codegen"/> |
| <property name="build.dest" value="./build/classes"/> |
| <property name="build.docs" value="./build/docs"/> |
| <property name="build.javadocs" value="./build/javadocs"/> |
| |
| <property name="viewer.resources.dest.dir" value="${build.dest}/org/apache/fop/viewer/resources"/> |
| <property name="viewer.images.dest.dir" value="${build.dest}/org/apache/fop/viewer/Images"/> |
| |
| <!-- <property name="dist.dir" value="./dist"/> --> |
| <property name="dist.bin.dir" value="./dist-bin"/> |
| <property name="dist.src.dir" value="./dist-src"/> |
| <property name="dist.bin.result.dir" value="${dist.bin.dir}/${Name}-${version}"/> |
| <property name="dist.src.result.dir" value="${dist.src.dir}/${Name}-${version}"/> |
| |
| <property name="properties.dir" value="org/apache/fop/fo/properties"/> |
| <property name="fonts.dir" value="org/apache/fop/render/pdf/fonts"/> |
| <property name="svg.dir" value="org/apache/fop/svg"/> |
| <property name="replacestring" value="org/apache/fop"/> |
| <property name="ignore_this" value="ignore_this.java"/> |
| <property name="jimi" value="JimiImage.java"/> |
| <property name="jai" value="JAIImage.java"/> |
| |
| <property name="xslt" value="org.apache.xalan.xslt.Process"/> |
| <property name="src.properties.xsl" value="${src.codegen}/properties.xsl"/> |
| <property name="src.propmaker.xsl" value="${src.codegen}/propmaker.xsl"/> |
| <property name="foproperties.xml" value="${build.codegen}/foproperties.xml"/> |
| <property name="colorkw.xml" value="${build.codegen}/colorkw.xml"/> |
| <property name="allprops.xml" value="${build.codegen}/allprops.xml"/> |
| |
| <property name="properties.xsl" value="${build.codegen}/properties.xsl"/> |
| <property name="propmap.xsl" value="${build.codegen}/propmap.xsl"/> |
| <property name="enumgen.xsl" value="${build.codegen}/enumgen.xsl"/> |
| <property name="propinc.xsl" value="${build.codegen}/propinc.xsl"/> |
| <property name="genconst.xsl" value="${build.codegen}/genconst.xsl"/> |
| <property name="src.charlist.xsl" value="${src.codegen}/code-point-mapping.xsl"/> |
| <property name="charlist.xml" value="${build.codegen}/charlist.xml"/> |
| <property name="charlist.xsl" value="${build.codegen}/code-point-mapping.xsl"/> |
| <property name="fontfile.xsl" value="${build.codegen}/font-file.xsl"/> |
| <property name="t1fontfile.xsl" value="${build.codegen}/t1font-file.xsl"/> |
| <property name="ttffontfile.xsl" value="${build.codegen}/ttffontfile.xsl"/> |
| <property name="Courier.xml" value="${build.codegen}/Courier.xml"/> |
| <property name="Courier-Oblique.xml" value="${build.codegen}/Courier-Oblique.xml"/> |
| <property name="Courier-Bold.xml" value="${build.codegen}/Courier-Bold.xml"/> |
| <property name="Courier-BoldOblique.xml" value="${build.codegen}/Courier-BoldOblique.xml"/> |
| <property name="Helvetica.xml" value="${build.codegen}/Helvetica.xml"/> |
| <property name="Helvetica-Oblique.xml" value="${build.codegen}/Helvetica-Oblique.xml"/> |
| <property name="Helvetica-Bold.xml" value="${build.codegen}/Helvetica-Bold.xml"/> |
| <property name="Helvetica-BoldOblique.xml" value="${build.codegen}/Helvetica-BoldOblique.xml"/> |
| <property name="Times-Roman.xml" value="${build.codegen}/Times-Roman.xml"/> |
| <property name="Times-Italic.xml" value="${build.codegen}/Times-Italic.xml"/> |
| <property name="Times-Bold.xml" value="${build.codegen}/Times-Bold.xml"/> |
| <property name="Times-BoldItalic.xml" value="${build.codegen}/Times-BoldItalic.xml"/> |
| <property name="ZapfDingbats.xml" value="${build.codegen}/ZapfDingbats.xml"/> |
| <property name="Symbol.xml" value="${build.codegen}/Symbol.xml"/> |
| |
| <property name="trax" value="TraxTransform.java"/> |
| <property name="xsltransform" value="XSLTransform.java"/> |
| |
| <property name="tools.pkg" value="org/apache/fop/tools"/> |
| |
| |
| <!-- insert custom font information here (step 1 of 2) --> |
| <!-- use this as a template |
| <property name="myfont.xml" value="${build.codegen}/myfont.xml"/> |
| --> |
| |
| <taskdef name="serHyph" classname="org.apache.fop.tools.anttasks.SerializeHyphPattern"/> |
| <taskdef name="runTest" classname="org.apache.fop.tools.anttasks.RunTest"/> |
| |
| <property name="main.class" value="org.apache.fop.apps.Fop"/> |
| <property name="runtime.classpath" value="lib/xerces-1.4.3.jar lib/xalan-2.2D11.jar lib/batik.jar lib/jimi-1.0.jar lib/avalon-framework-cvs-20020315.jar"/> |
| |
| <filter filtersfile="${build.src}/codegen/filter"/> |
| |
| </target> |
| |
| <target name="init-avail"> |
| <available property="jimi.present" classname="com.sun.jimi.core.Jimi"/> |
| <available property="jai.present" classname="javax.media.jai.JAI"/> |
| |
| <available property="trax.present" classname="javax.xml.transform.Transformer"/> |
| <filter token="xalan2-replacestring" value="../../"/> |
| |
| </target> |
| |
| <target name="init-filters-xalan2" depends="init-avail" if="trax.present"> |
| <copy file="src/codegen/xalan2.filter" toFile="./build/src/codegen/filter" filtering="on"/> |
| </target> |
| |
| |
| <!-- =================================================================== --> |
| <!-- Help on usage --> |
| <!-- =================================================================== --> |
| <target name="usage"> |
| <echo message=""/> |
| <echo message=""/> |
| <echo message="${Name} Build file"/> |
| <echo message="-------------------------------------------------------------"/> |
| <echo message=""/> |
| <echo message=" available targets are:"/> |
| <echo message=""/> |
| <echo message=" package --> generates the ${name}.jar file (default)"/> |
| <echo message=" codegen --> generates the java files from the xml resources"/> |
| <echo message=" compile --> compiles the source code"/> |
| <echo message=" htmldoc --> generates the HTML documentation"/> |
| <echo message=" javadocs --> generates the API documentation (java 1.2 only)"/> |
| <echo message=" pdfdoc --> generates the PDF documentation"/> |
| <echo message=" dist --> generates the ${Name} distribution as .tar.gz and .zip"/> |
| <echo message=" clean --> cleans up the directory (except for the dist files)"/> |
| <echo message=" distclean --> cleans up the directory"/> |
| <echo message=" site --> generates the ${Name} web site (not yet implemented)"/> |
| <echo message=""/> |
| <echo message=" See the comments inside the build.xml file for more details."/> |
| <echo message="-------------------------------------------------------------"/> |
| <echo message=""/> |
| <echo message=""/> |
| </target> |
| |
| <!-- =================================================================== --> |
| <!-- Prepares the build directory --> |
| <!-- =================================================================== --> |
| <target name="prepare" depends="init"> |
| <!-- create directories --> |
| <echo message="Preparing the build directories"/> |
| <mkdir dir="${build.dir}"/> |
| <mkdir dir="${build.src}"/> |
| <mkdir dir="${build.src}/${properties.dir}"/> |
| <mkdir dir="${build.src}/${fonts.dir}"/> |
| <mkdir dir="${build.src}/${svg.dir}"/> |
| <mkdir dir="${build.dest}/conf"/> |
| <mkdir dir="${build.dest}/hyph"/> |
| <copy todir="${build.dest}/conf" filtering="yes"> |
| <fileset dir="./conf"/> |
| </copy> |
| </target> |
| |
| <!-- =================================================================== --> |
| <!-- compiles hyphenation patterns --> |
| <!-- =================================================================== --> |
| |
| <target name="hyphenation" depends="prepare" > |
| <serHyph includes="*.xml" |
| sourceDir="./hyph" |
| targetDir="${build.dest}/hyph" /> |
| </target> |
| |
| <!-- =================================================================== --> |
| <!-- copies special image class only if Jimi library is present --> |
| <!-- =================================================================== --> |
| <target name="prepare-jimi" depends="prepare" if="jimi.present"> |
| <echo message="Jimi library is present. Fop installs jimi support."/> |
| <copy todir="${build.src}"> |
| <fileset dir="${src.dir}" includes="**/${jimi}"/> |
| </copy> |
| </target> |
| |
| <!-- =================================================================== --> |
| <!-- copies special image class only if JAI library is present --> |
| <!-- =================================================================== --> |
| <target name="prepare-jai" depends="prepare" if="jai.present"> |
| <echo message="JAI library is present. Fop installs JAI support."/> |
| <copy todir="${build.src}"> |
| <fileset dir="${src.dir}" includes="**/${jai}"/> |
| </copy> |
| </target> |
| |
| <target name="prepare-trax" if="trax.present"> |
| <echo message="JAXP1.1 transforms is present. Installing TRaX support"/> |
| <copy todir="${build.src}"> |
| <fileset dir="${src.dir}" includes="**/${xsltransform},**/${trax},**/apps/TraxInputHandler.java"/> |
| </copy> |
| </target> |
| |
| |
| <!-- =================================================================== --> |
| <!-- Prepares the source code --> |
| <!-- =================================================================== --> |
| <target name="prepare-src" depends="prepare, prepare-jimi, prepare-jai, prepare-trax"> |
| <!-- copy src files --> |
| <copy todir="${build.src}"> |
| <fileset dir="${src.dir}" |
| excludes="**/Makefile*, **/package.html, **/${jimi},**/${jai},**/${xsltransform},**/${trax},**/apps/TraxInputHandler.java"/> |
| </copy> |
| </target> |
| |
| <!-- =================================================================== --> |
| <!-- Generate the source code --> |
| <!-- =================================================================== --> |
| <target name="codegen" depends="prepare"> |
| <!-- resetting codegen directory --> |
| <echo message="Resetting codegen directory"/> |
| |
| <!-- copy codegen directory --> |
| <copy todir="${build.codegen}" filtering="on"> |
| <fileset dir="${src.codegen}"/> |
| </copy> |
| |
| <!-- generate the java files from xml resources --> |
| <echo message="Generating the java files from xml resources"/> |
| <dependset> |
| <srcfilelist dir="./" files="${foproperties.xml},${colorkw.xml}"/> |
| <targetfilelist dir="./" files="${build.src}/${replacestring}/fo/properties/Constants.java,${build.src}/${replacestring}/fo/properties/fo_${ignore_this}"/> |
| </dependset> |
| <dependset> |
| <srcfilelist dir="./" files="${propinc.xsl}"/> |
| <targetfilelist dir="./" files="${build.src}/${replacestring}/fo/properties/fo_${ignore_this},${build.src}/${replacestring}/fo/properties/FOPropertyMapping.java,${build.src}/${replacestring}/fo/properties/foenums_${ignore_this}"/> |
| </dependset> |
| |
| <style in="${allprops.xml}" style="${genconst.xsl}" |
| out="${build.src}/${replacestring}/fo/properties/Constants.java"/> |
| |
| <style in="${foproperties.xml}" style="${properties.xsl}" |
| out="${build.src}/${replacestring}/fo/properties/fo_${ignore_this}"/> |
| <style in="${foproperties.xml}" style="${propmap.xsl}" |
| out="${build.src}/${replacestring}/fo/properties/FOPropertyMapping.java"/> |
| <style in="${foproperties.xml}" style="${enumgen.xsl}" |
| out="${build.src}/${replacestring}/fo/properties/foenums_${ignore_this}"/> |
| |
| <style in="${charlist.xml}" style="${charlist.xsl}" |
| out="${build.src}/${replacestring}/render/pdf/CodePointMapping.java"/> |
| |
| <style basedir="src/codegen" includes="*.xml" |
| excludes="allprops.xml,charlist.xml,colorkw.xml,*prop*" style="${fontfile.xsl}" |
| destdir="${build.src}/${replacestring}/render/pdf/fonts/" extension=".java"/> |
| |
| <!-- custom fonts (Use t1fontfile.xsl instead of fontfile.xsl for Type 1 fonts!) step 2/2 --> |
| <!-- use this as a template for type 1 fonts: |
| <style in="${myfont.xml}" style="${t1fontfile.xsl}" |
| out="${build.src}/${replacestring}/render/pdf/fonts/myfont.java"/> |
| --> |
| <!-- use this as a template for truetype fonts |
| <style in="${myfont.xml}" style="${ttffontfile.xsl}" |
| out="${build.src}/${replacestring}/render/pdf/fonts/myfont.java"/> |
| --> |
| |
| </target> |
| |
| <!-- =================================================================== --> |
| <!-- Compiles the source directory --> |
| <!-- =================================================================== --> |
| <target name="compile" depends="codegen, prepare-src"> |
| <echo message="Compiling the sources "/> |
| <!-- create directories --> |
| <mkdir dir="${build.dest}"/> |
| |
| <mkdir dir="${viewer.resources.dest.dir}"/> |
| <copy todir="${viewer.resources.dest.dir}"> |
| <fileset dir="${viewer.resources.src.dir}"/> |
| </copy> |
| <mkdir dir="${viewer.images.dest.dir}"/> |
| <copy todir="${viewer.images.dest.dir}"> |
| <fileset dir="${viewer.images.src.dir}"/> |
| </copy> |
| |
| <javac srcdir="${build.src}" |
| destdir="${build.dest}" |
| debug="${debug}" |
| deprecation="${deprecation}" |
| optimize="${optimize}" |
| excludes="**/*${ignore_this},${jimi}"/> |
| </target> |
| |
| <!-- =================================================================== --> |
| <!-- Creates the class package --> |
| <!-- =================================================================== --> |
| <target name="package" depends="compile,hyphenation"> |
| <echo message="Creating the jar file ${build.dir}/${name}.jar"/> |
| <tstamp> |
| <format property="ts" pattern="yyyyMMdd-HHmmss-z"/> |
| </tstamp> |
| <jar jarfile="${build.dir}/${name}.jar" |
| basedir="${build.dest}" |
| includes="org/**,conf/**,hyph/**"> |
| <manifest> |
| <attribute name="Main-Class" value="${main.class}"/> |
| <attribute name="Class-Path" value="${runtime.classpath}"/> |
| <attribute name="Implementation-Title" value="${Name}"/> |
| <attribute name="Implementation-Version" value="${version}"/> |
| <attribute name="Implementation-Vendor" value="Apache Software Foundation (http://xml.apache.org/fop/)"/> |
| <attribute name="Build-Id" value="${ts} (${user.name} [${os.name} ${os.version} ${os.arch}])"/> |
| </manifest> |
| </jar> |
| </target> |
| |
| <target name="test" depends="package"> |
| <echo message="Testing build in jar file ${build.dir}/${name}.jar against reference"/> |
| <runTest testSuite="basictests.xml" basedir="test/" reference="test/reference/fop.jar" |
| refVersion="FOP 1.0dev"/> |
| <runTest testSuite="bugtests.xml" basedir="test/" reference="test/reference/fop.jar" |
| refVersion="FOP 1.0dev"/> |
| <!-- |
| <runTest testSuite="testsuite.xml" basedir="TestSuite/NIST/" reference="test/reference/fop.jar" |
| refVersion="FOP 1.0dev"/> |
| <runTest testSuite="testsuite.xml" basedir="TestSuite/contrib/IBM/" reference="test/reference/fop.jar" |
| refVersion="FOP 1.0dev"/> |
| <runTest testSuite="testsuite.xml" basedir="TestSuite/contrib/FOP/" reference="test/reference/fop.jar" |
| refVersion="FOP 1.0dev"/> |
| <runTest testSuite="testsuite.xml" basedir="TestSuite/contrib/XEP/" reference="test/reference/fop.jar" |
| refVersion="FOP 1.0dev"/> |
| <runTest testSuite="testsuite.xml" basedir="TestSuite/contrib/XSLFormatter/" reference="test/reference/fop.jar" |
| refVersion="FOP 1.0dev"/> |
| --> |
| </target> |
| |
| <target name="all" depends="package"/> <!-- "all" target for us Makefile converts ;-) --> |
| |
| <!-- =================================================================== --> |
| <!-- Prepares the docs --> |
| <!-- =================================================================== --> |
| <target name="prepare-docs" depends="init"> |
| <mkdir dir="${build.docs}"/> |
| <!-- sets exec permission for antRun on Unix systems. necessary for javadoc--> |
| <chmod file="${lib.dir}/bin/antRun" perm="ugo+rx" /> |
| </target> |
| |
| |
| <!-- =================================================================== --> |
| <!-- Creates the API documentation --> |
| <!-- =================================================================== --> |
| <target name="javadocs" depends="prepare-src"> |
| <echo message="Producing the javadoc files "/> |
| <mkdir dir="${build.javadocs}"/> |
| <javadoc packagenames="${packages}" |
| sourcepath="${build.src}" |
| destdir="${build.javadocs}" |
| author="true" |
| version="true" |
| windowtitle="${Name} API" |
| doctitle="${Name}" |
| bottom="Copyright © ${year} Apache Software Foundation. All Rights Reserved." |
| /> |
| </target> |
| |
| <target name="html" depends="javadocs, htmldoc"/> |
| |
| <target name="htmldoc" depends= "html-fop, html-design"/> |
| |
| <target name="html-fop" depends="prepare-src"> |
| <copy file="${xdocs}/fop.xml" |
| tofile="${xdocs}/book.xml" |
| filtering="on"/> |
| <java classname="${doc.generator}" fork="yes"> |
| <classpath refid="libs-build-classpath"/> |
| <arg line="targetDirectory=${docs} ${xdocs}/book.xml ${skins}"/> |
| </java> |
| </target> |
| |
| <target name="html-design" depends="prepare-src, html-newdesign, |
| html-altdesign, html-understanding"/> |
| |
| <target name="html-newdesign" depends="prepare-src"> |
| <java classname="${doc.generator}" fork="yes"> |
| <classpath refid="libs-build-classpath"/> |
| <arg line="targetDirectory=${docs}/design/ docs/design/book.xml ${skins}"/> |
| </java> |
| </target> |
| |
| <target name="html-altdesign" depends="prepare-src"> |
| <java classname="${doc.generator}" fork="yes"> |
| <classpath refid="libs-build-classpath"/> |
| <arg line="targetDirectory=${docs}/design/alt.design/ docs/design/alt.design/book.xml ${skins}"/> |
| </java> |
| </target> |
| |
| <target name="html-understanding" depends="prepare-src"> |
| <java classname="${doc.generator}" fork="yes"> |
| <classpath refid="libs-build-classpath"/> |
| <arg line="targetDirectory=${docs}/design/understanding docs/design/understanding/book.xml ${skins}"/> |
| </java> |
| </target> |
| |
| <target name="pdfdoc" depends="package"> |
| <copy file="${xdocs}/fop.xml" |
| tofile="${xdocs}/book.xml" |
| filtering="on"/> |
| <style in="${xdocs}/fop.xml" style="${xdocs}/xml2xml.xsl" out="${xdocs}/fop-doc.xml"/> |
| <style in="${xdocs}/fop-doc.xml" style="${xdocs}/xml2pdf.xsl" out="${xdocs}/fop.fo"/> |
| |
| <java classname="org.apache.fop.apps.Fop" fork="yes"> |
| <classpath refid="libs-run-classpath"/> |
| <arg line="-fo ${xdocs}/fop.fo -pdf ${xdocs}/fop.pdf"/> |
| </java> |
| </target> |
| |
| <!-- =================================================================== --> |
| <!-- Creates the distribution --> |
| <!-- =================================================================== --> |
| <target name="dist" depends="dist-src,dist-bin"/> |
| |
| <target name="dist-bin" depends="package"> |
| <echo message="Building the binary distribution files (zip,tar)"/> |
| <mkdir dir="${dist.bin.result.dir}"/> |
| <copy todir="${dist.bin.result.dir}"> |
| <fileset refid="dist.bin"/> |
| <fileset refid="dist.bin.lib"/> |
| </copy> |
| <mkdir dir="${dist.bin.result.dir}/build"/> |
| <copy todir="${dist.bin.result.dir}/build" file="build/fop.jar"/> |
| <chmod file="${dist.bin.result.dir}/fop.sh" perm="ugo+rx" /> |
| |
| <zip zipfile="${Name}-${version}-bin.zip" basedir="${dist.bin.dir}" includes="**"/> |
| <tar tarfile="${Name}-${version}-bin.tar" basedir="${dist.bin.dir}" includes="**"/> |
| <gzip zipfile="${Name}-${version}-bin.tar.gz" src="${Name}-${version}-bin.tar" /> |
| <delete file="${Name}-${version}-bin.tar"/> |
| |
| </target> |
| |
| <target name="dist-src" depends="package, javadocs"> |
| <echo message="Building the source distribution files (zip,tar)"/> |
| <mkdir dir="${dist.src.result.dir}"/> |
| <copy todir="${dist.src.result.dir}"> |
| <fileset refid="dist.src"/> |
| </copy> |
| <copy todir="${dist.src.result.dir}/javadocs"> |
| <fileset dir="${build.javadocs}"/> |
| </copy> |
| <mkdir dir="${dist.src.result.dir}/build"/> |
| <copy todir="${dist.src.result.dir}/build" file="build/fop.jar"/> |
| <chmod file="${dist.src.result.dir}/build.sh" perm="ugo+rx" /> |
| <chmod file="${dist.src.result.dir}/fop.sh" perm="ugo+rx" /> |
| |
| <zip zipfile="${Name}-${version}-src.zip" basedir="${dist.src.dir}" includes="**"/> |
| <tar tarfile="${Name}-${version}-src.tar" basedir="${dist.src.dir}" includes="**"/> |
| <gzip zipfile="${Name}-${version}-src.tar.gz" src="${Name}-${version}-src.tar" /> |
| <delete file="${Name}-${version}-src.tar"/> |
| |
| </target> |
| |
| <!-- =================================================================== --> |
| <!-- Clean targets --> |
| <!-- =================================================================== --> |
| <target name="clean" depends="init"> |
| <delete dir="${build.dir}"/> |
| </target> |
| |
| <target name="distclean" depends="clean"> |
| <delete dir="${dist.src.dir}"/> |
| <delete dir="${dist.bin.dir}"/> |
| <delete> |
| <fileset dir="${basedir}" includes="${Name}-*.tar.gz"/> |
| <fileset dir="${basedir}" includes="${Name}-*.zip"/> |
| </delete> |
| </target> |
| |
| </project> |
| |
