Subject: htdocs/guide reorganization to support printable formats
To: None <netbsd-docs@NetBSD.org>
From: Hiroki Sato <hrs@NetBSD.org>
List: netbsd-docs
Date: 11/30/2003 01:54:24
----Security_Multipart(Sun_Nov_30_01:54:24_2003_746)--
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Hi,
I committed various changes to htdocs/guide just now. They are
mainly for supporting to generate PostScript and PDF version of
the guide natively and cleanups of xml markup. The visible changes
for document writers are the following:
- ${STYLE_TYPE} is used for specifying stylesheet type.
`xsl' and `dsssl' are valid, and `xsl' is used by default.
When you want to get the guide in a printable format,
use STYLE_TYPE=dsssl.
- ${FORMATS} is used for specifying the output format.
`html', `html-split', `ps', `pdf' are valid, and `html-split'
is used by default. You can specify more than one value like
FORMATS="html-split ps".
- The toolchains in your system, especially dsssl-docbook-modular
and tex-jadetex, should be upgraded. I made patches[*] for the
current pkgsrc, which include dsssl-docbook-modular,
tex-jadetex, and docbook-xsl. In addition ghostscript, jade,
and openjade are needed.
For example:
% cd htdocs/guide/en
% make
(`index.html' generated with XSLT stylesheet)
% cd htdocs/guide/en
% make FORMATS=ps STYLE_TYPE=dsssl
(`netbsd.ps' generated with DSSSL stylesheet)
% cd htdocs/guide/en
% make FORMATS="html-split html ps pdf" STYLE_TYPE=dsssl
(`netbsd.html', `index.html', `netbsd.ps', and `netbsd.pdf' generated
with DSSSL stylesheet)
Although the committed patches need more improvement, they are just enough
to generate PS/PDF version of the guide and should not break HTML rendering
currently available. Basically there is no content change, but if I missed
something, please let me know, thanks.
[*] http://people.allbsd.org/~hrs/NetBSD/dsssl-docbook_1_73.diff
http://people.allbsd.org/~hrs/NetBSD/tex-jadetex_3_13.diff
http://people.allbsd.org/~hrs/NetBSD/docbook-xsl_1_62_4.diff
--
| Hiroki SATO
----Security_Multipart(Sun_Nov_30_01:54:24_2003_746)--
Content-Type: application/pgp-signature
Content-Transfer-Encoding: 7bit
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.3 (FreeBSD)
iD8DBQA/yM9BTyzT2CeTzy0RAhvUAJ9HEPCZDaRpBwIi2Z8excwdTlxaFgCgzH+l
TbXd8r0hh6lH/vQ4ogf/6gk=
=pGSK
-----END PGP SIGNATURE-----
----Security_Multipart(Sun_Nov_30_01:54:24_2003_746)----