|
Lines 16-296
Link Here
|
| 16 |
]> |
16 |
]> |
| 17 |
<project name="build-docs" default="dist" basedir="."> |
17 |
<project name="build-docs" default="dist" basedir="."> |
| 18 |
|
18 |
|
| 19 |
<property name="project.name" value="build-docs"/> |
19 |
<property name="project.name" value="build-docs" /> |
| 20 |
|
20 |
|
| 21 |
<target name="product" depends="local-dist"/> |
21 |
<target name="product" depends="local-dist" /> |
| 22 |
<target name="clean" |
22 |
<target name="clean" depends="clean-directories,clean-doc-directories" /> |
| 23 |
depends="clean-directories,clean-doc-directories"/> |
23 |
|
| 24 |
|
24 |
<!-- ===================================================================== --> |
| 25 |
<!-- ===================================================================== --> |
25 |
<!-- Init --> |
| 26 |
<!-- Init --> |
26 |
<!-- ===================================================================== --> |
| 27 |
<!-- ===================================================================== --> |
|
|
| 28 |
|
27 |
|
| 29 |
&build-properties; |
28 |
&build-properties; |
| 30 |
|
29 |
|
| 31 |
<target name="init" depends="init-properties,init-directories"> |
30 |
<target name="init" depends="init-properties,init-directories"> |
| 32 |
|
31 |
|
| 33 |
<property name="docs.src.pattern" |
32 |
<property name="docs.src.pattern" value="**/*.xml,**/*.html,**/*.doc,**/*.gif,**/*.java,**/*.lst,**/*.pdf" /> |
| 34 |
value="**/*.xml,**/*.html,**/*.doc,**/*.gif,**/*.java,**/*.lst,**/*.pdf"/> |
33 |
<property name="docs.src.dir" location="${aspectj.modules.docs.dir}" /> |
| 35 |
<property name="docs.src.dir" |
34 |
|
| 36 |
location="${aspectj.modules.docs.dir}"/> |
35 |
<property name="docs.dist.dir" location="${aj.dist.dir}/docs" /> |
| 37 |
|
36 |
<property name="docs.temp.dir" location="${aj.temp.dir}/doc" /> |
| 38 |
<property name="docs.dist.dir" location="${aj.dist.dir}/docs"/> |
37 |
<property name="web.doc.dir" location="${aj.webDeploy.dir}/documentation/dist" /> |
| 39 |
<property name="docs.temp.dir" location="${aj.temp.dir}/doc"/> |
38 |
|
| 40 |
<property name="web.doc.dir" location="${aj.webDeploy.dir}/documentation/dist"/> |
39 |
<property name="docs.product.name" value="aspectj-docs-${build.version}" /> |
| 41 |
|
40 |
|
| 42 |
<property name="docs.product.name" |
41 |
<property name="docs.product.zip" location="${aj.dist.dir}/${docs.product.name}.zip" /> |
| 43 |
value="aspectj-docs-${build.version}"/> |
42 |
<!-- must specify (not *.gif) to not delete other gifs during build-in-place --> |
| 44 |
|
43 |
<!-- to find refs: gp ax imagedata | sed -n 's|.*\=\"\(..*\)\".*|\1|p' --> |
| 45 |
<property name="docs.product.zip" |
44 |
<property name="devguide.icons.dir" location="${aspectj.modules.dir}/ajde/src/org/aspectj/ajde/resources/actions" /> |
| 46 |
location="${aj.dist.dir}/${docs.product.name}.zip"/> |
45 |
<property name="include.devguide.icons" value="build.gif,openConfig.gif,browseroptions.gif" /> |
| 47 |
<!-- must specify (not *.gif) to not delete other gifs during build-in-place --> |
46 |
|
| 48 |
<!-- to find refs: gp ax imagedata | sed -n 's|.*\=\"\(..*\)\".*|\1|p' --> |
47 |
<!-- callers of xml-html use these by default --> |
| 49 |
<property name="devguide.icons.dir" |
48 |
<property name="chunk.xsl.source" location="${aspectj.modules.lib.dir}/docbook/docbook-xsl/html/chunk.xsl" /> |
| 50 |
location="${aspectj.modules.dir}/ajde/src/org/aspectj/ajde/resources/actions"/> |
49 |
<property name="nochunk.xsl.source" location="${aspectj.modules.lib.dir}/docbook/docbook-xsl/html/docbook.xsl" /> |
| 51 |
<property name="include.devguide.icons" |
50 |
<!-- default xml-html nochunking file (0-length dummy created when chunking) --> |
| 52 |
value="build.gif,openConfig.gif,browseroptions.gif" /> |
51 |
<property name="xml-target-file" location="${docs.temp.dir}/xml-target-file.dummy" /> |
| 53 |
|
52 |
<!-- default value for xml-html copying (copy all graphics) --> |
| 54 |
<!-- callers of xml-html use these by default --> |
53 |
<property name="xml-html-copy" value="*.gif,*.png" /> |
| 55 |
<property name="chunk.xsl.source" |
54 |
<property name="binary.pattern" value="**/*.gif,**/*.png,**/*.doc,**/*.pdf,**/*.jpg,**/*.JPG" /> |
| 56 |
location="${aspectj.modules.lib.dir}/docbook/docbook-xsl/html/chunk.xsl"/> |
55 |
<uptodate property="local.dist.uptodate" targetfile="${docs.dist.dir}/doc/faq.html"> |
| 57 |
<property name="nochunk.xsl.source" |
56 |
<!-- use faq as tag file --> |
| 58 |
location="${aspectj.modules.lib.dir}/docbook/docbook-xsl/html/docbook.xsl"/> |
57 |
<srcfiles dir="${docs.src.dir}" includes="${docs.src.pattern}" /> |
| 59 |
<!-- default xml-html nochunking file (0-length dummy created when chunking) --> |
58 |
</uptodate> |
| 60 |
<property name="xml-target-file" |
59 |
<uptodate property="dist.uptodate" targetfile="${docs.product.zip}"> |
| 61 |
location="${docs.temp.dir}/xml-target-file.dummy"/> |
60 |
<!-- use zip as tag file --> |
| 62 |
<!-- default value for xml-html copying (copy all graphics) --> |
61 |
<srcfiles dir="${docs.src.dir}" includes="${docs.src.pattern}" /> |
| 63 |
<property name="xml-html-copy" value="*.gif,*.png" /> |
62 |
<srcfiles dir="${docs.dist.dir}" includes="${docs.src.pattern}" /> |
| 64 |
<property name="binary.pattern" |
63 |
</uptodate> |
| 65 |
value="**/*.gif,**/*.png,**/*.doc,**/*.pdf,**/*.jpg,**/*.JPG"/> |
64 |
|
| 66 |
<uptodate property="local.dist.uptodate" |
65 |
</target> |
| 67 |
targetfile="${docs.dist.dir}/doc/faq.html"> <!-- use faq as tag file --> |
66 |
|
| 68 |
<srcfiles dir="${docs.src.dir}" includes="${docs.src.pattern}"/> |
67 |
<target name="clean-doc-directories" depends="init" description="clean build dirs (including local deploy dir)"> |
| 69 |
</uptodate> |
68 |
<delete quiet="on"> |
| 70 |
<uptodate property="dist.uptodate" |
69 |
<fileset dir="${docs.dist.dir}" /> |
| 71 |
targetfile="${docs.product.zip}"> <!-- use zip as tag file --> |
70 |
<fileset dir="${docs.jar.dir}" /> |
| 72 |
<srcfiles dir="${docs.src.dir}" includes="${docs.src.pattern}"/> |
71 |
<fileset dir="${docs.temp.dir}" /> |
| 73 |
<srcfiles dir="${docs.dist.dir}" includes="${docs.src.pattern}"/> |
72 |
</delete> |
| 74 |
</uptodate> |
73 |
</target> |
| 75 |
|
74 |
|
| 76 |
</target> |
75 |
<target name="dist" depends="init,local-dist" description="create unused doc zip - see ../build/build.xml for installer" unless="dist.uptodate"> |
| 77 |
|
76 |
<delete file="${docs.product.zip}" /> |
| 78 |
<target name="clean-doc-directories" depends="init" |
77 |
<zip zipfile="${docs.product.zip}" basedir="${docs.dist.dir}" /> |
| 79 |
description="clean build dirs (including local deploy dir)"> |
78 |
|
| 80 |
<delete quiet="on"> |
79 |
<echo message="find doc zip in ${docs.product.zip}" /> |
| 81 |
<fileset dir="${docs.dist.dir}" /> |
80 |
</target> |
| 82 |
<fileset dir="${docs.jar.dir}" /> |
81 |
|
| 83 |
<fileset dir="${docs.temp.dir}" /> |
82 |
<target name="web.deploy.faqonly" depends="init,faq" description="deploy docs.dist.dir faq to web.doc.dir"> |
| 84 |
</delete> |
83 |
<copy todir="${web.doc.dir}" filtering="on"> |
| 85 |
</target> |
84 |
<fileset dir="${docs.dist.dir}/doc" includes="faq.html" /> |
| 86 |
|
85 |
</copy> |
| 87 |
<target name="dist" depends="init,local-dist" |
86 |
<stripnonbodyhtml srcdir="${web.doc.dir}" includes="faq.html" /> |
| 88 |
description="create unused doc zip - see ../build/build.xml for installer" |
87 |
<echo message="do link check on index and faq before release" /> |
| 89 |
unless="dist.uptodate"> |
88 |
</target> |
| 90 |
<delete file="${docs.product.zip}"/> |
89 |
|
| 91 |
<zip zipfile="${docs.product.zip}" |
90 |
<target name="web.deploy.faqindex" depends="init,dist" description="deploy built faq and index to web.doc.dir"> |
| 92 |
basedir="${docs.dist.dir}"/> |
91 |
<copy todir="${web.doc.dir}" filtering="on"> |
| 93 |
|
92 |
<fileset dir="${docs.dist.dir}/doc" includes="faq.html,index.html" /> |
| 94 |
<echo message="find doc zip in ${docs.product.zip}"/> |
93 |
</copy> |
| 95 |
</target> |
94 |
<stripnonbodyhtml srcdir="${web.doc.dir}" includes="faq.html,index.html" /> |
| 96 |
|
95 |
<echo message="do link check on index and faq before release" /> |
| 97 |
<target name="web.deploy.faqonly" depends="init,faq" |
96 |
</target> |
| 98 |
description="deploy docs.dist.dir faq to web.doc.dir"> |
97 |
|
| 99 |
<copy todir="${web.doc.dir}" filtering="on"> |
98 |
<target name="web.deploy" depends="web.deploy.README-11" /> |
| 100 |
<fileset dir="${docs.dist.dir}/doc" includes="faq.html"/> |
99 |
|
| 101 |
</copy> |
100 |
<target name="web.deploy.README-11" depends="init" description="deploy README-11.html to the web site"> |
| 102 |
<stripnonbodyhtml srcdir="${web.doc.dir}" |
101 |
<property name="readme11.dir" location="${web.doc.dir}/documentation/readme11" /> |
| 103 |
includes="faq.html" /> |
102 |
<mkdir dir="${readme11.dir}" /> |
| 104 |
<echo message="do link check on index and faq before release"/> |
103 |
<delete file="${readme11.dir}/index.html" /> |
| 105 |
</target> |
104 |
<mkdir dir="${readme11.dir}" /> |
| 106 |
|
105 |
<copy tofile="${readme11.dir}/index.html" file="${aspectj.products.dir}/tools/dist/README-11.html" filtering="on" /> |
| 107 |
<target name="web.deploy.faqindex" depends="init,dist" |
106 |
<stripnonbodyhtml srcdir="${readme11.dir}" includes="index.html" /> |
| 108 |
description="deploy built faq and index to web.doc.dir"> |
107 |
</target> |
| 109 |
<copy todir="${web.doc.dir}" filtering="on"> |
108 |
|
| 110 |
<fileset dir="${docs.dist.dir}/doc" |
109 |
<target name="web.deploy.old" depends="init" description="deploy built docs to the web site"> |
| 111 |
includes="faq.html,index.html"/> |
110 |
<mkdir dir="${web.doc.dir}" /> |
| 112 |
</copy> |
111 |
<delete dir="${web.doc.dir}" /> |
| 113 |
<stripnonbodyhtml srcdir="${web.doc.dir}" |
112 |
<mkdir dir="${web.doc.dir}" /> |
| 114 |
includes="faq.html,index.html" /> |
113 |
<copy todir="${web.doc.dir}"> |
| 115 |
<echo message="do link check on index and faq before release"/> |
114 |
<fileset dir="${docs.dist.dir}/doc" /> |
| 116 |
</target> |
115 |
</copy> |
| 117 |
|
116 |
<stripnonbodyhtml srcdir="${web.doc.dir}" includes="**/*.html" /> |
| 118 |
<target name="web.deploy" depends="web.deploy.README-11" /> |
117 |
</target> |
| 119 |
|
118 |
|
| 120 |
<target name="web.deploy.README-11" depends="init" |
119 |
<!-- ============================================================ --> |
| 121 |
description="deploy README-11.html to the web site"> |
120 |
<!-- build all doc products --> |
| 122 |
<property name="readme11.dir" |
121 |
<!-- ============================================================ --> |
| 123 |
location="${web.doc.dir}/documentation/readme11"/> |
122 |
<target name="local-dist" depends="init" unless="local.dist.uptodate" description="avoid local-dist antecedants if uptodate"> |
| 124 |
<mkdir dir="${readme11.dir}"/> |
123 |
<antcall target="do-local-dist" /> |
| 125 |
<delete file="${readme11.dir}/index.html"/> |
124 |
</target> |
| 126 |
<mkdir dir="${readme11.dir}"/> |
125 |
|
| 127 |
<copy tofile="${readme11.dir}/index.html" |
126 |
<target name="do-local-dist" depends="init,init-filters,api,faq,devguide,progguide, adk15guide" description="finish products by copying dist files"> |
| 128 |
file="${aspectj.products.dir}/tools/dist/README-11.html" |
127 |
<copy todir="${docs.dist.dir}" filtering="on"> |
| 129 |
filtering="on"/> |
128 |
<fileset dir="${docs.src.dir}/dist" excludes="${binary.pattern}" /> |
| 130 |
<stripnonbodyhtml srcdir="${readme11.dir}" |
129 |
</copy> |
| 131 |
includes="index.html" /> |
130 |
<copy todir="${docs.dist.dir}" filtering="off"> |
| 132 |
</target> |
131 |
<fileset dir="${docs.src.dir}/dist" includes="${binary.pattern}" /> |
| 133 |
|
132 |
</copy> |
| 134 |
<target name="web.deploy.old" depends="init" |
133 |
</target> |
| 135 |
description="deploy built docs to the web site"> |
134 |
|
| 136 |
<mkdir dir="${web.doc.dir}"/> |
135 |
<target name="api" depends="init" description="javadoc for AspectJ lang, lang.reflect and org.aspectj.weaver.tools"> |
| 137 |
<delete dir="${web.doc.dir}"/> |
136 |
<delete dir="${docs.dist.dir}/doc/api" /> |
| 138 |
<mkdir dir="${web.doc.dir}"/> |
137 |
<mkdir dir="${docs.dist.dir}/doc/api" /> |
| 139 |
<copy todir="${web.doc.dir}"> |
138 |
<javadoc sourcepath="${aspectj.modules.dir}/runtime/src;${aspectj.modules.dir}/weaver/src" destdir="${docs.dist.dir}/doc/api" windowtitle="AspectJ(tm) runtime API" link="http://java.sun.com/j2se/1.4.2/docs/api" classpath="${aspectj.modules.dir}/asm/bin;${aspectj.modules.dir}/bridge/bin;${aspectj.modules.dir}/util/bin;${aspectj.modules.dir}/lib/bcel/bcel.jar" packagenames="org.aspectj.lang,org.aspectj.lang.reflect,org.aspectj.weaver.tools" /> |
| 140 |
<fileset dir="${docs.dist.dir}/doc"/> |
139 |
<!-- note: link ineffective at avoiding see tag warning --> |
| 141 |
</copy> |
140 |
</target> |
| 142 |
<stripnonbodyhtml srcdir="${web.doc.dir}" |
141 |
|
| 143 |
includes="**/*.html" /> |
142 |
<target name="faq" depends="init"> |
| 144 |
</target> |
143 |
<antcall target="xml-html"> |
| 145 |
|
144 |
<param name="xml-source-dir" value="${docs.src.dir}/faq" /> |
| 146 |
<!-- ============================================================ --> |
145 |
<param name="xml-source-root" value="faq.xml" /> |
| 147 |
<!-- build all doc products --> |
146 |
<param name="xsl-source-file" value="${nochunk.xsl.source}" /> |
| 148 |
<!-- ============================================================ --> |
147 |
<param name="xml-target-dir" value="${docs.dist.dir}" /> |
| 149 |
<target name="local-dist" depends="init" |
148 |
<param name="xml-target-file" value="${docs.dist.dir}/doc/faq.html" /> |
| 150 |
unless="local.dist.uptodate" |
149 |
</antcall> |
| 151 |
description="avoid local-dist antecedants if uptodate"> |
150 |
</target> |
| 152 |
<antcall target="do-local-dist"/> |
151 |
|
| 153 |
</target> |
152 |
<!-- experimental targets collapse guide-making (lose individual targets) --> |
| 154 |
|
153 |
<target name="progguide" depends="init"> |
| 155 |
<target name="do-local-dist" |
154 |
<antcall target="build-guide"> |
| 156 |
depends="init,init-filters,api,faq,devguide,progguide, adk15guide" |
155 |
<param name="guide.dir" value="progGuideDB" /> |
| 157 |
description="finish products by copying dist files"> |
156 |
<param name="guide.name" value="progguide" /> |
| 158 |
<copy todir="${docs.dist.dir}" filtering="on"> |
157 |
</antcall> |
| 159 |
<fileset dir="${docs.src.dir}/dist" |
158 |
</target> |
| 160 |
excludes="${binary.pattern}"/> |
159 |
|
| 161 |
</copy> |
160 |
<target name="adk15guide" depends="init"> |
| 162 |
<copy todir="${docs.dist.dir}" filtering="off"> |
161 |
<antcall target="build-guide"> |
| 163 |
<fileset dir="${docs.src.dir}/dist" |
162 |
<param name="guide.dir" value="adk15ProgGuideDB" /> |
| 164 |
includes="${binary.pattern}"/> |
163 |
<param name="guide.name" value="adk15notebook" /> |
| 165 |
</copy> |
164 |
</antcall> |
| 166 |
</target> |
165 |
</target> |
| 167 |
|
166 |
|
| 168 |
<target name="api" depends="init" |
167 |
|
| 169 |
description="javadoc for AspectJ lang, lang.reflect and org.aspectj.weaver.tools"> |
168 |
<target name="devguide" depends="init"> |
| 170 |
<delete dir="${docs.dist.dir}/doc/api"/> |
169 |
|
| 171 |
<mkdir dir="${docs.dist.dir}/doc/api"/> |
170 |
<!-- GCH --> |
| 172 |
<javadoc sourcepath="${aspectj.modules.dir}/runtime/src;${aspectj.modules.dir}/weaver/src" |
171 |
<echo message="**** docs: just inside devguide target" /> |
| 173 |
destdir="${docs.dist.dir}/doc/api" |
172 |
|
| 174 |
windowtitle="AspectJ(tm) runtime API" |
173 |
<copy todir="${docs.src.dir}/devGuideDB" filtering="off"> |
| 175 |
link="http://java.sun.com/j2se/1.4.2/docs/api" |
174 |
<fileset dir="${devguide.icons.dir}" includes="${include.devguide.icons}" /> |
| 176 |
classpath="${aspectj.modules.dir}/asm/bin;${aspectj.modules.dir}/bridge/bin;${aspectj.modules.dir}/util/bin;${aspectj.modules.dir}/lib/bcel/bcel.jar" |
175 |
</copy> |
| 177 |
packagenames="org.aspectj.lang,org.aspectj.lang.reflect,org.aspectj.weaver.tools" /> |
176 |
|
| 178 |
<!-- note: link ineffective at avoiding see tag warning --> |
177 |
<!-- GCH --> |
| 179 |
</target> |
178 |
<echo message="**** docs: about to make call to build-guide target" /> |
| 180 |
|
179 |
|
| 181 |
<target name="faq" depends="init"> |
180 |
<antcall target="build-guide"> |
| 182 |
<antcall target="xml-html"> |
181 |
<param name="xml-html-copy" value="ajbrowser-building.gif,ajbrowser-options.gif,${include.devguide.icons}" /> |
| 183 |
<param name="xml-source-dir" |
182 |
<param name="guide.dir" value="devGuideDB" /> |
| 184 |
value="${docs.src.dir}/faq"/> |
183 |
<param name="guide.name" value="devguide" /> |
| 185 |
<param name="xml-source-root" |
184 |
</antcall> |
| 186 |
value="faq.xml"/> |
185 |
<delete quiet="on"> |
| 187 |
<param name="xsl-source-file" |
186 |
<!-- clean icons for build-in-place --> |
| 188 |
value="${nochunk.xsl.source}"/> |
187 |
<fileset dir="${docs.src.dir}/devGuideDB" includes="${include.devguide.icons}" /> |
| 189 |
<param name="xml-target-dir" |
188 |
</delete> |
| 190 |
value="${docs.dist.dir}"/> |
189 |
</target> |
| 191 |
<param name="xml-target-file" |
190 |
|
| 192 |
value="${docs.dist.dir}/doc/faq.html"/> |
191 |
<target name="build-guide" depends="init" description="build prog or dev guide, using guide.dir and guide.name"> |
| 193 |
</antcall> |
192 |
<!-- chunked --> |
| 194 |
</target> |
193 |
<antcall target="xml-html"> |
| 195 |
|
194 |
<param name="xml-source-dir" value="${docs.src.dir}/${guide.dir}" /> |
| 196 |
<!-- experimental targets collapse guide-making (lose individual targets) --> |
195 |
<param name="xml-source-root" value="${guide.name}.xml" /> |
| 197 |
<target name="progguide" depends="init"> |
196 |
<param name="xsl-source-file" value="${chunk.xsl.source}" /> |
| 198 |
<antcall target="build-guide"> |
197 |
<param name="xml-target-dir" value="${docs.dist.dir}/doc/${guide.name}" /> |
| 199 |
<param name="guide.dir" value="progGuideDB"/> |
198 |
</antcall> |
| 200 |
<param name="guide.name" value="progguide"/> |
199 |
<!-- single --> |
| 201 |
</antcall> |
200 |
<antcall target="xml-html"> |
| 202 |
</target> |
201 |
<param name="xml-source-dir" value="${docs.src.dir}/${guide.dir}" /> |
| 203 |
|
202 |
<param name="xml-source-root" value="${guide.name}.xml" /> |
| 204 |
<target name="adk15guide" depends="init"> |
203 |
<param name="xsl-source-file" value="${nochunk.xsl.source}" /> |
| 205 |
<antcall target="build-guide"> |
204 |
<param name="xml-target-dir" value="${docs.dist.dir}/doc/${guide.name}" /> |
| 206 |
<param name="guide.dir" value="adk15ProgGuideDB"/> |
205 |
<param name="xml-target-file" value="${docs.dist.dir}/doc/${guide.name}/printable.html" /> |
| 207 |
<param name="guide.name" value="adk15notebook"/> |
206 |
</antcall> |
| 208 |
</antcall> |
207 |
<!-- pdf --> |
| 209 |
</target> |
208 |
<antcall target="xml-pdf"> |
| 210 |
|
209 |
<param name="xml-source-dir" |
| 211 |
|
|
|
| 212 |
<target name="devguide" depends="init"> |
| 213 |
|
| 214 |
<!-- GCH --> |
| 215 |
<echo message="**** docs: just inside devguide target"/> |
| 216 |
|
| 217 |
<copy todir="${docs.src.dir}/devGuideDB" filtering="off" > |
| 218 |
<fileset dir="${devguide.icons.dir}" |
| 219 |
includes="${include.devguide.icons}" /> |
| 220 |
</copy> |
| 221 |
|
| 222 |
<!-- GCH --> |
| 223 |
<echo message="**** docs: about to make call to build-guide target"/> |
| 224 |
|
| 225 |
<antcall target="build-guide"> |
| 226 |
<param name="xml-html-copy" value="ajbrowser-building.gif,ajbrowser-options.gif,${include.devguide.icons}" /> |
| 227 |
<param name="guide.dir" value="devGuideDB"/> |
| 228 |
<param name="guide.name" value="devguide"/> |
| 229 |
</antcall> |
| 230 |
<delete quiet="on"> <!-- clean icons for build-in-place --> |
| 231 |
<fileset dir="${docs.src.dir}/devGuideDB" |
| 232 |
includes="${include.devguide.icons}" /> |
| 233 |
</delete> |
| 234 |
</target> |
| 235 |
|
| 236 |
<target name="build-guide" depends="init" |
| 237 |
description="build prog or dev guide, using guide.dir and guide.name"> |
| 238 |
<!-- chunked --> |
| 239 |
<antcall target="xml-html"> |
| 240 |
<param name="xml-source-dir" |
| 241 |
value="${docs.src.dir}/${guide.dir}"/> |
| 242 |
<param name="xml-source-root" |
| 243 |
value="${guide.name}.xml"/> |
| 244 |
<param name="xsl-source-file" |
| 245 |
value="${chunk.xsl.source}"/> |
| 246 |
<param name="xml-target-dir" |
| 247 |
value="${docs.dist.dir}/doc/${guide.name}"/> |
| 248 |
</antcall> |
| 249 |
<!-- single --> |
| 250 |
<antcall target="xml-html"> |
| 251 |
<param name="xml-source-dir" |
| 252 |
value="${docs.src.dir}/${guide.dir}"/> |
210 |
value="${docs.src.dir}/${guide.dir}"/> |
| 253 |
<param name="xml-source-root" |
211 |
<param name="xml-source-root" value="${guide.name}.xml"/> |
| 254 |
value="${guide.name}.xml"/> |
212 |
<param name="pdf-target-file" |
| 255 |
<param name="xsl-source-file" |
|
|
| 256 |
value="${nochunk.xsl.source}"/> |
| 257 |
<param name="xml-target-dir" |
| 258 |
value="${docs.dist.dir}/doc/${guide.name}"/> |
| 259 |
<param name="xml-target-file" |
| 260 |
value="${docs.dist.dir}/doc/${guide.name}/printable.html"/> |
| 261 |
</antcall> |
| 262 |
<!-- pdf - enable when it works |
| 263 |
<antcall target="xml-pdf"> |
| 264 |
<param name="xml-source-dir" |
| 265 |
value="${docs.src.dir}/doc/${guide.dir}"/> |
| 266 |
<param name="xml-source-root" value="${guide.name}.xml"/> |
| 267 |
<param name="xml-target-file" |
| 268 |
value="${docs.dist.dir}/doc/${guide.name}.pdf"/> |
213 |
value="${docs.dist.dir}/doc/${guide.name}.pdf"/> |
| 269 |
</antcall> |
214 |
</antcall> |
| 270 |
--> |
215 |
|
| 271 |
</target> |
216 |
</target> |
| 272 |
<!-- end of experimental targets --> |
217 |
<!-- end of experimental targets --> |
| 273 |
|
218 |
|
| 274 |
<!-- XML conversion stuff --> |
219 |
<!-- XML conversion stuff --> |
| 275 |
|
|
|
| 276 |
<!-- todo xml-pdf broken; when fixed, see xml-html for example --> |
| 277 |
<target name="xml-pdf"> |
| 278 |
<delete file="${xml-target-file}"/> |
| 279 |
<touch file="${xml-target-file}"/> |
| 280 |
<java classname="com.icl.saxon.StyleSheet" |
| 281 |
fork="yes"> |
| 282 |
<classpath> |
| 283 |
<pathelement location="${saxon.dir}/saxon.jar"/> |
| 284 |
</classpath> |
| 285 |
<arg value="-o"/> |
| 286 |
<arg value="${xml-source-dir}/index.fo"/> |
| 287 |
<arg value="${xml-source-dir}/${xml-source-root}"/> |
| 288 |
<arg value="${docbook.dir}/docbook-xsl/fo/docbook.xsl"/> |
| 289 |
</java> |
| 290 |
</target> |
| 291 |
|
220 |
|
| 292 |
<target name="xml-html" |
221 |
<!-- xml-pdf --> |
| 293 |
description="antcall(xml-source-dir, xml-source-root, xml-target-dir, xml-target-file) |
222 |
<target name="xml-pdf"> |
|
|
223 |
<delete file="${pdf-target-file}" /> |
| 224 |
<touch file="${pdf-target-file}" /> |
| 225 |
<delete file="${xml-source-dir}/index.fo"/> |
| 226 |
|
| 227 |
<!-- produce index.fo from docbook sources --> |
| 228 |
<java classname="com.icl.saxon.StyleSheet" fork="yes"> |
| 229 |
<classpath> |
| 230 |
<pathelement location="${aspectj.modules.lib.dir}/saxon/saxon.jar" /> |
| 231 |
</classpath> |
| 232 |
<arg value="-o" /> |
| 233 |
<arg value="${xml-source-dir}/index.fo" /> |
| 234 |
<arg value="${xml-source-dir}/${xml-source-root}" /> |
| 235 |
<arg value="${aspectj.modules.lib.dir}/docbook/docbook-xsl/fo/docbook.xsl" /> |
| 236 |
</java> |
| 237 |
|
| 238 |
<!-- use apache FOP to transform index.fo to pdf --> |
| 239 |
<taskdef name="fop" classname="org.apache.fop.tools.anttasks.Fop"> |
| 240 |
<classpath> |
| 241 |
<fileset dir="${aspectj.modules.lib.dir}/fop"> |
| 242 |
<include name="fop.jar" /> |
| 243 |
<include name="batik.jar" /> |
| 244 |
<include name="avalon.jar" /> |
| 245 |
</fileset> |
| 246 |
<fileset dir="${aspectj.modules.lib.dir}/ant"> |
| 247 |
<include name="xalan.jar" /> |
| 248 |
<include name="xercesImpl.jar" /> |
| 249 |
<include name="xml-apis.jar" /> |
| 250 |
</fileset> |
| 251 |
</classpath> |
| 252 |
</taskdef> |
| 253 |
<fop format="application/pdf" |
| 254 |
messagelevel="info" |
| 255 |
basedir="${guide.dir}" |
| 256 |
fofile="${guide.dir}/index.fo" |
| 257 |
outfile="${pdf-target-file}"> |
| 258 |
</fop> |
| 259 |
</target> |
| 260 |
|
| 261 |
<target name="xml-html" description="antcall(xml-source-dir, xml-source-root, xml-target-dir, xml-target-file) |
| 294 |
convert xml to html using docbook. parameters: |
262 |
convert xml to html using docbook. parameters: |
| 295 |
xml-source-dir # base directory of source |
263 |
xml-source-dir # base directory of source |
| 296 |
xml-source-root # base file of source (relative to xml-source-dir) |
264 |
xml-source-root # base file of source (relative to xml-source-dir) |
|
Lines 299-325
Link Here
|
| 299 |
xml-target-file # full path to output file in xml-source-dir, ignored when chunking |
267 |
xml-target-file # full path to output file in xml-source-dir, ignored when chunking |
| 300 |
xml-html-copy # copy files to target (defaults to *.gif,*.png"> |
268 |
xml-html-copy # copy files to target (defaults to *.gif,*.png"> |
| 301 |
|
269 |
|
| 302 |
<mkdir dir="${xml-target-dir}"/> |
270 |
<mkdir dir="${xml-target-dir}" /> |
| 303 |
<copy todir="${xml-target-dir}"> |
271 |
<copy todir="${xml-target-dir}"> |
| 304 |
<fileset dir="${xml-source-dir}" |
272 |
<fileset dir="${xml-source-dir}" includes="${xml-html-copy}" /> |
| 305 |
includes="${xml-html-copy}"/> |
273 |
</copy> |
| 306 |
</copy> |
274 |
<java classname="com.icl.saxon.StyleSheet" |
| 307 |
<java classname="com.icl.saxon.StyleSheet" |
275 |
classpath="${aspectj.modules.lib.dir}/saxon/saxon.jar" |
| 308 |
classpath="${aspectj.modules.lib.dir}/saxon/saxon.jar" |
276 |
fork="yes" |
| 309 |
fork="yes" |
277 |
failonerror="yes"> |
| 310 |
failonerror="yes"> <!-- todo: establish failure policy --> |
278 |
<!-- todo: establish failure policy --> |
| 311 |
<arg value="-o"/> |
279 |
<arg value="-o" /> |
| 312 |
<arg value="${xml-target-file}"/> |
280 |
<arg value="${xml-target-file}" /> |
| 313 |
<arg value="${xml-source-dir}/${xml-source-root}"/> |
281 |
<arg value="${xml-source-dir}/${xml-source-root}" /> |
| 314 |
<arg value="${xsl-source-file}"/> |
282 |
<arg value="${xsl-source-file}" /> |
| 315 |
<arg value="base.dir=${xml-target-dir}/"/> |
283 |
<arg value="base.dir=${xml-target-dir}/" /> |
| 316 |
<arg value="use.id.as.filename=1"/> |
284 |
<arg value="use.id.as.filename=1" /> |
| 317 |
</java> |
285 |
</java> |
| 318 |
</target> |
286 |
</target> |
| 319 |
|
287 |
|
| 320 |
<target name="info" |
288 |
<target name="info" description="misc info for writing and building docbook"> |
| 321 |
description="misc info for writing and building docbook"> |
289 |
<echo> |
| 322 |
<echo> |
|
|
| 323 |
---- misc info for writing and building docbook |
290 |
---- misc info for writing and building docbook |
| 324 |
- link tag linkend attribute takes an id |
291 |
- link tag linkend attribute takes an id |
| 325 |
- xsl converts as needed during output |
292 |
- xsl converts as needed during output |
|
Lines 353-358
Link Here
|
| 353 |
- fyi, generate.reference.titlepage appears not to be respected. |
320 |
- fyi, generate.reference.titlepage appears not to be respected. |
| 354 |
tried to add if statement to html/refentry.xsl, but file still gen'd |
321 |
tried to add if statement to html/refentry.xsl, but file still gen'd |
| 355 |
</echo> |
322 |
</echo> |
| 356 |
</target> |
323 |
</target> |
| 357 |
|
|
|
| 358 |
</project> |
324 |
</project> |
