doc: Finish updates for v1.7
[fw/altos] / doc / Makefile
1 #
2 #       http://docbook.sourceforge.net/release/xsl/current/README
3 #
4
5 RELNOTES_INC=\
6         release-notes-1.7.inc \
7         release-notes-1.6.8.inc \
8         release-notes-1.6.5.inc \
9         release-notes-1.6.4.inc \
10         release-notes-1.6.3.inc \
11         release-notes-1.6.2.inc \
12         release-notes-1.6.1.inc \
13         release-notes-1.6.inc \
14         release-notes-1.5.inc \
15         release-notes-1.4.2.inc \
16         release-notes-1.4.1.inc \
17         release-notes-1.4.inc \
18         release-notes-1.3.2.inc \
19         release-notes-1.3.1.inc \
20         release-notes-1.3.inc \
21         release-notes-1.2.1.inc \
22         release-notes-1.2.inc \
23         release-notes-1.1.1.inc \
24         release-notes-1.1.inc \
25         release-notes-1.0.1.inc \
26         release-notes-0.9.2.inc \
27         release-notes-0.9.inc \
28         release-notes-0.8.inc \
29         release-notes-0.7.1.inc
30
31 IMAGES=\
32         altosui.png \
33         ascent.png \
34         configure-altimeter.png \
35         configure-altosui.png \
36         configure-groundstation.png \
37         configure-pyro.png \
38         descent.png \
39         device-selection.png \
40         easymega.svg \
41         easymega-v1.0-bottom.jpg \
42         easymega-v1.0-top.jpg \
43         easymini.svg \
44         easymini-top.jpg \
45         fire-igniter.png \
46         graph-configure.png \
47         graph-map.png \
48         graph.png \
49         graph-stats.png \
50         ignitor.png \
51         landed.png \
52         launch-pad.png \
53         load-maps.png \
54         micropeak-app.png \
55         micropeak-back.jpg \
56         micropeak-device-dialog.png \
57         micropeak-dime.jpg \
58         micropeak-download.png \
59         micropeak-graph-configure.png \
60         micropeak-graph.png \
61         micropeak-nofont.svg \
62         micropeak-preferences.png \
63         micropeak-raw-data.png \
64         micropeak-save-dialog.png \
65         micropeak-statistics.png \
66         MicroPeakUSB-2.0-inuse.jpg \
67         MicroPeakUSB-2.0.jpg \
68         monitor-idle.png \
69         scan-channels.png \
70         site-map.png \
71         table.png \
72         telegps-configure.png \
73         telegps-graph-configure.png \
74         telegps-graph-graph.png \
75         telegps-graph-map.png \
76         telegps-graph-stats.png \
77         telegps-info.png \
78         telegps-location.png \
79         telegps-map.png \
80         telegps-preferences.png \
81         telegps-scan.png \
82         telegps-status.png \
83         telegps-table.png \
84         telegps-v1.0-top.jpg \
85         telemega.svg \
86         telemega-v1.0-top.jpg \
87         telemetrum.svg \
88         telemetrum-v1.1-thside.jpg \
89         telemetrum-v2.0-th.jpg \
90         telemini-v1.svg \
91         telemini-v1-top.jpg \
92         telemini-v3.svg \
93         telemini-v3.0-top.jpg \
94         telemini-v3.0-bottom.jpg \
95         altusmetrum-oneline.svg \
96         telegps-oneline.svg \
97         micropeak-oneline.svg
98
99 TXT_FILES=altusmetrum.txt
100
101 COMMON_INC_FILES=\
102         config-device.inc \
103         config-ui.inc \
104         load-maps.inc \
105         aprs-operation.inc \
106         handling.inc
107
108 INC_FILES=\
109         dedication.inc \
110         intro.inc \
111         getting-started.inc \
112         usage.inc \
113         telemetrum.inc \
114         telemini.inc \
115         easymini-device.inc \
116         telemega.inc \
117         easymega.inc \
118         installation.inc \
119         using-am-products.inc \
120         updating-firmware.inc \
121         altosui.inc \
122         altosdroid.inc \
123         system-operation.inc \
124         pyro-channels.inc \
125         flight-data-recording.inc \
126         specs.inc \
127         $(COMMON_INC_FILES) \
128         release-notes.inc \
129         $(RELNOTES_INC)
130
131 RAW_FILES=$(TXT_FILES:.txt=.raw) $(INC_FILES:.inc=.raw)
132
133 TELEGPS_INC_FILES=\
134         telegps-dedication.inc \
135         telegps-quick-start.inc \
136         telegps-using.inc \
137         telegps-system-operation.inc \
138         telegps-application.inc \
139         telegps-specs.inc \
140         telegps-updating-firmware.inc \
141         telegps-release-notes.inc \
142         $(COMMON_INC_FILES)
143
144 TELEGPS_TXT_FILES=\
145         telegps.txt
146
147 TELEGPS_RAW_FILES=$(TELEGPS_TXT_FILES:.txt=.raw) $(TELEGPS_INC_FILES:.inc=.raw)
148
149 MICROPEAK_TXT_FILES=\
150         micropeak.txt
151
152 MICROPEAK_INC_FILES=
153
154 MICROPEAK_RAW_FILES=$(MICROPEAK_TXT_FILES:.txt=.raw) $(MICROPEAK_INC_FILES:.inc=.raw)
155
156 EASYMINI_TXT_FILES=\
157         easymini.txt
158
159 EASYMINI_INC_FILES=$(INC_FILES) easymini-release-notes.inc
160
161
162 EASYMINI_RAW_FILES=$(EASYMINI_TXT_FILES:.txt=.raw) $(EASYMINI_INC_FILES:.inc=.raw)
163
164 OUTLINE_TXT_FILES=\
165         easymega-outline.txt \
166         easymini-outline.txt \
167         telemega-outline.txt \
168         telemetrum-outline.txt \
169         telemini-v1-outline.txt \
170         telemini-v3-outline.txt
171
172 OUTLINE_RAW_FILES=$(OUTLINE_TXT_FILES:.txt=.raw)
173
174 OUTLINE_PDF_FILES=$(OUTLINE_TXT_FILES:.txt=.pdf)
175
176 SVG=\
177         easymini.svg \
178         telemega.svg \
179         telemetrum.svg \
180         telemini-v1.svg \
181         telemini-v3.svg \
182         easymega.svg
183
184 RELNOTES_PDF=$(RELNOTES_INC:.inc=.pdf)
185 RELNOTES_HTML=$(RELNOTES_INC:.inc=.html)
186
187 ONEFILE_TXT_FILES=\
188         altos.txt \
189         companion.txt \
190         telemetry.txt
191
192 ONEFILE_RAW_FILES=$(ONEFILE_TXT_FILES:.txt=.raw)
193 ONEFILE_PDF_FILES=$(ONEFILE_TXT_FILES:.txt=.pdf)
194
195 AM_HTML=am.html
196
197 HTML=altusmetrum.html micropeak.html telegps.html easymini.html $(RELNOTES_HTML) $(ONEFILE_HTML_FILES)
198
199 HTML_REVHISTORY=\
200         altusmetrum-revhistory.html \
201         micropeak-revhistory.html \
202         telegps-revhistory.html \
203         easymini-revhistory.html
204
205 PDF=altusmetrum.pdf micropeak.pdf telegps.pdf easymini.pdf $(RELNOTES_PDF) $(ONEFILE_PDF_FILES) \
206         $(OUTLINE_PDF_FILES)
207
208 FOP_STYLE=am-fo.xsl
209 HTML_STYLE=am-html.xsl
210 COMMON_STYLE=common.xsl
211 FOP_XCONF=fop.xconf
212 STYLESHEET=am.css
213
214 FONTS=\
215         fonts/DejaVuSansMono-BoldOblique.ttf \
216         fonts/DejaVuSansMono-Bold.ttf \
217         fonts/DejaVuSansMono-Oblique.ttf \
218         fonts/DejaVuSansMono.ttf \
219         fonts/OpenSans-Light.ttf \
220         fonts/OpenSans-LightItalic.ttf \
221         fonts/OpenSans-Regular.ttf \
222         fonts/OpenSans-Italic.ttf \
223         fonts/OpenSans-Semibold.ttf \
224         fonts/OpenSans-SemiboldItalic.ttf
225
226 TEMPLATES_TMPL=titlepage.templates.tmpl
227
228 TEMPLATES_XSL=$(TEMPLATES_TMPL:.tmpl=.xsl)
229
230 PDF_CONFIG_FILES=$(FOP_STYLE) $(COMMON_STYLE) $(FOP_XCONF) $(TEMPLATES_XSL)
231 HTML_CONFIG_FILES=$(HTML_STYLE) $(COMMON_STYLE) $(TEMPLATES_XSL)
232
233 DOC=$(HTML) $(HTML_REVHISTORY) $(PDF) $(IMAGES) $(STYLESHEET)
234
235 .SUFFIXES: .tmpl .xsl .inc .txt .raw .pdf .html
236
237 .txt.raw:
238         sed -e 's/^[    ]*//' -e 's/^\\//' $*.txt > $@
239
240 .inc.raw:
241         sed -e 's/^[    ]*//' -e 's/^\\//' $*.inc > $@
242
243 .raw.pdf:
244         a2x --verbose -a docinfo -f pdf --xsltproc-opts "--stringparam toc.section.depth 2" --xsl-file $(FOP_STYLE) --fop --fop-opts="-c $(FOP_XCONF)" $*.raw
245         a2x --verbose -a docinfo -f xhtml --xsltproc-opts "--stringparam toc.section.depth 2" --xsl-file $(HTML_STYLE) --stylesheet=$(STYLESHEET) $*.raw
246         case $* in release-notes*) ./fix-html $*.html ;; esac
247
248 .pdf.html:
249         @touch $@
250
251 .tmpl.xsl:
252         xsltproc --output $@ /usr/share/xml/docbook/stylesheet/docbook-xsl/template/titlepage.xsl $*.tmpl
253
254 all:    $(HTML) $(PDF)
255
256 altusmetrum-revhistory.html: altusmetrum.html
257
258 micropeak-revhistory.html: micropeak.html
259
260 telegps-revhistory.html: telegps.html
261
262 altusmetrum.pdf altusmetrum.html: altusmetrum-docinfo.xml $(RAW_FILES) $(IMAGES)
263
264 telegps.html telegps.pdf: telegps-docinfo.xml $(TELEGPS_RAW_FILES) $(IMAGES)
265
266 micropeak.pdf micropeak.html: micropeak-docinfo.xml $(MICROPEAK_RAW_FILES) $(IMAGES)
267
268 easymini.pdf easymini.html: easymini-docinfo.xml $(EASYMINI_RAW_FILES) $(IMAGES)
269
270 telemini-v1-outline.pdf: telemini-v1-outline.txt telemini-v1.svg
271
272 telemini-v3-outline.pdf: telemini-v3-outline.txt telemini-v3.svg
273
274 install:        all
275
276 publish:        $(DOC) $(FONTS)
277         cp $(DOC) /home/bdale/web/altusmetrum/AltOS/doc/
278         mkdir -p /home/bdale/web/altusmetrum/AltOS/doc/fonts/
279         cp $(FONTS) /home/bdale/web/altusmetrum/AltOS/doc/fonts/
280         (cd /home/bdale/web/altusmetrum ; \
281          git add /home/bdale/web/altusmetrum/AltOS/doc/* ; \
282          git add /home/bdale/web/altusmetrum/AltOS/doc/fonts/* ; \
283          echo "update docs" | \
284          git commit -F - /home/bdale/web/altusmetrum/AltOS/doc/* /home/bdale/web/altusmetrum/AltOS/doc/fonts/* ; \
285          git push)
286
287 publish-keithp: am.html $(DOC) $(FONTS)
288         scp -p am.html $(DOC) keithp.com:~keithp/public_html/altos
289         scp -p $(FONTS) keithp.com:~keithp/public_html/altos/fonts
290
291 clean:
292         rm -f am.html $(HTML) $(HTML_REVHISTORY) $(PDF) $(TEMPLATES_XSL) $(RAW_FILES) $(TELEGPS_RAW_FILES) $(MICROPEAK_RAW_FILES)
293
294 distclean: clean
295         rm -f $(HTML) $(PDF)
296
297 $(PDF): $(PDF_CONFIG_FILES)
298 $(HTML): $(HTML_CONFIG_FILES)
299
300 am.html: Makefile make-am-html $(HTML)
301         sh ./make-am-html $(HTML) > $@