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
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 # The "--keep 0" should be removed as soon as the translations are ready
31 TRANSLATE=po4a-translate --format docbook --keep 0
33 # XSL files and parameters
34 # note: the URL is used as identifier, no HTTP is used!
35 DOCBOOK_XSL=http://docbook.sourceforge.net/release/xsl/current
37 DBK2HTML=$(CURDIR)/html.xsl
38 # all in one file for text output
39 DBK2HTML1=$(CURDIR)/txt.xsl
42 all: $(filter-out $(BLACKLIST), $(TARGETS))
48 %/validate: $(addprefix %/,$(SOURCES))
49 cd $(@D) && $(XL) index.dbk
51 .PHONY: developers-reference.html %/developers-reference.html
52 developers-reference.html: $(CURDIR)/index.html
53 %/developers-reference.html: $(addprefix %/,index.html)
56 .PRECIOUS: %/index.html
57 index.html: $(CURDIR)/developers-reference.html
58 %/index.html: $(addprefix %/,$(SOURCES))
59 cd $(@D) && $(XP) $(DBK2HTML) index.dbk
61 # There must be an easier way than recursive make!
62 .PRECIOUS: %.dbk %.ent
65 $(MAKE) $@ LINGUA=`basename $(@D)`
69 $(LINGUA)/%.dbk: %.dbk $(patsubst %.dbk,po4a/$(LINGUA)/%.po,%.dbk)
70 $(TRANSLATE) -m $< -p po4a/$(@:.dbk=.po) -l $@
72 $(LINGUA)/common.ent: common.ent
73 cd $(@D) && ln -sf ../$(@F) .
76 developers-reference.txt: $(CURDIR)/developers-reference.txt
77 %/developers-reference.txt: $(addprefix %/,$(SOURCES))
78 $(XP) $(DBK2HTML1) $(@D)/index.dbk \
79 | w3m -cols 65 -dump -T text/html > $@
81 developers-reference.pdf: $(CURDIR)/developers-reference.pdf
82 %/developers-reference.pdf: $(addprefix %/,$(SOURCES))
83 TOP=`pwd` && cd $(@D) && $(DBLATEX) index.dbk \
84 && mv index.dbk.pdf $(@F)
87 pot: $(patsubst %.dbk,po4a/po/%.pot,$(SOURCES))
89 po4a-gettextize --format docbook --master $< --po $@
93 updatepo: $(patsubst %.dbk,po4a/$(LINGUA)/%.po,$(SOURCES))
94 po4a/$(LINGUA)/%.po: %.dbk
95 po4a-updatepo --format docbook --master $< --po $@
99 echo '<!ENTITY version "$(VERSION)">' > $@
100 echo '<!ENTITY pubdate "$(PUBDATE)">' >> $@
104 rm -f *.fo *.html *.pdf *.txt
105 for L in $(LANGS); do rm -rf `basename ./"$$L"/`; done
107 rm -f `find . -name "*~" -o -name "*.bak"`
108 rm -f *~ *.bak .#* core
114 # if rule bomb out, delete the target