atom feed5 messages in org.oasis-open.lists.docbookRe: DOCBOOK: Modularity and Emacs psg...
FromSent OnAttachments
Massimiliano MirraAug 28, 2001 2:21 pm 
Nik ClaytonAug 28, 2001 5:22 pm 
Jonathan MarksAug 28, 2001 10:11 pm 
Nik ClaytonAug 29, 2001 5:23 am 
benSep 6, 2001 11:13 am 
Subject:Re: DOCBOOK: Modularity and Emacs psgml mode
From:Nik Clayton (ni@freebsd.org)
Date:Aug 28, 2001 5:22:58 pm
List:org.oasis-open.lists.docbook

<PRE> --R8CP7fzfAHpwDIZp Content-Type: text/html; charset=utf8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable

On Tue, Aug 28, 2001 at 08:04:25PM +0200, Massimiliano Mirra wrote: &gt; I am adopting the common layout which uses system entities to split &gt; the work in more manageable files, like: &gt;=20 &gt; &lt;!doctype book public "-//OASIS//DTD DocBook V3.1//EN" [ &gt; &lt;!entity chapter1 system "chap1.sgml"&gt; &gt; &lt;!entity chapter2 system "chap2.sgml"&gt; &gt; ]&gt; &gt;=20 &gt; &lt;book&gt; &gt; &amp;chapter1 &gt; &amp;chapter2 &gt; &lt;/book&gt; &gt;=20 &gt; This means that I cannot begin chap1.sgml and chap2.sgml with: &gt;=20 &gt; &lt;!doctype chapter public "-//OASIS//DTD DocBook V3.1//EN" []&gt; &gt;=20 &gt; Because, of course, the file will be included and it cannot present &gt; such a line in the middle of the document. &gt;=20 &gt; However, this also means that I cannot edit chap1.sgml and chap2.sgml &gt; taking advantage of Emacs psgml mode, because it won't find any &gt; identifier/catalog. &gt;=20 &gt; Is there any way to overcome this?

Put something like this at the bottom of chap*.sgml.

&lt;!--=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: --&gt;

Where "../chapter.decl" contains this line.

&lt;!doctype chapter public "-//OASIS//DTD DocBook V3.1//EN"&gt;

If your chapters are direct children of the &lt;book&gt; element, without any intervening &lt;part&gt; 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-- </PRE>