--ZPt4rx8FFjLCG7dd
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

 [ netbsd-docs included ]

Cyrille Szymanski wrote:

  [ xsltproc seems to access the Internet to get the DTD files for
    XML files. How can I configure a proxy if the build machine for
    htdocs is located behind a firewall? ]

> How must I proceed ?
>=20
> [xsltproc] layout.xml -> autolayout.xml
> I/O error : Attempt to load network entity=20
> http://docbook.sourceforge.net/release/website/current/schema/dtd/layout.=
dtd
> /home/cns/NetBSD/htdocs/layout.xml:4: warning: failed to load external=20
> entity=20
> "http://docbook.sourceforge.net/release/website/current/schema/dtd/layout=
.dtd"
> "http://docbook.sourceforge.net/release/website/current/schema/dtd/layout=
.dtd"

The stylesheet processor did access the DTDs from the Internet only for
a short time until a change was committed to CVS by Hiroki Sato which
prohibits this ("--nonet", see below).

You should use meta-pkg/netbsd-www from the stable branch pkgsrc-2005Q1
for work on htdocs. I have the best experiences with all packages built
from that branch. Packages from the pkgsrc CVS trunk _should_ work as
well but may give slightly different HTML output than what we use.

This meta package includes docbook-website-2.5.0 (from pkgsrc-2005Q1)
which should install

  /usr/pkg/share/xml//website/catalog.xml

for you. In this catalog file, the lines

  <public
    publicId=3D"-//Norman Walsh//DTD Website Layout V2.2.0//EN"
    uri=3D"layout.dtd"/>

order the stylesheet processor to load
  /usr/pkg/share/xml//website/schema/dtd/layout.dtd

as a DTD for the layout file (see the public identifier in layout.xml).

If that does not happen for you, xsltproc by default would try to load
the DTD from the Internet but this is forbidden by the parameter
"--nonet" (added to the command line in htdocs/share/mk/web.site.mk) and
thus xsltproc complains loudly but actually does _not_ try to load the
file from the Internet. My dial-on-demand line stays down if I make the
local copy in /usr/pkg/share/xml//website/schema/dtd/ unavailable.

To summarize: keep htdocs up-to-date (for changes in htdocs/share) and use
the packages from pkgsrc-2005Q1 if possible. If there are still questions,
just ask.
It's ok to write the www team, but I tought people on netbsd-docs were
interested in and able to help about such problems, so I sent it there
as well.

ciao
     Klaus

--ZPt4rx8FFjLCG7dd
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.0 (NetBSD)

iD8DBQFCgoOymz0WCq2sQGQRAuCFAJ9HcXtn3KJKoLJ2USlWVaFqkextOgCfWDJl
Wx7tkEh1+LIk7Xh+yOO/9RA=
=4Uz2
-----END PGP SIGNATURE-----

--ZPt4rx8FFjLCG7dd--