This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: Modularity and Emacs psgml mode
- To: Massimiliano Mirra <list at chromatic-harp dot com>
- Subject: Re: DOCBOOK: Modularity and Emacs psgml mode
- From: Nik Clayton <nik at freebsd dot org>
- Date: Wed, 29 Aug 2001 01:18:42 +0100
- Cc: docbook at lists dot oasis-open dot org
- List-Id: <docbook.lists.oasis-open.org>
- Organization: FreeBSD Project <URL:http://www.freebsd.org/>
- References: <20010828200425.A391@prism.localnet>
--R8CP7fzfAHpwDIZp
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
On Tue, Aug 28, 2001 at 08:04:25PM +0200, Massimiliano Mirra wrote:
> I am adopting the common layout which uses system entities to split
> the work in more manageable files, like:
>=20
> <!doctype book public "-//OASIS//DTD DocBook V3.1//EN" [
> <!entity chapter1 system "chap1.sgml">
> <!entity chapter2 system "chap2.sgml">
> ]>
>=20
> <book>
> &chapter1
> &chapter2
> </book>
>=20
> This means that I cannot begin chap1.sgml and chap2.sgml with:
>=20
> <!doctype chapter public "-//OASIS//DTD DocBook V3.1//EN" []>
>=20
> Because, of course, the file will be included and it cannot present
> such a line in the middle of the document.
>=20
> However, this also means that I cannot edit chap1.sgml and chap2.sgml
> taking advantage of Emacs psgml mode, because it won't find any
> identifier/catalog.
>=20
> Is there any way to overcome this?
Put something like this at the bottom of chap*.sgml.
<!--=20
Local Variables:
mode: sgml
sgml-declaration: "chapter.decl"
sgml-indent-data: t
sgml-omittag: nil
sgml-always-quote-attributes: t
sgml-parent-document: ("book.sgml" "part" "chapter")
End:
-->
Where "../chapter.decl" contains this line.
<!doctype chapter public "-//OASIS//DTD DocBook V3.1//EN">
If your chapters are direct children of the <book> element, without any
intervening <part> elements, change the last line to
sgml-parent-document: ("book.sgml" "book" "chapter")
replace "book.sgml" with whatever the name of your master document is.
The FreeBSD project uses this technique extensively. Take a look at
http://www.freebsd.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/books/handboo=
k/
for more examples.
N
--=20
FreeBSD: The Power to Serve http://www.freebsd.org/
FreeBSD Documentation Project http://www.freebsd.org/docproj/
--- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 ---
--R8CP7fzfAHpwDIZp
Content-Type: application/pgp-signature
Content-Disposition: inline
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (FreeBSD)
Comment: For info see http://www.gnupg.org
iEYEARECAAYFAjuMNOIACgkQk6gHZCw343WTJgCdHT5Q+sN9mckPmwdmljrd8HX4
YLsAn2juzjBGYOpe4SpbvhMXUi3iv94G
=mGcf
-----END PGP SIGNATURE-----
--R8CP7fzfAHpwDIZp--