1 # Makefile, used for the developers-reference in DocBook XML
3 # Note: This Makefile should work perfectly without the debian/ directory.
5 SOURCES := $(wildcard *.dbk) common.ent version.ent
7 FORMATS := html txt pdf epub
9 TARGETS := $(foreach fmt,$(FORMATS),developers-reference.$(fmt)) \
10 $(foreach lng,$(LANGS), \
11 $(foreach fmt,$(FORMATS), \
12 $(lng)/developers-reference.$(fmt)))
13 # list of targets, that currently cannot build
14 #BLACKLIST := ja/developers-reference.pdf
16 # hopefully overwritten by caller, e.g. debian/rules
20 # programs for creating output
21 XP=xsltproc --nonet --novalid --xinclude
22 XL=xmllint --nonet --noout --postvalid --xinclude
23 # dblatex 0.2.8 has some problems (e.g. #465221 and Japanese does
26 # - docbook2pdf (seems to die on UTF-8, #431085); and
27 # - fop is currently in contrib, but can go to main, see #366783
28 # - xmlroff (not mature enough, #182445)
29 DBLATEX=dblatex --style=db2latex
30 TRANSLATE=po4a po4a/po4a.cfg
32 # XSL files and parameters
33 # note: the URL is used as identifier, no HTTP is used!
34 DOCBOOK_XSL=http://docbook.sourceforge.net/release/xsl/current
36 DBK2HTML=$(CURDIR)/html.xsl
37 # all in one file for text output
38 DBK2HTML1=$(CURDIR)/txt.xsl
41 all: $(filter-out $(BLACKLIST), $(TARGETS))
47 %/validate: $(addprefix %/,$(SOURCES))
48 cd $(@D) && $(XL) index.dbk
50 # This rule controls the build and installation on the website
51 # Logs are here: http://www-master.debian.org/build-logs/ddp/
54 [ -d $(PUBLISHDIR) ] || exit 1
55 install -d -m 755 $(PUBLISHDIR)/developers-reference
56 rm -f $(PUBLISHDIR)/developers-reference/*.html
57 rm -f en && ln -sf . en
58 $(foreach format,$(FORMATS),$(foreach lang,en $(LANGS),for file in $(lang)/*.$(format); do if [ -e "$$file" ]; then cp --preserve=timestamps $$file $(PUBLISHDIR)/developers-reference/$$(basename $$file .$(format)).$(lang).$(format); fi; done;))
59 ln -sf index.en.html $(PUBLISHDIR)/developers-reference/index.html
60 ln -sf developers-reference.en.pdf $(PUBLISHDIR)/developers-reference/developers-reference.pdf
61 ln -sf developers-reference.en.txt $(PUBLISHDIR)/developers-reference/developers-reference.txt
62 ln -sf developers-reference.en.epub $(PUBLISHDIR)/developers-reference/developers-reference.epub
64 .PHONY: developers-reference.html %/developers-reference.html
65 developers-reference.html: $(CURDIR)/index.html
66 %/developers-reference.html: $(addprefix %/,index.html)
69 .PRECIOUS: %/index.html
70 index.html: $(CURDIR)/developers-reference.html
71 %/index.html: $(addprefix %/,$(SOURCES))
72 cd $(@D) && $(XP) $(DBK2HTML) index.dbk
74 # There must be an easier way than recursive make!
75 .PRECIOUS: %.dbk %.ent
79 $(MAKE) $@ LINGUA=`basename $(@D)`
83 $(LINGUA)/%.dbk: %.dbk po4a/$(LINGUA).po
86 $(LINGUA)/common.ent: common.ent
87 cd $(@D) && ln -sf ../$(@F) .
90 developers-reference.txt: $(CURDIR)/developers-reference.txt
91 %/developers-reference.txt: $(addprefix %/,$(SOURCES))
92 $(XP) $(DBK2HTML1) $(@D)/index.dbk \
93 | LC_ALL=C.UTF-8 w3m -o display_charset=UTF-8 -cols 70 -dump -no-graph -T text/html > $@
97 developers-reference.pdf: $(CURDIR)/developers-reference.pdf
98 %/developers-reference.pdf: $(addprefix %/,$(SOURCES))
99 $(DBLATEX) $(@D)/index.dbk \
101 --xsl-user=$(XSLT)/user_param.xsl \
102 --xsl-user=$(XSLT)/xetex_param.xsl \
103 --param=lingua=$(@D) \
104 && mv $(@D)/index.dbk.pdf $@
106 developers-reference.epub: $(CURDIR)/developers-reference.epub
107 %/developers-reference.epub: $(addprefix %/,$(SOURCES))
108 TOP=`pwd` && cd $(@D) && xmlto epub index.dbk && mv index.epub $(@F)
111 pot: po4a/po/developers-reference.pot
112 po4a/po/developers-reference.pot: %.dbk
117 updatepo: po4a/po/$(LINGUA).po
118 po4a/po/$(LINGUA).po: %.dbk
123 for po in po4a/po/*.po; do \
124 msgcat -o $$po $$po; \
128 @for po in po4a/po/*.po; do \
133 echo '<!ENTITY version "$(VERSION)">' > $@
134 echo '<!ENTITY pubdate "$(PUBDATE)">' >> $@
138 rm -f *.fo *.html *.pdf *.txt *.epub
139 for L in $(LANGS); do rm -rf `basename ./"$$L"/`; done
141 rm -f `find . -name "*~" -o -name "*.bak"`
142 rm -f *~ *.bak .#* core
148 # if rule bomb out, delete the target