docbook.am: global maintenance update - entities, images and olinking
Adding support in libX11 for html chunking caused a reorg of docbook.am as well as the xorg-sgml-doctools masterdb for olinking. The parameter img.src.path is added for pdf images. A searchpath to the root builddir is added for local entities, if present. This feature was initiated by xserver module and made available to all. The docbook.am makefile hides all the details and is identical for all 22 modules having DocBook documentation. It is included by a thin Makefile.am which requires no docbook knowledge. Reviewed-by: Jeremy Huddleston <jeremyhu@apple.com> Signed-off-by: Gaetan Nadon <memsize@videotron.ca> Signed-off-by: Keith Packard <keithp@keithp.com>
This commit is contained in:
parent
871d65790e
commit
1602444e05
114
docbook.am
114
docbook.am
|
@ -21,76 +21,84 @@ shelf_DATA =
|
||||||
dist_shelf_DATA = $(docbook) $(chapters)
|
dist_shelf_DATA = $(docbook) $(chapters)
|
||||||
|
|
||||||
if HAVE_XMLTO
|
if HAVE_XMLTO
|
||||||
#
|
|
||||||
# Generate DocBook/XML output formats with or without stylesheets
|
|
||||||
#
|
|
||||||
|
|
||||||
# Stylesheets are available if the package xorg-sgml-doctools is installed
|
|
||||||
if HAVE_STYLESHEETS
|
if HAVE_STYLESHEETS
|
||||||
|
|
||||||
# The location where all cross reference databases are installed
|
XMLTO_SEARCHPATH_FLAGS = \
|
||||||
sgmldbsdir = $(XORG_SGML_PATH)/X11/dbs
|
--searchpath "$(XORG_SGML_PATH)/X11" \
|
||||||
masterdb = "$(sgmldbsdir)/masterdb$(suffix $@).xml"
|
--searchpath "$(abs_top_builddir)"
|
||||||
XMLTO_FLAGS = \
|
XMLTO_HTML_OLINK_FLAGS = \
|
||||||
--searchpath "$(XORG_SGML_PATH)/X11" \
|
--stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.html.xml \
|
||||||
--searchpath "$(abs_top_builddir)" \
|
--stringparam current.docid="$(<:.xml=)"
|
||||||
--stringparam target.database.document=$(masterdb) \
|
XMLTO_HTML_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
|
||||||
--stringparam current.docid="$(<:.xml=)" \
|
XMLTO_HTML_CSS_STYLESHEET_FLAGS = --stringparam html.stylesheet=$(STYLESHEET_SRCDIR)/xorg.css
|
||||||
--stringparam collect.xref.targets="no"
|
XMLTO_HTML_FLAGS = \
|
||||||
|
$(XMLTO_SEARCHPATH_FLAGS) \
|
||||||
XMLTO_XHTML_FLAGS = \
|
$(XMLTO_HTML_STYLESHEET_FLAGS) \
|
||||||
-x $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl \
|
$(XMLTO_HTML_CSS_STYLESHEET_FLAGS) \
|
||||||
--stringparam html.stylesheet=$(STYLESHEET_SRCDIR)/xorg.css
|
$(XMLTO_HTML_OLINK_FLAGS)
|
||||||
|
|
||||||
XMLTO_FO_FLAGS = \
|
|
||||||
-x $(STYLESHEET_SRCDIR)/xorg-fo.xsl
|
|
||||||
endif HAVE_STYLESHEETS
|
|
||||||
|
|
||||||
shelf_DATA += $(docbook:.xml=.html)
|
shelf_DATA += $(docbook:.xml=.html)
|
||||||
%.html: %.xml $(chapters)
|
%.html: %.xml $(chapters)
|
||||||
$(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) $(XMLTO_XHTML_FLAGS) xhtml-nochunks $<
|
$(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) xhtml-nochunks $<
|
||||||
|
|
||||||
if HAVE_FOP
|
|
||||||
shelf_DATA += $(docbook:.xml=.pdf) $(docbook:.xml=.ps)
|
|
||||||
%.pdf: %.xml $(chapters)
|
|
||||||
$(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) $(XMLTO_FO_FLAGS) --with-fop pdf $<
|
|
||||||
%.ps: %.xml $(chapters)
|
|
||||||
$(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) $(XMLTO_FO_FLAGS) --with-fop ps $<
|
|
||||||
endif HAVE_FOP
|
|
||||||
|
|
||||||
if HAVE_XMLTO_TEXT
|
if HAVE_XMLTO_TEXT
|
||||||
|
|
||||||
shelf_DATA += $(docbook:.xml=.txt)
|
shelf_DATA += $(docbook:.xml=.txt)
|
||||||
%.txt: %.xml $(chapters)
|
%.txt: %.xml $(chapters)
|
||||||
$(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) $(XMLTO_XHTML_FLAGS) txt $<
|
$(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) txt $<
|
||||||
endif HAVE_XMLTO_TEXT
|
endif HAVE_XMLTO_TEXT
|
||||||
|
|
||||||
#
|
if HAVE_FOP
|
||||||
# Generate documents cross-reference target databases
|
XMLTO_FO_IMAGEPATH_FLAGS = --stringparam img.src.path=$(abs_builddir)/
|
||||||
#
|
XMLTO_PDF_OLINK_FLAGS = \
|
||||||
|
--stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.pdf.xml \
|
||||||
|
--stringparam current.docid="$(<:.xml=)"
|
||||||
|
XMLTO_FO_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-fo.xsl
|
||||||
|
|
||||||
# This is only possible if the xorg-sgml-doctools package is installed
|
XMLTO_FO_FLAGS = \
|
||||||
if HAVE_STYLESHEETS
|
$(XMLTO_SEARCHPATH_FLAGS) \
|
||||||
|
$(XMLTO_FO_STYLESHEET_FLAGS) \
|
||||||
|
$(XMLTO_FO_IMAGEPATH_FLAGS) \
|
||||||
|
$(XMLTO_PDF_OLINK_FLAGS)
|
||||||
|
|
||||||
|
shelf_DATA += $(docbook:.xml=.pdf)
|
||||||
|
%.pdf: %.xml $(chapters)
|
||||||
|
$(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop pdf $<
|
||||||
|
|
||||||
|
shelf_DATA += $(docbook:.xml=.ps)
|
||||||
|
%.ps: %.xml $(chapters)
|
||||||
|
$(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop ps $<
|
||||||
|
endif HAVE_FOP
|
||||||
|
|
||||||
|
# Generate documents cross-reference target databases
|
||||||
if HAVE_XSLTPROC
|
if HAVE_XSLTPROC
|
||||||
|
|
||||||
# DocBook/XML generated document cross-reference database
|
XSLT_SEARCHPATH_FLAGS = \
|
||||||
shelf_DATA += $(docbook:.xml=.html.db) $(docbook:.xml=.fo.db)
|
|
||||||
|
|
||||||
# Generate DocBook/XML document cross-reference database
|
|
||||||
# Flags for the XSL Transformation processor generating xref target databases
|
|
||||||
XSLTPROC_FLAGS = \
|
|
||||||
--path "$(XORG_SGML_PATH)/X11" \
|
--path "$(XORG_SGML_PATH)/X11" \
|
||||||
--path "$(abs_top_builddir)" \
|
--path "$(abs_top_builddir)"
|
||||||
--stringparam targets.filename "$@" \
|
XSLT_OLINK_FLAGS = \
|
||||||
--stringparam collect.xref.targets "only" \
|
--stringparam targets.filename "$@" \
|
||||||
--nonet --xinclude
|
--stringparam collect.xref.targets "only" \
|
||||||
|
--stringparam olink.base.uri "$(@:.db=)"
|
||||||
|
|
||||||
|
XSLT_HTML_FLAGS = \
|
||||||
|
$(XSLT_SEARCHPATH_FLAGS) \
|
||||||
|
$(XSLT_OLINK_FLAGS) \
|
||||||
|
--nonet --xinclude \
|
||||||
|
$(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
|
||||||
|
XSLT_PDF_FLAGS = \
|
||||||
|
$(XSLT_SEARCHPATH_FLAGS) \
|
||||||
|
$(XSLT_OLINK_FLAGS) \
|
||||||
|
--nonet --xinclude \
|
||||||
|
$(STYLESHEET_SRCDIR)/xorg-fo.xsl
|
||||||
|
|
||||||
|
shelf_DATA += $(docbook:.xml=.html.db)
|
||||||
%.html.db: %.xml $(chapters)
|
%.html.db: %.xml $(chapters)
|
||||||
$(AM_V_GEN)$(XSLTPROC) $(XSLTPROC_FLAGS) \
|
$(AM_V_GEN)$(XSLTPROC) $(XSLT_HTML_FLAGS) $<
|
||||||
http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl $<
|
|
||||||
|
|
||||||
%.fo.db: %.xml $(chapters)
|
shelf_DATA += $(docbook:.xml=.pdf.db)
|
||||||
$(AM_V_GEN)$(XSLTPROC) $(XSLTPROC_FLAGS) \
|
%.pdf.db: %.xml $(chapters)
|
||||||
http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl $<
|
$(AM_V_GEN)$(XSLTPROC) $(XSLT_PDF_FLAGS) $<
|
||||||
|
|
||||||
endif HAVE_XSLTPROC
|
endif HAVE_XSLTPROC
|
||||||
endif HAVE_STYLESHEETS
|
endif HAVE_STYLESHEETS
|
||||||
|
|
Loading…
Reference in New Issue