This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

Re: Modularity and Emacs psgml mode



--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--


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]