Re: [docbook-apps] How do you manage your catalogs ?

[Peter Desjardins <peter.desjardins.us@gmail.com>]

In my environment, most people don't have to set up the publishing
tools so hand editing the catalog is not a problem. I keep all the
publishing tools (the catalog, DTDs, Saxon, XSL) in a directory that
people can grab and put anywhere on a computer. Then the person
setting up to publish needs to go into the catalog and set the
xml:base attribute with the path to that directory.

So when you place my publishing tools directory on a computer, the
first lines of the catalog file look like this:

<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
  <group prefer="public"
  xml:base="file:///c:/path/to/publishing-tools/">
    <!-- Resolve DTD URL system ID to local file -->
    <rewriteSystem
systemIdStartString="http://www.oasis-open.org/docbook/xml/4.5/";
    rewritePrefix="docbook-xml-4.5/" />

And you edit the base file path. The rest of the catalog assumes that
you haven't reorganized the files in the publishing tools directory.
This seems to work well on Windows and Linux servers.

Hope that helps a little.

Peter



On Mon, Dec 3, 2012 at 11:44 AM, Kerry, Richard <richard.kerry@atos.net> wrote:
>
>
> How do people manage their XML catalogs, when developing DocBook ?
>
> In particular when you're not working alone so need to share a catalog's
> contents but with individualized base paths.  And even if 'not alone' just
> means there's a build server which needs a catalog of its own.
>
>
>
> Of course using a catalog gets away from individuals needing to customize
> their copies of XML files.
>
> But then you need to put your own location(s) in the catalog, which is
> otherwise the same as the ones your colleagues, and the build server, need.
>
>
>
> So do you :
>
> - insist  all the files are in the same location on all computers ?
>
> - have an installation process which takes a common catalog with a place
> marker and inserts the individual's path at the appropriate place (xml:base
> attribute) ?   (eg a simple xsl task)
>
> - use some feature of catalogs which I haven't noticed to make an external
> reference to an absolute path ?
>
> - expect all the users to hand-edit the catalog to put in their own
> locations ?
>
> - something else entirely ?
>
>
>
>
>
>
>
>
>
> Uncertainly,
>
> richard.
>
>
>
> BTW.  My particular interest is in how to do this this under Windows.
> (Li|U)n(i|u)x may have different answers.  Or may not.
>
>
>
>
>
>
>
> Richard Kerry
>
> BNCS Engineer
>
> T: +44 (0)20 82259063
>
> M: +44 (0)7812 325518
>
> Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
>
> richard.kerry@atos.net
>
> uk.atos.net
>
> This e-mail and the documents attached are confidential and intended solely
> for the addressee; it may also be privileged. If you receive this e-mail in
> error, please notify the sender immediately and destroy it. As its integrity
> cannot be secured on the Internet, the Atos group liability cannot be
> triggered for the message content. Although the sender endeavours to
> maintain a computer virus-free network, the sender does not warrant that
> this transmission is virus-free and will not be liable for any damages
> resulting from any virus transmitted.
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org