From: <jbo...@li...> - 2006-05-17 22:48:51
|
Author: KrisVerlaenen Date: 2006-05-17 18:48:42 -0400 (Wed, 17 May 2006) New Revision: 4296 Modified: labs/jbossrules/trunk/documentation/manual/build.xml Log: generating eclipse help Modified: labs/jbossrules/trunk/documentation/manual/build.xml =================================================================== --- labs/jbossrules/trunk/documentation/manual/build.xml 2006-05-17 22:46:09 UTC (rev 4295) +++ labs/jbossrules/trunk/documentation/manual/build.xml 2006-05-17 22:48:42 UTC (rev 4296) @@ -1,220 +1,220 @@ -<!-- - To build the reference docs for a particular language only, use "ant -Dlang=en", for - example, and call either lang.all, lang.docpdf, lang.dochtml, or lang.dochtmlsingle - for the target of your choice. - - You can also call lang.section-check to track down missing identifiers in a particular - language, or you can call lang.revdiff to get a difference report for a particular - language, compared with the English reference. ---> -<project name="ReferenceDocumentation" default="all.doc" basedir="."> - <!-- Allow this to be overriden by others importing this project. --> - <dirname property="imported.basedir" file="${ant.file.ReferenceDocumentation}"/> - - <!-- Set build directories for all formats. --> - <property name="build.dir" value="${basedir}/build"/> - - <!-- Support files for build process. --> - <property name="support.dir" value="${imported.basedir}/support"/> - - <!-- Base name for documentation artifacts. --> - <property name="docname" value="drools"/> - - <!-- Set DocBook stylesheets. --> - <property name="db.style.fopdf" value="fopdf.xsl"/> - <property name="db.style.eclipse" value="eclipse.xsl"/> - <property name="db.style.html" value="html_chunk.xsl"/> - <property name="db.style.htmlsingle" value="html.xsl"/> - - <!-- Classpath for the build tools. --> - <path id="lib.classpath"> - <fileset dir="${support.dir}/lib"> - <include name="**/*.jar"/> - </fileset> - </path> - - <!-- ################################################################## --> - - <target name="all.doc" - depends="clean" - description="Compile documentation for all languages and all formats."> - - <!-- TRANSLATOR: Duplicate this line for your language --> - <antcall target="lang.all"><param name="lang" value="en"/></antcall> - - </target> - - <target name="all.revdiff" - description="Generates a diff report for all translated versions."> - - <!-- TRANSLATOR: Duplicate this line for your language --> - <antcall target="lang.revdiff"><param name="lang" value="zh-cn"/></antcall> - <antcall target="lang.revdiff"><param name="lang" value="es"/></antcall> - <antcall target="lang.revdiff"><param name="lang" value="ko"/></antcall> - - </target> - - <!-- ################################################################## --> - - <target name="clean"> - - <!-- Delete build directory. --> - <!--delete dir="${build.dir}"/--> - - </target> - - <target name="lang.all"> - <!-- Compile the documentation for a single language in all formats. --> - <antcall target="lang.misc"/> - <!--antcall target="lang.docpdf"/--> - <antcall target="lang.dochtml"/> - <antcall target="lang.dochtmlsingle"/> - <!--antcall target="lang.doceclipse"/--> - </target> - - <target name="lang.docpdf.prepare"> - <!-- Create the XSL/FO temporary file. --> - <java classname="com.icl.saxon.StyleSheet" fork="true" dir="${basedir}" maxmemory="128m" > - <classpath refid="lib.classpath"/> - <sysproperty key="javax.xml.parsers.DocumentBuilderFactory" - value="org.apache.xerces.jaxp.DocumentBuilderFactoryImpl" /> - <sysproperty key="javax.xml.parsers.SAXParserFactory" - value="org.apache.xerces.jaxp.SAXParserFactoryImpl" /> - <sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration" - value="org.apache.xerces.parsers.XIncludeParserConfiguration" /> - <arg value="-o"/> - <arg value="${build.dir}/${lang}/pdf/drools.fo"/> - <arg value="${basedir}/${lang}/master.xml"/> - <arg value="${basedir}/${lang}/styles/${db.style.fopdf}"/> - </java> - - </target> - - <target name="lang.docpdf" depends="lang.docpdf.prepare"> - <!-- Create a PDF from the XSL/FO. --> - <java classname="org.apache.fop.cli.Main" fork="true" dir="${basedir}"> - <classpath refid="lib.classpath"/> - <arg value="-q"/> - <arg value="${build.dir}/${lang}/pdf/drools.fo"/> - <arg value="${build.dir}/${lang}/pdf/${docname}.pdf"/> - </java> - <!--delete> - <fileset dir="${build.dir}/${lang}/pdf" excludes="**/*.pdf"/> - </delete--> - </target> - - <target name="lang.dochtml" - description="Generates the HTML documentation only for a language (set lang)"> - - <mkdir dir="${build.dir}/${lang}/html/"/> - - <copy file="${basedir}/${lang}/index.html" todir="${build.dir}/${lang}/html"/> - - <copy todir="${build.dir}/${lang}/shared/images"> - <fileset dir="${basedir}/${lang}"> - <include name="**/*.png"/> - <include name="**/*.jpg"/> - <include name="**/*.png"/> - </fileset> - </copy> - - <java classname="com.icl.saxon.StyleSheet" fork="true" dir="${build.dir}/${lang}/html"> - <classpath refid="lib.classpath"/> - <sysproperty key="javax.xml.parsers.DocumentBuilderFactory" - value="org.apache.xerces.jaxp.DocumentBuilderFactoryImpl" /> - <sysproperty key="javax.xml.parsers.SAXParserFactory" - value="org.apache.xerces.jaxp.SAXParserFactoryImpl" /> - <sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration" - value="org.apache.xerces.parsers.XIncludeParserConfiguration" /> - <arg value="${basedir}/${lang}/master.xml"/> - <arg value="${basedir}/${lang}/styles/${db.style.html}"/> - </java> - </target> - - <target name="lang.dochtmlsingle" - description="Generates the single-page HTML documentation only for a language (set lang)"> - - <mkdir dir="${build.dir}/${lang}/html_single/"/> - - <java classname="com.icl.saxon.StyleSheet" fork="true" dir="${basedir}"> - <classpath refid="lib.classpath"/> - <sysproperty key="javax.xml.parsers.DocumentBuilderFactory" - value="org.apache.xerces.jaxp.DocumentBuilderFactoryImpl" /> - <sysproperty key="javax.xml.parsers.SAXParserFactory" - value="org.apache.xerces.jaxp.SAXParserFactoryImpl" /> - <sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration" - value="org.apache.xerces.parsers.XIncludeParserConfiguration" /> - <arg value="-o"/> - <arg value="${build.dir}/${lang}/html_single/index.html"/> - <arg value="${basedir}/${lang}/master.xml"/> - <arg value="${basedir}/${lang}/styles/${db.style.htmlsingle}"/> - </java> - </target> - - <target name="lang.doceclipse" - description="Generates the single-page HTML documentation only for a language (set lang)"> - - <mkdir dir="${build.dir}/${lang}/eclipse/"/> - - <java classname="com.icl.saxon.StyleSheet" fork="true" dir="${build.dir}/${lang}/eclipse"> - <classpath refid="lib.classpath"/> - <sysproperty key="javax.xml.parsers.DocumentBuilderFactory" - value="org.apache.xerces.jaxp.DocumentBuilderFactoryImpl" /> - <sysproperty key="javax.xml.parsers.SAXParserFactory" - value="org.apache.xerces.jaxp.SAXParserFactoryImpl" /> - <sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration" - value="org.apache.xerces.parsers.XIncludeParserConfiguration" /> - <arg value="${basedir}/${lang}/master.xml"/> - <arg value="${basedir}/${lang}/styles/${db.style.eclipse}"/> - </java> - </target> - - <target name="lang.misc"> - - <!-- Copy images and CSS for HTML documentation, language specific. --> - <copy todir="${build.dir}/${lang}/shared/images"> - <fileset dir="${basedir}/${lang}"> - <include name="**/*.png"/> - <include name="**/*.jpg"/> - <include name="**/*.png"/> - </fileset> - </copy> - <copy todir="${build.dir}/${lang}/shared/css"> - <fileset dir="${basedir}/${lang}/styles"> - <include name="**/*.css"/> - </fileset> - </copy> - - <!-- Fix and copy visio svg files --> - <style basedir="${basedir}/${lang}" destdir="${build.dir}/${lang}/shared/images" style="${basedir}/${lang}/styles/visio_svg.xsl" extension=".svg" force="true"> - <classpath refid="lib.classpath"/> - <include name="**/*.svg"/> - </style> - - </target> - - <target name="lang.revdiff" - description="Reports difference between English and translation (set lang)"> - - <taskdef name="revdiff" - classname="org.drools.docproc.revdiff.RevDiffReportTask" - classpathref="lib.classpath"> - - </taskdef> - - <revdiff original="${basedir}/en/master.xml" - copy="${basedir}/${lang}/master.xml" - report="${build.dir}/status_${lang}.html"/> - - </target> - - <target name="lang.section-check" depends="lang.dochtml" - description="Reports missing unique chapter/section identifiers (set lang)"> - <java classname="com.icl.saxon.StyleSheet" fork="true" dir="${build.dir}/${lang}/html"> - <classpath refid="lib.classpath"/> - <arg value="${basedir}/${lang}/master.xml"/> - <arg value="${support.dir}/section-check.xsl"/> - </java> - </target> - -</project> +<!-- + To build the reference docs for a particular language only, use "ant -Dlang=en", for + example, and call either lang.all, lang.docpdf, lang.dochtml, or lang.dochtmlsingle + for the target of your choice. + + You can also call lang.section-check to track down missing identifiers in a particular + language, or you can call lang.revdiff to get a difference report for a particular + language, compared with the English reference. +--> +<project name="ReferenceDocumentation" default="all.doc" basedir="."> + <!-- Allow this to be overriden by others importing this project. --> + <dirname property="imported.basedir" file="${ant.file.ReferenceDocumentation}"/> + + <!-- Set build directories for all formats. --> + <property name="build.dir" value="${basedir}/build"/> + + <!-- Support files for build process. --> + <property name="support.dir" value="${imported.basedir}/support"/> + + <!-- Base name for documentation artifacts. --> + <property name="docname" value="drools"/> + + <!-- Set DocBook stylesheets. --> + <property name="db.style.fopdf" value="fopdf.xsl"/> + <property name="db.style.eclipse" value="eclipse.xsl"/> + <property name="db.style.html" value="html_chunk.xsl"/> + <property name="db.style.htmlsingle" value="html.xsl"/> + + <!-- Classpath for the build tools. --> + <path id="lib.classpath"> + <fileset dir="${support.dir}/lib"> + <include name="**/*.jar"/> + </fileset> + </path> + + <!-- ################################################################## --> + + <target name="all.doc" + depends="clean" + description="Compile documentation for all languages and all formats."> + + <!-- TRANSLATOR: Duplicate this line for your language --> + <antcall target="lang.all"><param name="lang" value="en"/></antcall> + + </target> + + <target name="all.revdiff" + description="Generates a diff report for all translated versions."> + + <!-- TRANSLATOR: Duplicate this line for your language --> + <antcall target="lang.revdiff"><param name="lang" value="zh-cn"/></antcall> + <antcall target="lang.revdiff"><param name="lang" value="es"/></antcall> + <antcall target="lang.revdiff"><param name="lang" value="ko"/></antcall> + + </target> + + <!-- ################################################################## --> + + <target name="clean"> + + <!-- Delete build directory. --> + <!--delete dir="${build.dir}"/--> + + </target> + + <target name="lang.all"> + <!-- Compile the documentation for a single language in all formats. --> + <antcall target="lang.misc"/> + <!--antcall target="lang.docpdf"/--> + <antcall target="lang.dochtml"/> + <antcall target="lang.dochtmlsingle"/> + <antcall target="lang.doceclipse"/> + </target> + + <target name="lang.docpdf.prepare"> + <!-- Create the XSL/FO temporary file. --> + <java classname="com.icl.saxon.StyleSheet" fork="true" dir="${basedir}" maxmemory="128m" > + <classpath refid="lib.classpath"/> + <sysproperty key="javax.xml.parsers.DocumentBuilderFactory" + value="org.apache.xerces.jaxp.DocumentBuilderFactoryImpl" /> + <sysproperty key="javax.xml.parsers.SAXParserFactory" + value="org.apache.xerces.jaxp.SAXParserFactoryImpl" /> + <sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration" + value="org.apache.xerces.parsers.XIncludeParserConfiguration" /> + <arg value="-o"/> + <arg value="${build.dir}/${lang}/pdf/drools.fo"/> + <arg value="${basedir}/${lang}/master.xml"/> + <arg value="${basedir}/${lang}/styles/${db.style.fopdf}"/> + </java> + + </target> + + <target name="lang.docpdf" depends="lang.docpdf.prepare"> + <!-- Create a PDF from the XSL/FO. --> + <java classname="org.apache.fop.cli.Main" fork="true" dir="${basedir}"> + <classpath refid="lib.classpath"/> + <arg value="-q"/> + <arg value="${build.dir}/${lang}/pdf/drools.fo"/> + <arg value="${build.dir}/${lang}/pdf/${docname}.pdf"/> + </java> + <!--delete> + <fileset dir="${build.dir}/${lang}/pdf" excludes="**/*.pdf"/> + </delete--> + </target> + + <target name="lang.dochtml" + description="Generates the HTML documentation only for a language (set lang)"> + + <mkdir dir="${build.dir}/${lang}/html/"/> + + <copy file="${basedir}/${lang}/index.html" todir="${build.dir}/${lang}/html"/> + + <copy todir="${build.dir}/${lang}/shared/images"> + <fileset dir="${basedir}/${lang}"> + <include name="**/*.png"/> + <include name="**/*.jpg"/> + <include name="**/*.png"/> + </fileset> + </copy> + + <java classname="com.icl.saxon.StyleSheet" fork="true" dir="${build.dir}/${lang}/html"> + <classpath refid="lib.classpath"/> + <sysproperty key="javax.xml.parsers.DocumentBuilderFactory" + value="org.apache.xerces.jaxp.DocumentBuilderFactoryImpl" /> + <sysproperty key="javax.xml.parsers.SAXParserFactory" + value="org.apache.xerces.jaxp.SAXParserFactoryImpl" /> + <sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration" + value="org.apache.xerces.parsers.XIncludeParserConfiguration" /> + <arg value="${basedir}/${lang}/master.xml"/> + <arg value="${basedir}/${lang}/styles/${db.style.html}"/> + </java> + </target> + + <target name="lang.dochtmlsingle" + description="Generates the single-page HTML documentation only for a language (set lang)"> + + <mkdir dir="${build.dir}/${lang}/html_single/"/> + + <java classname="com.icl.saxon.StyleSheet" fork="true" dir="${basedir}"> + <classpath refid="lib.classpath"/> + <sysproperty key="javax.xml.parsers.DocumentBuilderFactory" + value="org.apache.xerces.jaxp.DocumentBuilderFactoryImpl" /> + <sysproperty key="javax.xml.parsers.SAXParserFactory" + value="org.apache.xerces.jaxp.SAXParserFactoryImpl" /> + <sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration" + value="org.apache.xerces.parsers.XIncludeParserConfiguration" /> + <arg value="-o"/> + <arg value="${build.dir}/${lang}/html_single/index.html"/> + <arg value="${basedir}/${lang}/master.xml"/> + <arg value="${basedir}/${lang}/styles/${db.style.htmlsingle}"/> + </java> + </target> + + <target name="lang.doceclipse" + description="Generates the single-page HTML documentation only for a language (set lang)"> + + <mkdir dir="${build.dir}/${lang}/eclipse/"/> + + <java classname="com.icl.saxon.StyleSheet" fork="true" dir="${build.dir}/${lang}/eclipse"> + <classpath refid="lib.classpath"/> + <sysproperty key="javax.xml.parsers.DocumentBuilderFactory" + value="org.apache.xerces.jaxp.DocumentBuilderFactoryImpl" /> + <sysproperty key="javax.xml.parsers.SAXParserFactory" + value="org.apache.xerces.jaxp.SAXParserFactoryImpl" /> + <sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration" + value="org.apache.xerces.parsers.XIncludeParserConfiguration" /> + <arg value="${basedir}/${lang}/master.xml"/> + <arg value="${basedir}/${lang}/styles/${db.style.eclipse}"/> + </java> + </target> + + <target name="lang.misc"> + + <!-- Copy images and CSS for HTML documentation, language specific. --> + <copy todir="${build.dir}/${lang}/shared/images"> + <fileset dir="${basedir}/${lang}"> + <include name="**/*.png"/> + <include name="**/*.jpg"/> + <include name="**/*.png"/> + </fileset> + </copy> + <copy todir="${build.dir}/${lang}/shared/css"> + <fileset dir="${basedir}/${lang}/styles"> + <include name="**/*.css"/> + </fileset> + </copy> + + <!-- Fix and copy visio svg files --> + <style basedir="${basedir}/${lang}" destdir="${build.dir}/${lang}/shared/images" style="${basedir}/${lang}/styles/visio_svg.xsl" extension=".svg" force="true"> + <classpath refid="lib.classpath"/> + <include name="**/*.svg"/> + </style> + + </target> + + <target name="lang.revdiff" + description="Reports difference between English and translation (set lang)"> + + <taskdef name="revdiff" + classname="org.drools.docproc.revdiff.RevDiffReportTask" + classpathref="lib.classpath"> + + </taskdef> + + <revdiff original="${basedir}/en/master.xml" + copy="${basedir}/${lang}/master.xml" + report="${build.dir}/status_${lang}.html"/> + + </target> + + <target name="lang.section-check" depends="lang.dochtml" + description="Reports missing unique chapter/section identifiers (set lang)"> + <java classname="com.icl.saxon.StyleSheet" fork="true" dir="${build.dir}/${lang}/html"> + <classpath refid="lib.classpath"/> + <arg value="${basedir}/${lang}/master.xml"/> + <arg value="${support.dir}/section-check.xsl"/> + </java> + </target> + +</project> |