docbook-apps

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

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

    Posted 02-16-2007 17:35
    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:


    %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