Inserting a file using <!ENTITY>

Inserting a file using <!ENTITY>

[Stephen Wilhelm]

Hello everyone.  I have a large document where I insert chapters using
<!ENTITY name SYSTEM "filename"> and I would like to do the same for
perl scripts.  I have tried using

    <programlisting>&program;</programlisting>

but DocBook wants to interpret the "&" characters inside the scripts.  I
can fix this by using a CDATA section like so:

    <programlisting>
    <![CDATA[
        # source code goes here
    ]]>
    </programlisting>

But then I can't use the &program; entity to insert my program.

Basically, I want a way to insert a perl script into the text without
modifying the script, keeping track of two versions of it (the script and
the DocBook version) and without running my DocBook source through a
preprocessor (which is what I'm doing now).

I was hoping that there might be an attribute to programlisting that would
tell it to read in a file, but this feature doesn't seem to exist.  Is
there another way to do this?


-- 
Stephen Wilhelm
    See my Gtk-Perl Tutorial:
    http://personal.riverusers.com/~swilhelm/gtkperl-tutorial/

Re: Inserting a file using <!ENTITY>

[Hugo van der Kooij]

On Sun, 29 Jul 2001, Stephen Wilhelm wrote:

> I was hoping that there might be an attribute to programlisting that would
> tell it to read in a file, but this feature doesn't seem to exist.  Is
> there another way to do this?

I have included SGML source files in the following way:

<Screen>
<inlinegraphic format="linespecific"
fileref="VoorbeeldBoek.sgml"></inlinegraphic>
</Screen>

I suggest you experiment likewise.

Hugo.

-- 
All email send to me is bound to the rules described on my homepage.
    hvdkooij@vanderkooij.org		http://hvdkooij.xs4all.nl/
	    Don't meddle in the affairs of sysadmins,
	    for they are subtle and quick to anger.

Re: Inserting a file using <!ENTITY>

[Stephen Wilhelm]

On Mon, 30 Jul 2001, Hugo van der Kooij wrote:

> On Sun, 29 Jul 2001, Stephen Wilhelm wrote:
>
> > I was hoping that there might be an attribute to programlisting that would
> > tell it to read in a file, but this feature doesn't seem to exist.  Is
> > there another way to do this?
>
> I have included SGML source files in the following way:
>
> <Screen>
> <inlinegraphic format="linespecific"
> fileref="VoorbeeldBoek.sgml"></inlinegraphic>
> </Screen>

This works great!  By the way, the closing </inlinegraphic> doesn't seem
necessary, and jade complains if it's there.

Thanks a lot for your help.


-- 
Stephen Wilhelm
    See my Gtk-Perl Tutorial:
    http://personal.riverusers.com/~swilhelm/gtkperl-tutorial/