1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
docbook-dsssl -- DocBook Modular DSSSL Stylesheets for Debian
--------------------------------------------------------------
Usage for tex:
jade -t tex \
-d /usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/print/docbook.dsl \
<sgml-file>
Usage for html:
jade -t sgml \
-d /usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/html/docbook.dsl \
<sgml-file>
Usage for rtf:
jade -t rtf \
-d /usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/print/docbook.dsl \
<sgml-file>
The stylesheets themselves are in the 'docbook-dsssl' package. The
documentation for the stylesheets can be found in the
'docbook-dsssl-doc' package documentation
(/usr/share/doc/docbook-dsssl-doc/index.html). It offers an overview
of how to use the stylesheets as well as information explaining how to
extend or customize them.
The following parameter changes have been made, diverging from the way
the upstream source comes by default:
- The html extension has been changed from ".htm" to ".html".
- The directories for admonition graphics has been fixed based on the
location where materials are installed. For HTML output, we
provide a symlink in /var/www/docbook-dsssl to the images
directory. This means that if you have %admon-graphics% turned on
(it's off by default), and ship HTML output from this program to
another web server, it will be looking in "/docbook-dsssl/"
for files such as note.gif, etc. So, you'll have to copy those
files over, or have docbook-stylesheets installed on the web
server.
- Pretty much the same deal for callout graphics, although that is
only operative in HTML output.
A basic template for a user stylesheet can be found in
/usr/share/doc/docbook-dsssl/examples/basic.dsl . Other interesting
examples can be found there as well.
The SGML catalog used for Debian SGML integration can be found in
/usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/sgml.catalog . A
different SGML catalog is shipped from upstream, and can be found in
/usr/doc/docbook-dsssl/catalog; it is meant to provide defaults,
etc., for docbook SGML processing, but it is not required.
Here are some URLs you might be interested in:
http://nwalsh.com/docbook/
-- where this software came from, and some other stuff
http://www.oasis-open.org/docbook/
-- Home page for the DocBook DTD
http://www.docbook.org/
-- Another home page for the DocBook DTD, by Norm Walsh, who
wrote these stylesheets
http://www.mulberrytech.com/dsssl/
-- list archive for the dsssl-list; DSSSL documentation project
http://www.oasis-open.org/cover/dsssl.html
-- Robin Cover's SGML/XML web pages, DSSSL area
Here are some other packages you might be interested in:
jade -- required; this package interprets and formats SGML with the
stylesheets contained in this package
openjade -- fork of Jade; an alternative to jade package above
sp -- jade infrastructure; nsgmls is good for validating SGML
opensp -- fork of SP; an alternative to sp package above
docbook -- required DTDs; you need version 3.0 or better of the DTDs
docbook-doc -- how to use the DTDs
docbook-xml -- XML version of the DocBook DTD
docbook-xsl-stylesheets -- DocBook XSL stylesheets
task-sgml -- a metapackage containing dependencies which constitute
a complete SGML development environment
--
maintainer: Adam Di Carlo <aph@debian.org>
previous maintainer: Christian Leutloff <leutloff@debian.org>
|
