Re: [docbook-apps] Text Entites and Docbook 5

["Bob Stayton" <bobs@sagehill.net>]

Since you are using XIncludes, you can use a shared entities file in all 
your documents.  Although you can't define the entities in a RelaxNG 
schema, you can still declare them in a DOCTYPE declaration in each XML 
file.  Using a shared entities file makes that easier.  See:

http://www.sagehill.net/docbookxsl/ModularEntities.html

The difference from that example is you omit the DTD references from the 
DOCTYPE and use just:

<!DOCTYPE section [
<!ENTITY % myents SYSTEM "myproject.ent" >
%myents;
]>

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net


----- Original Message ----- 
From: "Johnson, Eric" <Eric.Johnson@iona.com>
To: "Kariem Hussein" <kariem@users.sourceforge.net>
Cc: <docbook-apps@lists.oasis-open.org>
Sent: Friday, February 16, 2007 9:26 AM
Subject: RE: [docbook-apps] Text Entites and Docbook 5


I use xinclude for whole elements, such as a section, but I use entities
for snippets of text. For example, I put the name of the product in a
text entity called prodname and then in my docs when I want to put in
the product name I use &prodname;.
How would this work with xincludes? I thought xincludes could only be
used to import whole elements.
Cheers,
Eric


> -----Original Message-----
> From: kariem.hussein@gmail.com
> [mailto:kariem.hussein@gmail.com] On Behalf Of Kariem Hussein
> Sent: Friday, February 16, 2007 12:20 PM
> To: Johnson, Eric
> Cc: docbook-apps@lists.oasis-open.org
> Subject: Re: [docbook-apps] Text Entites and Docbook 5
>
> Eric,
>
> Have a look at this section in the definitive guide:
>
> http://docbook.org/tdg5/en/html/ch02.html#ch02-physdiv
>
> As far as I can see you can use XML entities. I always
> preferred using xinclude, which is now 'officially' possible
> without extending the docbook DTD.
>
> Greetings,
> Kariem
>
> On 2/16/07, Johnson, Eric <Eric.Johnson@iona.com> wrote:
> >
> >
> > I'm currently using Docbook 4.4 for my documents and I use
> externally
> > resolved text entities quite a lot in my documents to make them
> > portable and share a lot of information like product name
> and versions
> > across all of the files for a particular library. In
> reading over the
> > transition guide it looks as though entities are not as
> easily support
> > using Docbook 5. Is this true and if so, what strategies
> are good for replacing external entities?
> > Cheers,
> > Eric J.
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org