mirror of https://github.com/tLDP/LDP
adding some more stuff that will probably never be re-used
This commit is contained in:
parent
dbfdcd59ba
commit
4405669b6d
|
@ -0,0 +1,113 @@
|
||||||
|
# -- Makefile for handling TLDP documentation
|
||||||
|
#
|
||||||
|
#
|
||||||
|
|
||||||
|
default: help
|
||||||
|
|
||||||
|
DESTDIR := output
|
||||||
|
NODESTDIR := $(shell stat 2>/dev/null -t $(DESTDIR))
|
||||||
|
ifeq ($(NODESTDIR),)
|
||||||
|
$(error ENOENT (2): $(DESTDIR); please create or specify alternate DESTDIR directory)
|
||||||
|
endif
|
||||||
|
|
||||||
|
WORKING := working
|
||||||
|
DOCBASE := $(WORKING)/ldp
|
||||||
|
NOWORKING := $(shell stat 2>/dev/null -t $(WORKING))
|
||||||
|
ifeq ($(NOWORKING),)
|
||||||
|
$(error ENOENT (2): $(WORKING); please create or specify alternate WORKING directory)
|
||||||
|
endif
|
||||||
|
|
||||||
|
DOCBASE := $(abspath $(DOCBASE))
|
||||||
|
|
||||||
|
VCSBASE := /home/mabrown/vcs/LDP/LDP
|
||||||
|
LDPDSL := $(VCSBASE)/builder/dsssl/ldp.dsl
|
||||||
|
|
||||||
|
#OBJS := $(VCSBASE)/faq/docbook/LDP-FAQ.xml $(VCSBASE)/howto/docbook/Traffic-Control-HOWTO/Traffic-Control-HOWTO.xml
|
||||||
|
OBJ = $(VCSBASE)/howto/docbook/Aviation-HOWTO.xml
|
||||||
|
OBJDIR = $(dir $(OBJ))
|
||||||
|
OBJFORMAT = $(lastword $(subst ., ,$(suffix $(OBJ))))
|
||||||
|
OBJFILE = $(notdir $(OBJ))
|
||||||
|
OBJSTEM = $(OBJFILE:.$(OBJFORMAT)=)
|
||||||
|
|
||||||
|
OUTDIR = $(DOCBASE)/$(OBJSTEM)
|
||||||
|
|
||||||
|
PDF = $(OUTDIR)/$(OBJSTEM).pdf
|
||||||
|
HTML = $(OUTDIR)/$(OBJSTEM).html
|
||||||
|
HTMLS = $(OUTDIR)/$(OBJSTEM)-single.html
|
||||||
|
TEXT = $(OUTDIR)/$(OBJSTEM).txt
|
||||||
|
|
||||||
|
all: clear_$(WORKING) $(HTMLS) $(TEXT) $(PDF) $(HTML)
|
||||||
|
tree $(DOCBASE)
|
||||||
|
rsync --archive --verbose --partial $(WORKING)/ $(DESTDIR)/
|
||||||
|
|
||||||
|
clear_$(WORKING):
|
||||||
|
(test ! -d $(DOCBASE) || ( cd $(WORKING) && rm -rf -- $(notdir $(DOCBASE))))
|
||||||
|
|
||||||
|
$(DOCBASE): $(DESTDIR)
|
||||||
|
mkdir -p $(DOCBASE)
|
||||||
|
|
||||||
|
$(OUTDIR): $(DOCBASE)
|
||||||
|
mkdir -p $(OUTDIR)
|
||||||
|
|
||||||
|
$(OUTDIR)/images: $(OUTDIR)
|
||||||
|
(cd $(OBJDIR) && test ! -d images || cp -rva images $(OUTDIR))
|
||||||
|
|
||||||
|
$(HTMLS): $(OUTDIR) $(OUTDIR)/images
|
||||||
|
# -- note the mv -vu $(notdir $(HTML)) $(notdir $(HTMLS))
|
||||||
|
# the docbook2html processor will create a single-page
|
||||||
|
# HTML file called $(OBJSTEM).html, which we will want
|
||||||
|
# to create as a symlink, later
|
||||||
|
(cd $(OUTDIR) \
|
||||||
|
&& jw -f docbook -b html \
|
||||||
|
--dsl "$(LDPDSL)#html" \
|
||||||
|
-V nochunks \
|
||||||
|
-V '%callout-graphics-path%=images/callouts/' \
|
||||||
|
-V '%stock-graphics-extension%=.png' \
|
||||||
|
-V '%stylsheet-type%=freddie.css' \
|
||||||
|
--output . \
|
||||||
|
$(OBJ) \
|
||||||
|
&& mv -vu $(notdir $(HTML)) $(notdir $(HTMLS)))
|
||||||
|
# -- what about images and other resources?
|
||||||
|
|
||||||
|
$(TEXT): $(HTMLS)
|
||||||
|
(cd $(OUTDIR) && html2text -style pretty -nobs $(notdir $(HTMLS)) > $(notdir $@))
|
||||||
|
|
||||||
|
$(PDF): $(OUTDIR)
|
||||||
|
( cd $(OUTDIR) \
|
||||||
|
&& jw -f docbook -b pdf --output . $(OBJ))
|
||||||
|
|
||||||
|
$(HTML): $(OUTDIR)
|
||||||
|
# -- the jade DocBook processing toolchain produces an HTML output
|
||||||
|
# file called index.html in the chunked output; therefore, we want
|
||||||
|
# to create a link from Some-Name.html to index.html.
|
||||||
|
( cd $(OUTDIR) \
|
||||||
|
&& jw -f docbook -b html \
|
||||||
|
--dsl "$(LDPDSL)#html" \
|
||||||
|
-V '%admon-graphics-path%=images/' \
|
||||||
|
-V '%callout-graphics-path%=images/callouts/' \
|
||||||
|
-V '%stock-graphics-extension%=.png' \
|
||||||
|
--output . \
|
||||||
|
$(OBJ) \
|
||||||
|
&& ln -snvf index.html $(notdir $(HTML)))
|
||||||
|
# -- what about images and other resources?
|
||||||
|
|
||||||
|
vars:
|
||||||
|
printf "%s\n" \
|
||||||
|
"OBJ = $(OBJ)" \
|
||||||
|
"OBJFILE = $(OBJFILE)" \
|
||||||
|
"OBJSTEM = $(OBJSTEM)" \
|
||||||
|
"DOCS = $(DOCS)" \
|
||||||
|
"PDF = $(PDF)" \
|
||||||
|
"HTML = $(HTML)" \
|
||||||
|
"HTMLS = $(HTMLS)" \
|
||||||
|
"TEXT = $(TEXT)" \
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
.PHONY: help
|
||||||
|
help:
|
||||||
|
@printf "%s\n" \
|
||||||
|
"There will be help here in the future."
|
||||||
|
|
||||||
|
#
|
||||||
|
# -- end of file
|
|
@ -0,0 +1,120 @@
|
||||||
|
# -- Makefile for handling TLDP documentation
|
||||||
|
#
|
||||||
|
#
|
||||||
|
|
||||||
|
default: help
|
||||||
|
|
||||||
|
DESTDIR := output
|
||||||
|
NODESTDIR := $(shell stat 2>/dev/null -t $(DESTDIR))
|
||||||
|
ifeq ($(NODESTDIR),)
|
||||||
|
$(error ENOENT (2): $(DESTDIR); please create or specify alternate DESTDIR directory)
|
||||||
|
endif
|
||||||
|
|
||||||
|
WORKING := working
|
||||||
|
DOCBASE := $(WORKING)/ldp
|
||||||
|
NOWORKING := $(shell stat 2>/dev/null -t $(WORKING))
|
||||||
|
ifeq ($(NOWORKING),)
|
||||||
|
$(error ENOENT (2): $(WORKING); please create or specify alternate WORKING directory)
|
||||||
|
endif
|
||||||
|
|
||||||
|
DOCBASE := $(abspath $(DOCBASE))
|
||||||
|
|
||||||
|
VCSBASE := /home/mabrown/vcs/LDP/LDP
|
||||||
|
|
||||||
|
XML_CATALOG_FILES := /etc/xml/catalog
|
||||||
|
XSLCHUNK := /home/mabrown/vcs/LDP/LDP/builder/xsl/ldp-html-chunk.xsl
|
||||||
|
XSLSINGLE := /home/mabrown/vcs/LDP/LDP/builder/xsl/ldp-html.xsl
|
||||||
|
XSLPRINT := /home/mabrown/vcs/LDP/LDP/builder/xsl/ldp-print.xsl
|
||||||
|
|
||||||
|
#OBJS := $(VCSBASE)/faq/docbook/LDP-FAQ.xml $(VCSBASE)/howto/docbook/Traffic-Control-HOWTO/Traffic-Control-HOWTO.xml
|
||||||
|
OBJ = $(VCSBASE)/howto/docbook/Aviation-HOWTO.xml
|
||||||
|
OBJDIR = $(dir $(OBJ))
|
||||||
|
OBJFORMAT = $(lastword $(subst ., ,$(suffix $(OBJ))))
|
||||||
|
OBJFILE = $(notdir $(OBJ))
|
||||||
|
OBJSTEM = $(OBJFILE:.$(OBJFORMAT)=)
|
||||||
|
|
||||||
|
OUTDIR = $(DOCBASE)/$(OBJSTEM)
|
||||||
|
|
||||||
|
FO = $(OUTDIR)/$(OBJSTEM).fo
|
||||||
|
PDF = $(OUTDIR)/$(OBJSTEM).pdf
|
||||||
|
HTML = $(OUTDIR)/$(OBJSTEM).html
|
||||||
|
HTMLS = $(OUTDIR)/$(OBJSTEM)-single.html
|
||||||
|
TEXT = $(OUTDIR)/$(OBJSTEM).txt
|
||||||
|
|
||||||
|
all: clear_$(WORKING) $(HTMLS) $(TEXT) $(PDF) $(HTML)
|
||||||
|
tree $(DOCBASE)
|
||||||
|
rsync --archive --verbose --partial $(WORKING)/ $(DESTDIR)/
|
||||||
|
|
||||||
|
clear_$(WORKING):
|
||||||
|
(test ! -d $(DOCBASE) || ( cd $(WORKING) && rm -rf -- $(notdir $(DOCBASE))))
|
||||||
|
|
||||||
|
$(DOCBASE): $(DESTDIR)
|
||||||
|
mkdir -p $(DOCBASE)
|
||||||
|
|
||||||
|
$(OUTDIR): $(DOCBASE)
|
||||||
|
mkdir -p $(OUTDIR)
|
||||||
|
|
||||||
|
$(OUTDIR)/images: $(OUTDIR)
|
||||||
|
(cd $(OBJDIR) && test ! -d images || cp -rva images $(OUTDIR))
|
||||||
|
|
||||||
|
$(HTMLS): $(OUTDIR) $(OUTDIR)/images
|
||||||
|
# -- note the mv -vu $(notdir $(HTML)) $(notdir $(HTMLS))
|
||||||
|
# the docbook2html processor will create a single-page
|
||||||
|
# HTML file called $(OBJSTEM).html, which we will want
|
||||||
|
# to create as a symlink, later
|
||||||
|
(cd $(OUTDIR) \
|
||||||
|
&& XML_CATALOG_FILES="$(XML_CATALOG_FILES)" \
|
||||||
|
xsltproc > "$(notdir $(HTMLS))" \
|
||||||
|
--nonet \
|
||||||
|
--stringparam admon.graphics.path images/ \
|
||||||
|
--stringparam base.dir . \
|
||||||
|
"$(XSLSINGLE)" "$(OBJ)")
|
||||||
|
# -- what about images and other resources?
|
||||||
|
|
||||||
|
$(TEXT): $(HTMLS)
|
||||||
|
(cd $(OUTDIR) && html2text -style pretty -nobs $(notdir $(HTMLS)) > $(notdir $@))
|
||||||
|
|
||||||
|
$(FO): $(OUTDIR)
|
||||||
|
( cd $(OUTDIR) \
|
||||||
|
&& XML_CATALOG_FILES=/etc/xml/catalog \
|
||||||
|
xsltproc > "$(notdir $(FO))" \
|
||||||
|
--nonet \
|
||||||
|
"$(XSLPRINT)" "$(OBJ)")
|
||||||
|
|
||||||
|
$(PDF): $(FO)
|
||||||
|
(fop -fo $(FO) -pdf $(PDF) && rm -f $(FO)) || :
|
||||||
|
|
||||||
|
$(HTML): $(HTMLS)
|
||||||
|
# -- the jade DocBook processing toolchain produces an HTML output
|
||||||
|
# file called index.html in the chunked output; therefore, we want
|
||||||
|
# to create a link from Some-Name.html to index.html.
|
||||||
|
( cd $(OUTDIR) \
|
||||||
|
&& XML_CATALOG_FILES=/etc/xml/catalog \
|
||||||
|
xsltproc \
|
||||||
|
--nonet \
|
||||||
|
--stringparam admon.graphics.path images/ \
|
||||||
|
--stringparam base.dir . \
|
||||||
|
"$(XSLCHUNK)" "$(OBJ)" \
|
||||||
|
&& ln -snvf index.html $(notdir $(HTML)))
|
||||||
|
# -- what about images and other resources?
|
||||||
|
|
||||||
|
vars:
|
||||||
|
printf "%s\n" \
|
||||||
|
"OBJ = $(OBJ)" \
|
||||||
|
"OBJFILE = $(OBJFILE)" \
|
||||||
|
"OBJSTEM = $(OBJSTEM)" \
|
||||||
|
"DOCS = $(DOCS)" \
|
||||||
|
"PDF = $(PDF)" \
|
||||||
|
"HTML = $(HTML)" \
|
||||||
|
"HTMLS = $(HTMLS)" \
|
||||||
|
"TEXT = $(TEXT)" \
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
.PHONY: help
|
||||||
|
help:
|
||||||
|
@printf "%s\n" \
|
||||||
|
"There will be help here in the future."
|
||||||
|
|
||||||
|
#
|
||||||
|
# -- end of file
|
|
@ -0,0 +1,93 @@
|
||||||
|
# -- Makefile for handling TLDP documentation
|
||||||
|
#
|
||||||
|
#
|
||||||
|
|
||||||
|
default: help
|
||||||
|
|
||||||
|
DESTDIR := output
|
||||||
|
NODESTDIR := $(shell stat 2>/dev/null -t $(DESTDIR))
|
||||||
|
ifeq ($(NODESTDIR),)
|
||||||
|
$(error ENOENT (2): $(DESTDIR); please create or specify alternate DESTDIR directory)
|
||||||
|
endif
|
||||||
|
|
||||||
|
WORKING := working
|
||||||
|
DOCBASE := $(WORKING)/ldp
|
||||||
|
NOWORKING := $(shell stat 2>/dev/null -t $(WORKING))
|
||||||
|
ifeq ($(NOWORKING),)
|
||||||
|
$(error ENOENT (2): $(WORKING); please create or specify alternate WORKING directory)
|
||||||
|
endif
|
||||||
|
|
||||||
|
VCSBASE := /home/mabrown/vcs/LDP/LDP
|
||||||
|
|
||||||
|
#OBJ = $(VCSBASE)/howto/linuxdoc/TransparentProxy.sgml
|
||||||
|
OBJ = /home/mabrown/tmp/Large-Disk-HOWTO/Large-Disk-HOWTO.sgml
|
||||||
|
OBJFORMAT = $(lastword $(subst ., ,$(suffix $(OBJ))))
|
||||||
|
OBJFILE = $(notdir $(OBJ))
|
||||||
|
OBJSTEM = $(OBJFILE:.$(OBJFORMAT)=)
|
||||||
|
|
||||||
|
OUTDIR = $(DOCBASE)/$(OBJSTEM)
|
||||||
|
|
||||||
|
PDF = $(OUTDIR)/$(OBJSTEM).pdf
|
||||||
|
HTML = $(OUTDIR)/$(OBJSTEM).html
|
||||||
|
HTMLS = $(OUTDIR)/$(OBJSTEM)-single.html
|
||||||
|
TEXT = $(OUTDIR)/$(OBJSTEM).txt
|
||||||
|
|
||||||
|
all: clear_$(WORKING) $(HTMLS) $(TEXT) $(PDF) $(HTML)
|
||||||
|
tree $(DOCBASE)
|
||||||
|
rsync --archive --verbose --partial $(WORKING)/ $(DESTDIR)/
|
||||||
|
|
||||||
|
clear_$(WORKING):
|
||||||
|
(test ! -d $(DOCBASE) || ( cd $(WORKING) && rm -rf -- $(notdir $(DOCBASE))))
|
||||||
|
|
||||||
|
$(DOCBASE): $(DESTDIR)
|
||||||
|
mkdir -p $(DOCBASE)
|
||||||
|
|
||||||
|
$(OUTDIR): $(DOCBASE)
|
||||||
|
mkdir -p $(OUTDIR)
|
||||||
|
|
||||||
|
$(HTMLS): $(OUTDIR)
|
||||||
|
# -- note the mv -vu $(notdir $(HTML)) $(notdir $(HTMLS))
|
||||||
|
# the docbook2html processor will create a single-page
|
||||||
|
# HTML file called $(OBJSTEM).html, which we will want
|
||||||
|
# to create as a symlink, later
|
||||||
|
(cd $(OUTDIR) \
|
||||||
|
&& sgml2html --split=0 $(OBJ) \
|
||||||
|
&& mv -vu $(notdir $(HTML)) $(notdir $(HTMLS)))
|
||||||
|
# -- what about images and other resources?
|
||||||
|
|
||||||
|
$(TEXT): $(HTMLS)
|
||||||
|
(cd $(OUTDIR) && html2text -style pretty -nobs $(notdir $(HTMLS)) > $(notdir $@))
|
||||||
|
|
||||||
|
$(PDF): $(HTMLS)
|
||||||
|
( cd $(OUTDIR) \
|
||||||
|
&& htmldoc --size universal -t pdf --firstpage p1 --outfile $(notdir $@) $(notdir $(HTMLS)))
|
||||||
|
|
||||||
|
$(HTML): $(OUTDIR)
|
||||||
|
# -- LinuxDoc processing tools create the output document file as
|
||||||
|
# Some-Name.html (and Some-Name-1.html, Some-Name-2.html), so we
|
||||||
|
# should create a symlink from index.html to the Some-Name.html.
|
||||||
|
( cd $(OUTDIR) \
|
||||||
|
&& sgml2html $(OBJ) \
|
||||||
|
&& ln -snvf $(notdir $(HTML)) index.html)
|
||||||
|
# -- what about images and other resources?
|
||||||
|
|
||||||
|
vars:
|
||||||
|
printf "%s\n" \
|
||||||
|
"OBJ = $(OBJ)" \
|
||||||
|
"OBJFILE = $(OBJFILE)" \
|
||||||
|
"OBJSTEM = $(OBJSTEM)" \
|
||||||
|
"DOCS = $(DOCS)" \
|
||||||
|
"PDF = $(PDF)" \
|
||||||
|
"HTML = $(HTML)" \
|
||||||
|
"HTMLS = $(HTMLS)" \
|
||||||
|
"TEXT = $(TEXT)" \
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
.PHONY: help
|
||||||
|
help:
|
||||||
|
@printf "%s\n" \
|
||||||
|
"There will be help here in the future."
|
||||||
|
|
||||||
|
#
|
||||||
|
# -- end of file
|
|
@ -0,0 +1,156 @@
|
||||||
|
# -- Makefile for handling TLDP documentation
|
||||||
|
#
|
||||||
|
#
|
||||||
|
|
||||||
|
default: help
|
||||||
|
|
||||||
|
DESTDIR := output
|
||||||
|
NODESTDIR := $(shell stat 2>/dev/null -t $(DESTDIR))
|
||||||
|
ifeq ($(NODESTDIR),)
|
||||||
|
$(error ENOENT (2): $(DESTDIR); please create or specify alternate DESTDIR directory)
|
||||||
|
endif
|
||||||
|
|
||||||
|
WORKING := working
|
||||||
|
NOWORKING := $(shell stat 2>/dev/null -t $(WORKING))
|
||||||
|
ifeq ($(NOWORKING),)
|
||||||
|
$(error ENOENT (2): $(WORKING); please create or specify alternate WORKING directory)
|
||||||
|
endif
|
||||||
|
|
||||||
|
ifeq ($(OBJ),)
|
||||||
|
$(error OBJ not specified, please supply a DocBook SGML source file)
|
||||||
|
endif
|
||||||
|
|
||||||
|
FLAVOR=$(shell awk -F= '/^ID=/{print $$2}' /etc/os-release)
|
||||||
|
ifeq ($(FLAVOR),ubuntu)
|
||||||
|
# -- Ubuntu:
|
||||||
|
# -- for DocBook SGML (DSSSL) processing
|
||||||
|
LDPDSL := /usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl
|
||||||
|
DBDSL := /usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl
|
||||||
|
COLLATE := /usr/bin/collateindex.pl
|
||||||
|
# -- for DocBook XML (XSLT layer) processing
|
||||||
|
XSLCHUNK := /usr/share/xml/docbook/stylesheet/ldp/html/tldp-sections.xsl
|
||||||
|
XSLSINGLE := /usr/share/xml/docbook/stylesheet/ldp/html/tldp-one-page.xsl
|
||||||
|
XSLPRINT := /usr/share/xml/docbook/stylesheet/ldp/fo/tldp-print.xsl
|
||||||
|
else ifeq ($(FLAVOR),opensuse)
|
||||||
|
# -- OpenSUSE-13.2
|
||||||
|
# -- for DocBook SGML (DSSSL) processing
|
||||||
|
DBDSL := /usr/share/sgml/docbook/dsssl-stylesheets-1.79/html/docbook.dsl
|
||||||
|
COLLATE := /usr/share/sgml/docbook/dsssl-stylesheets-1.79/bin/collateindex.pl
|
||||||
|
LDPDSL := /home/mabrown/vcs/LDP/LDP/builder/dsssl/ldp.dsl
|
||||||
|
# -- for DocBook XML (XSLT layer) processing
|
||||||
|
XSLCHUNK := /home/mabrown/vcs/LDP/LDP/builder/xsl/ldp-html-chunk.xsl
|
||||||
|
XSLSINGLE := /home/mabrown/vcs/LDP/LDP/builder/xsl/ldp-html.xsl
|
||||||
|
XSLPRINT := /home/mabrown/vcs/LDP/LDP/builder/xsl/ldp-print.xsl
|
||||||
|
else
|
||||||
|
$(error Sorry, unknown/untested flavor of Linux, $(FLAVOR))
|
||||||
|
endif
|
||||||
|
|
||||||
|
# -- standard definitions and other little tools
|
||||||
|
#
|
||||||
|
XML_CATALOG_FILES := /etc/xml/catalog
|
||||||
|
PERL := $(shell which perl 2>/dev/null)
|
||||||
|
VERBOSE :=
|
||||||
|
|
||||||
|
OBJDIR = $(dir $(OBJ))
|
||||||
|
OBJFORMAT = $(lastword $(subst ., ,$(suffix $(OBJ))))
|
||||||
|
OBJFILE = $(notdir $(OBJ))
|
||||||
|
OBJSTEM = $(OBJFILE:.$(OBJFORMAT)=)
|
||||||
|
OBJINDEX = $(abspath $(OBJDIR)/index.sgml)
|
||||||
|
|
||||||
|
OUTDIR = $(abspath $(abspath $(WORKING))/$(OBJSTEM))
|
||||||
|
|
||||||
|
PDF = $(abspath $(OUTDIR)/$(OBJSTEM).pdf)
|
||||||
|
HTML = $(abspath $(OUTDIR)/$(OBJSTEM).html)
|
||||||
|
HTMLS = $(abspath $(OUTDIR)/$(OBJSTEM)-single.html)
|
||||||
|
TEXT = $(abspath $(OUTDIR)/$(OBJSTEM).txt)
|
||||||
|
|
||||||
|
all: $(OBJFORMAT)-all
|
||||||
|
|
||||||
|
sgml-all: clear_$(OUTDIR) sgml-$(OBJINDEX) sgml-$(HTMLS) $(TEXT) sgml-$(PDF) sgml-$(HTML)
|
||||||
|
rm -f -- "$(OBJINDEX)"
|
||||||
|
rsync $(VERBOSE) --archive --delay-updates --delete-after --partial $(OUTDIR)/ $(DESTDIR)/$(OBJSTEM)/
|
||||||
|
|
||||||
|
clear_$(OUTDIR):
|
||||||
|
(test ! -d $(OUTDIR) || ( cd $(dir $(OUTDIR)) && rm -rf $(VERBOSE) -- $(notdir $(OUTDIR))))
|
||||||
|
|
||||||
|
$(OUTDIR): $(WORKING)
|
||||||
|
mkdir $(OUTDIR)
|
||||||
|
|
||||||
|
$(OUTDIR)/images $(OUTDIR)/resources: $(OUTDIR)
|
||||||
|
(cd $(OBJDIR) && test ! -d $(notdir $@) || rsync -aL $(VERBOSE) ./$(notdir $@) $(OUTDIR))
|
||||||
|
|
||||||
|
sgml-$(OBJINDEX): $(OUTDIR)/images $(OUTDIR)/resources
|
||||||
|
(cd $(OUTDIR) \
|
||||||
|
&& $(PERL) $(COLLATE) -N -o "$(OBJINDEX)" \
|
||||||
|
&& openjade -t sgml -V html-index -d "$(DBDSL)" "$(OBJ)" \
|
||||||
|
&& $(PERL) $(COLLATE) -g -t Index -i doc-index -o "$(notdir $(OBJINDEX))" HTML.index "$(OBJ)" \
|
||||||
|
&& mv -f $(VERBOSE) -- $(notdir $(OBJINDEX)) $(dir $(OBJINDEX)) \
|
||||||
|
&& find . -mindepth 1 -maxdepth 1 -type f -print0 | xargs --null --no-run-if-empty -- rm -f --)
|
||||||
|
|
||||||
|
sgml-$(HTMLS): $(OUTDIR)/resources $(OUTDIR)/images $(INDEX)
|
||||||
|
# -- note the mv -vu $(notdir $(HTML)) $(notdir $(HTMLS))
|
||||||
|
# the docbook2html processor will create a single-page
|
||||||
|
# HTML file called $(OBJSTEM).html. We want to name it
|
||||||
|
# $(OBJSTEM)-single.html, so that, later, $(OBJSTEM).html
|
||||||
|
# can be the main output for chunked HTML
|
||||||
|
#
|
||||||
|
(cd $(OUTDIR) \
|
||||||
|
&& jw -f docbook -b html \
|
||||||
|
--dsl "$(LDPDSL)#html" \
|
||||||
|
-V nochunks \
|
||||||
|
-V '%callout-graphics-path%=images/callouts/' \
|
||||||
|
-V '%stock-graphics-extension%=.png' \
|
||||||
|
-V '%stylsheet-type%=freddie.css' \
|
||||||
|
--output . \
|
||||||
|
$(OBJ) \
|
||||||
|
&& mv --update $(VERBOSE) -- $(notdir $(HTML)) $(notdir $(HTMLS)))
|
||||||
|
|
||||||
|
$(TEXT): sgml-$(HTMLS)
|
||||||
|
(cd $(OUTDIR) && html2text -style pretty -nobs $(notdir $(HTMLS)) > $(notdir $@))
|
||||||
|
|
||||||
|
sgml-$(PDF): $(OUTDIR)
|
||||||
|
( cd $(OUTDIR) \
|
||||||
|
&& jw -f docbook -b pdf --output . $(OBJ) \
|
||||||
|
|| dblatex -F sgml -t pdf -o sgml-$(PDF) $(OBJ))
|
||||||
|
|
||||||
|
sgml-$(HTML): $(OUTDIR)
|
||||||
|
# -- the jade DocBook processing toolchain produces an HTML output
|
||||||
|
# file called index.html in the chunked output; therefore, we want
|
||||||
|
# to create a link from Some-Name.html to index.html; if TLDP
|
||||||
|
# wishes to do something else with index.html, this is the place
|
||||||
|
# to change it (for SGML DocBook inputs, anyway).
|
||||||
|
#
|
||||||
|
( cd $(OUTDIR) \
|
||||||
|
&& jw -f docbook -b html \
|
||||||
|
--dsl "$(LDPDSL)#html" \
|
||||||
|
-V '%admon-graphics-path%=images/' \
|
||||||
|
-V '%callout-graphics-path%=images/callouts/' \
|
||||||
|
-V '%stock-graphics-extension%=.png' \
|
||||||
|
--output . \
|
||||||
|
$(OBJ) \
|
||||||
|
&& ln -snf $(VERBOSE) -- index.html $(notdir $(HTML)))
|
||||||
|
|
||||||
|
vars:
|
||||||
|
@printf "%s\n" \
|
||||||
|
"OBJ = $(OBJ)" \
|
||||||
|
"OBJDIR = $(OBJDIR)" \
|
||||||
|
"OBJINDEX = $(OBJINDEX)" \
|
||||||
|
"OBJFORMAT = $(OBJFORMAT)" \
|
||||||
|
"OBJFILE = $(OBJFILE)" \
|
||||||
|
"OBJSTEM = $(OBJSTEM)" \
|
||||||
|
"OUTDIR = $(OUTDIR)" \
|
||||||
|
"PDF = $(PDF)" \
|
||||||
|
"HTML = $(HTML)" \
|
||||||
|
"HTMLS = $(HTMLS)" \
|
||||||
|
"TEXT = $(TEXT)" \
|
||||||
|
"DESTDIR = $(DESTDIR)" \
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
.PHONY: help
|
||||||
|
help:
|
||||||
|
@printf "%s\n" \
|
||||||
|
"There will be help here in the future."
|
||||||
|
|
||||||
|
#
|
||||||
|
# -- end of file
|
|
@ -0,0 +1,118 @@
|
||||||
|
# -- Makefile for handling TLDP documentation
|
||||||
|
#
|
||||||
|
#
|
||||||
|
|
||||||
|
default: help
|
||||||
|
|
||||||
|
DESTDIR := output
|
||||||
|
NODESTDIR := $(shell stat 2>/dev/null -t $(DESTDIR))
|
||||||
|
ifeq ($(NODESTDIR),)
|
||||||
|
$(error ENOENT (2): $(DESTDIR); please create or specify alternate DESTDIR directory)
|
||||||
|
endif
|
||||||
|
|
||||||
|
WORKING := working
|
||||||
|
NOWORKING := $(shell stat 2>/dev/null -t $(WORKING))
|
||||||
|
ifeq ($(NOWORKING),)
|
||||||
|
$(error ENOENT (2): $(WORKING); please create or specify alternate WORKING directory)
|
||||||
|
endif
|
||||||
|
|
||||||
|
ifeq ($(OBJ),)
|
||||||
|
$(error OBJ not specified, please supply a DocBook XML source file)
|
||||||
|
endif
|
||||||
|
|
||||||
|
XML_CATALOG_FILES := /etc/xml/catalog
|
||||||
|
XSLCHUNK := /home/mabrown/vcs/LDP/LDP/builder/xsl/ldp-html-chunk.xsl
|
||||||
|
XSLSINGLE := /home/mabrown/vcs/LDP/LDP/builder/xsl/ldp-html.xsl
|
||||||
|
XSLPRINT := /home/mabrown/vcs/LDP/LDP/builder/xsl/ldp-print.xsl
|
||||||
|
#XSLCHUNK := /usr/share/xml/docbook/stylesheet/ldp/html/tldp-sections.xsl
|
||||||
|
#XSLSINGLE := /usr/share/xml/docbook/stylesheet/ldp/html/tldp-one-page.xsl
|
||||||
|
#XSLPRINT := /usr/share/xml/docbook/stylesheet/ldp/fo/tldp-print.xsl
|
||||||
|
|
||||||
|
|
||||||
|
OBJDIR = $(dir $(OBJ))
|
||||||
|
OBJFORMAT = $(lastword $(subst ., ,$(suffix $(OBJ))))
|
||||||
|
OBJFILE = $(notdir $(OBJ))
|
||||||
|
OBJSTEM = $(OBJFILE:.$(OBJFORMAT)=)
|
||||||
|
|
||||||
|
OUTDIR = $(abspath $(abspath $(WORKING))/$(OBJSTEM))
|
||||||
|
|
||||||
|
FO = $(abspath $(OUTDIR)/$(OBJSTEM).fo)
|
||||||
|
PDF = $(abspath $(OUTDIR)/$(OBJSTEM).pdf)
|
||||||
|
HTML = $(abspath $(OUTDIR)/$(OBJSTEM).html)
|
||||||
|
HTMLS = $(abspath $(OUTDIR)/$(OBJSTEM)-single.html)
|
||||||
|
TEXT = $(abspath $(OUTDIR)/$(OBJSTEM).txt)
|
||||||
|
|
||||||
|
all: vars clear_$(OUTDIR) $(HTMLS) $(TEXT) $(PDF) $(HTML)
|
||||||
|
rsync --archive --verbose --delay-updates --delete-after --partial $(OUTDIR)/ $(DESTDIR)/$(OBJSTEM)/
|
||||||
|
|
||||||
|
clear_$(OUTDIR):
|
||||||
|
(test ! -d $(OUTDIR) || ( cd $(dir $(OUTDIR)) && rm -rf -- $(notdir $(OUTDIR))))
|
||||||
|
|
||||||
|
$(OUTDIR): $(WORKING)
|
||||||
|
mkdir $(OUTDIR)
|
||||||
|
|
||||||
|
$(OUTDIR)/images $(OUTDIR)/resources: $(OUTDIR)
|
||||||
|
(cd $(OBJDIR) && test ! -d $(notdir $@) || rsync -avL ./$(notdir $@) $(OUTDIR))
|
||||||
|
|
||||||
|
$(HTMLS): $(OUTDIR) $(OUTDIR)/images $(OUTDIR)/resources
|
||||||
|
# -- note the mv -vu $(notdir $(HTML)) $(notdir $(HTMLS))
|
||||||
|
# the docbook2html processor will create a single-page
|
||||||
|
# HTML file called $(OBJSTEM).html, which we will want
|
||||||
|
# to create as a symlink, later
|
||||||
|
(cd $(OUTDIR) \
|
||||||
|
&& XML_CATALOG_FILES="$(XML_CATALOG_FILES)" \
|
||||||
|
xsltproc > "$(notdir $(HTMLS))" \
|
||||||
|
--nonet \
|
||||||
|
--stringparam admon.graphics.path images/ \
|
||||||
|
--stringparam base.dir . \
|
||||||
|
"$(XSLSINGLE)" "$(OBJ)")
|
||||||
|
# -- what about images and other resources?
|
||||||
|
|
||||||
|
$(TEXT): $(HTMLS)
|
||||||
|
(cd $(OUTDIR) && html2text -style pretty -nobs $(notdir $(HTMLS)) > $(notdir $@))
|
||||||
|
|
||||||
|
$(FO): $(OUTDIR)
|
||||||
|
( cd $(OUTDIR) \
|
||||||
|
&& XML_CATALOG_FILES=/etc/xml/catalog \
|
||||||
|
xsltproc > "$(notdir $(FO))" \
|
||||||
|
--nonet \
|
||||||
|
"$(XSLPRINT)" "$(OBJ)")
|
||||||
|
|
||||||
|
$(PDF): $(FO)
|
||||||
|
(fop -fo $(FO) -pdf $(PDF) && rm -f $(FO) \
|
||||||
|
|| dblatex -F xml -t pdf -o $(PDF) $(OBJ))
|
||||||
|
|
||||||
|
$(HTML): $(HTMLS)
|
||||||
|
( cd $(OUTDIR) \
|
||||||
|
&& XML_CATALOG_FILES=/etc/xml/catalog \
|
||||||
|
xsltproc \
|
||||||
|
--nonet \
|
||||||
|
--stringparam admon.graphics.path images/ \
|
||||||
|
--stringparam base.dir . \
|
||||||
|
"$(XSLCHUNK)" "$(OBJ)" \
|
||||||
|
&& ln -snvf index.html $(notdir $(HTML)))
|
||||||
|
# -- what about images and other resources?
|
||||||
|
|
||||||
|
vars:
|
||||||
|
printf "%s\n" \
|
||||||
|
"OBJ = $(OBJ)" \
|
||||||
|
"OBJFORMAT = $(OBJFORMAT)" \
|
||||||
|
"OBJFILE = $(OBJFILE)" \
|
||||||
|
"OBJSTEM = $(OBJSTEM)" \
|
||||||
|
"OUTDIR = $(OUTDIR)" \
|
||||||
|
"DOCS = $(DOCS)" \
|
||||||
|
"PDF = $(PDF)" \
|
||||||
|
"HTML = $(HTML)" \
|
||||||
|
"HTMLS = $(HTMLS)" \
|
||||||
|
"TEXT = $(TEXT)" \
|
||||||
|
"DESTDIR = $(DESTDIR)" \
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
.PHONY: help
|
||||||
|
help:
|
||||||
|
@printf "%s\n" \
|
||||||
|
"There will be help here in the future."
|
||||||
|
|
||||||
|
#
|
||||||
|
# -- end of file
|
|
@ -0,0 +1,93 @@
|
||||||
|
# -- Makefile for handling TLDP documentation
|
||||||
|
#
|
||||||
|
#
|
||||||
|
|
||||||
|
default: help
|
||||||
|
|
||||||
|
DESTDIR := output
|
||||||
|
NODESTDIR := $(shell stat 2>/dev/null -t $(DESTDIR))
|
||||||
|
ifeq ($(NODESTDIR),)
|
||||||
|
$(error ENOENT (2): $(DESTDIR); please create or specify alternate DESTDIR directory)
|
||||||
|
endif
|
||||||
|
|
||||||
|
WORKING := working
|
||||||
|
NOWORKING := $(shell stat 2>/dev/null -t $(WORKING))
|
||||||
|
ifeq ($(NOWORKING),)
|
||||||
|
$(error ENOENT (2): $(WORKING); please create or specify alternate WORKING directory)
|
||||||
|
endif
|
||||||
|
|
||||||
|
ifeq ($(OBJ),)
|
||||||
|
$(error OBJ not specified, please supply a LinuxDoc SGML source file)
|
||||||
|
endif
|
||||||
|
|
||||||
|
OBJFORMAT = $(lastword $(subst ., ,$(suffix $(OBJ))))
|
||||||
|
OBJFILE = $(notdir $(OBJ))
|
||||||
|
OBJSTEM = $(OBJFILE:.$(OBJFORMAT)=)
|
||||||
|
|
||||||
|
OUTDIR = $(abspath $(abspath $(WORKING))/$(OBJSTEM))
|
||||||
|
|
||||||
|
PDF = $(abspath $(OUTDIR)/$(OBJSTEM).pdf)
|
||||||
|
HTML = $(abspath $(OUTDIR)/$(OBJSTEM).html)
|
||||||
|
HTMLS = $(abspath $(OUTDIR)/$(OBJSTEM)-single.html)
|
||||||
|
TEXT = $(abspath $(OUTDIR)/$(OBJSTEM).txt)
|
||||||
|
|
||||||
|
all: vars clear_$(OUTDIR) $(HTMLS) $(TEXT) $(PDF) $(HTML)
|
||||||
|
echo rsync --archive --verbose --delay-updates --delete-after --partial $(WORKING)/ $(DESTDIR)/
|
||||||
|
|
||||||
|
clear_$(OUTDIR):
|
||||||
|
(test ! -d $(OUTDIR) || ( cd $(dir $(OUTDIR)) && rm -rf -- $(notdir $(OUTDIR))))
|
||||||
|
|
||||||
|
$(OUTDIR): $(WORKING)
|
||||||
|
mkdir $(OUTDIR)
|
||||||
|
|
||||||
|
$(OUTDIR)/images: $(OUTDIR)
|
||||||
|
(cd $(OBJDIR) && test ! -d images || rsync -avL ./images $(OUTDIR))
|
||||||
|
|
||||||
|
$(HTMLS): $(OUTDIR)/images
|
||||||
|
# -- note the mv -vu $(notdir $(HTML)) $(notdir $(HTMLS))
|
||||||
|
# the docbook2html processor will create a single-page
|
||||||
|
# HTML file called $(OBJSTEM).html, which we will want
|
||||||
|
# to create as a symlink, later
|
||||||
|
(cd $(OUTDIR) \
|
||||||
|
&& sgml2html --split=0 $(OBJ) \
|
||||||
|
&& mv -vu $(notdir $(HTML)) $(notdir $(HTMLS)))
|
||||||
|
# -- what about images and other resources?
|
||||||
|
|
||||||
|
$(TEXT): $(HTMLS)
|
||||||
|
(cd $(OUTDIR) && html2text -style pretty -nobs $(notdir $(HTMLS)) > $(notdir $@))
|
||||||
|
|
||||||
|
$(PDF): $(HTMLS)
|
||||||
|
( cd $(OUTDIR) \
|
||||||
|
&& htmldoc --size universal -t pdf --firstpage p1 --outfile $(notdir $@) $(notdir $(HTMLS)))
|
||||||
|
|
||||||
|
$(HTML): $(OUTDIR)
|
||||||
|
# -- LinuxDoc processing tools create the output document file as
|
||||||
|
# Some-Name.html (and Some-Name-1.html, Some-Name-2.html), so we
|
||||||
|
# should create a symlink from index.html to the Some-Name.html.
|
||||||
|
( cd $(OUTDIR) \
|
||||||
|
&& sgml2html $(OBJ) \
|
||||||
|
&& ln -snvf $(notdir $(HTML)) index.html)
|
||||||
|
# -- what about images and other resources?
|
||||||
|
|
||||||
|
vars:
|
||||||
|
printf " %s\n" \
|
||||||
|
"OBJ = $(OBJ)" \
|
||||||
|
"OBJFORMAT = $(OBJFORMAT)" \
|
||||||
|
"OBJFILE = $(OBJFILE)" \
|
||||||
|
"OBJSTEM = $(OBJSTEM)" \
|
||||||
|
"OUTDIR = $(OUTDIR)" \
|
||||||
|
"PDF = $(PDF)" \
|
||||||
|
"HTML = $(HTML)" \
|
||||||
|
"HTMLS = $(HTMLS)" \
|
||||||
|
"TEXT = $(TEXT)" \
|
||||||
|
"DESTDIR = $(DESTDIR)" \
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
.PHONY: help
|
||||||
|
help:
|
||||||
|
@printf "%s\n" \
|
||||||
|
"There will be help here in the future."
|
||||||
|
|
||||||
|
#
|
||||||
|
# -- end of file
|
Loading…
Reference in New Issue