Re: Docbook

[Stephane Bortzmeyer <bortzmeyer@pasteur.fr>]

On Thursday 2 September 1999, at 10 h 18, the keyboard of "J.H.M. Dassen 
\(Ray\)" <jdassen@wi.LeidenUniv.nl> wrote:

> See the Makefile in
> http://www.wi.LeidenUniv.nl/~jdassen/onderwijs/stuva/debug for an example.

Mine is simpler (but less complete), so I included it here, together with the custom stylesheet html.dsl. This is used in the java-common package. The source is 'policy.db' (db is for DocBook) which is in XML.

Note that you can give to jade a stylesheet (-d option) which is one of the installed ones (/usr/lib/sgml/...) or a custom one which in turn calls the installed ones. The Makefile shows both techniques.

Remember also there are *several* ways to do it. You can use DocBook without Norm Walsh's "Modular Stylesheets" (the docbook-stylesheets package).

You will need the DocBook apparatus:

jade
jadetex
docbook-xml
docbook-stylesheets
sp
lynx

and the packages they depend on, like tetex-*.

OUTPUTS=policy.html policy.txt policy.ps policy.db

all: policy

policy: policy.ps policy.txt policy.html

policy.tex: policy.db
	jade -t tex \
		-d /usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/print/docbook.dsl \
		/usr/lib/sgml/declaration/xml.decl $<

policy.dvi: policy.tex
	jadetex $<
	jadetex $<

policy.ps: policy.dvi
	dvips -f $< > $@

policy.html: policy.db html.dsl
	jade -t sgml \
		-d html.dsl \
		/usr/lib/sgml/declaration/xml.decl $< 

policy.txt: policy.db
	jade -t sgml -V nochunks \
		-d /usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/html/docbook.dsl \
	        /usr/lib/sgml/declaration/xml.decl $< > dump.html
	lynx -force_html -dump dump.html > $@
	-rm -f dump.html

validate:
	nsgmls -s -wxml /usr/lib/sgml/declaration/xml.decl policy.db

install: $(OUTPUTS)
	install -m 0444 $(OUTPUTS) *.html $(DESTDIR)/usr/doc/java-common

clean: 
	rm -f *.html *.aux *.log *.dvi *.ps *.tex *.txt

<!--
    html.dsl - stylesheets for HTML output.
    Stolen from SGMLtools
-->

<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA dsssl>
]>
<style-sheet>

<style-specification id="html" use="docbook">
<style-specification-body> 


(define %html-ext% ".html")
(define %root-filename% "policy")
(define %generate-article-toc% #t)
(define %generate-article-titlepage% #t)
; (define %gentext-nav-use-tables%  #f)

;; Add other customization here


</style-specification-body>
</style-specification>

<external-specification id="docbook" document="docbook.dsl">
</style-sheet>