Re: [Fwd: Re: DOCBOOK-APPS: jadetex very slow on windows]

[Ian Castle <ian dot castle at coldcomfortfarm dot net>]

Use a "PUBLIC" identifier... then this is defined in the catalog. You
then need a windows catalog and a UNIX/linux catalog for each machine...

.. I use the following setup:

1. Each document has (at least)
     - The SGML/XML file 
     - A corresponding minimal stylesheet driver
     - a Makefile

These are all held in the same directory (under CVS control).

2. The stylesheet is usually empty but just points to a PUBLIC
identifier containing the "company" standard stylesheet.

3. The company standard stylesheet is a fleshed out driver (with
appropriate customisations for title pages, layout etc.

... Here is the prolog from the per document stylesheet...


<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN"
[
<!ENTITY html-ss
  PUBLIC "-//LOOK Systems//DOCUMENT DocBook HTML Stylesheet//EN" CDATA
dsssl>
<!ENTITY print-ss
  PUBLIC "-//LOOK Systems//DOCUMENT DocBook Print Stylesheet//EN" CDATA
dsssl>
]>

Here is the relevant bit from the master catalog entry
(/etc/sgml/catalog)

...
CATALOG /usr/share/sgml/look/catalog
...

And here is /usr/share/sgml/look/catalog:

OVERRIDE YES

-- start LOOK stylesheets --

PUBLIC "-//LOOK Systems//DOCUMENT DocBook Print Stylesheet//EN"
print.dsl
PUBLIC "-//LOOK Systems//DOCUMENT DocBook HTML Stylesheet//EN" html.dsl
PUBLIC "-//LOOK Systems//ENTITIES Standard Terms Library//EN"
library.ent

-- end LOOK stylesheets --

The end result is that each document contains no physical file
references. It is just the catalog file which needs to be customised. As
it avoids any explicit directory references in all but the master
catalog there is very little to change between windows and UNIX.

Hope that helps!


Ian.


On Fri, 2002-04-12 at 21:17, Sharon B Jones wrote:
> Juan,
> 
> Your solution:
> You can use the SYSTEM identifier and share a folder over the network.
> Then put \\machine\drive\path\docbook.dsl
> 
> Everybody will use the same file. It's what I do.
> 
> Won't work properly in our environment - some of us use Windows, and some 
> use Linux (various flavors)....or am I missing something?
> 
> Thanks,
> Sharon
> 
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> Sharon Jones  ssnyder@us.ibm.com
> Voice: 914-945-2188  Fax: 914-945-4490
> Voice Systems
> Natural Language Engines GUI Tools Team Lead
> 
> 
> 
> 
> "Juan R. Migoya" <jmigoya@arrakis.es>
> 04/11/2002 02:41 PM
> 
>  
>         To:     Docbook Apps <docbook-apps@lists.oasis-open.org>
>         cc:     Sharon B Jones/Watson/IBM@IBMUS
>         Subject:        Re: [Fwd: Re: DOCBOOK-APPS: jadetex very slow on windows]
> 
>  
> 
> 
> 
> Sharon B Jones wrote:
> > 
> > Hi Juan,
> > 
> > Using the SYSTEM identifier (with my path) works fine (and always
> > has).  When I use the PUBLIC identifier it gives me an error.
> >  Changing docbook.dsl to docbk everywhere did not solve the
> > problem....same error.
> > 
> > Since this is a project documentation effort, there are about 6 of us
> > doing work on the docbook files.  To make things difficult, everyone
> > in my group has different versions and different directory paths to
> > the docbook stylesheets.  We found it easier to use the PUBLIC
> > identifier for this reason.  I used to have this working, but I just
> > re-installed my system (new hard drive) and can't get this to work
> > anymore.
> > 
> 
> Regards,
> 
> Juan R. Migoya
> SPAIN
> 
> > If you have any other ideas, maybe we should take it off-line and I'll
> > post my resolution if I find one (besides using the SYSTEM
> > identifier).
> > 
> > Thanks,
> > Sharon
> > 
> > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> > Sharon Jones  ssnyder@us.ibm.com
> > Voice: 914-945-2188  Fax: 914-945-4490
> > Voice Systems
> > Natural Language Engines GUI Tools Team Lead
> > 
> >  "Juan R. Migoya"
> >  <jmigoya@ingeteam.es>             To:        Docbook Apps
> >                            <docbook-apps@lists.oasis-open.org>
> >  04/11/2002 12:33 PM               cc:
> >                                    Subject:        [Fwd: Re:
> >                            DOCBOOK-APPS: jadetex very slow on
> >                            windows]
> > 
> > 
> > 
> > Hello Sharon:
> > 
> > Sharon B Jones wrote:
> > 
> > >
> > > Juan,
> > >
> > > The environment variable you are talking about is set as follows:
> > >
> > >
> > 
> GML_CATALOG_FILES=c:\docbook\jade\dsssl\catalog;c:\docbook\db41\docbook.cat
> > >
> > > Openjade is installed in c:\docbook\jade, and the docbook stuff is
> > in
> > > c:\docbook\db41.  Is there another catalog file that I'm missing?
> >  The
> > > openjade command is as follows:
> > > openjade -t tex -i print -d local.dsl
> > c:\docbook\jade\pubtext\xml.dcl
> > > toolkit1.xml
> > >
> > > I get the error:   openjade:local.dsl:15:26:E: no
> > style-specification
> > > or external-specification with ID "DOCBOOK"
> > >
> > > I am typing this in at the command line....once it works I'll get it
> > > working properly in our makefiles.  What am I missing????
> > >
> > > My custom style sheet is: (copied from one of the examples on
> > > sourceforge's documentation)
> > >
> > > <!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style
> > > Sheet//EN" [
> > > <!ENTITY % html "IGNORE">
> > > <![%html;[
> > > <!ENTITY % print "IGNORE">
> > > <!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML
> > > Stylesheet//EN" CDATA dsssl>
> > >
> > 
> > It seems that you should put <!ENTITY docbook PUBLIC "-//Norman
> > Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA dsssl>
> >                                                       ^^^^^^^^^
> > It's not a file (without ".dsl") but the name of an entity you refer
> > to
> > below ( "<external-specification id="docbook" document="docbook.dsl">)
> > Be sure that you put the full path to your "docbook.dsl" file in the
> > later one.
> > 
> > I think this will be enough.
> > 
> > I don't know why, but use in my prolog:
> > 
> >    <!ENTITY dbstyle SYSTEM
> > "\\path_to_server\F\DSSSL-1.74b\print\docbook.dsl" CDATA DSSSL>
> > 
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >                                           ( this is my path to the
> > dsssl docbook file.)
> > 
> > instead of the mentioned line. And outside the  <!-- <DEFANGED_STYLE-specification> I
> > put:
> > 
> >    <external-specification id="docbook" document="dbstyle">
> > 
> > But I don't think you need to do so.
> > 
> > Hope this help.
> > 
> > Juan R. Migoya
> > 
> > >
> > 
> > <snip>
> > 
> > > ;; customize the html stylesheet here
> > > ]]>
> > > <external-specification id="docbook" document="docbook.dsl">
> > >  --> </DEFANGED_STYLE-sheet>
> > >
> > >
> > > Thanks,
> > > Sharon
> > >
> > > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> > > Sharon Jones  ssnyder@us.ibm.com
> > > Voice: 914-945-2188  Fax: 914-945-4490
> > > Voice Systems
> > > Natural Language Engines GUI Tools Team Lead
> > >
> > >
> > >  "Juan R. Migoya"
> >   <jmigoya@ingeteam.es>              To:
> >                              docbook-apps@lists.oasis-open.org
> >   04/11/2002 03:34 AM                cc:        Sharon B
> >                              Jones/Watson/IBM@IBMUS
> >                                      Subject:        Re: DOCBOOK-APPS:
> > 
> >                               jadetex very slow on windows
> > 
> > >
> > >
> > >
> > > Don't forget the catalog wich is into the openjade folder.
> > >
> > > Regards,
> > > Juan R. Migoya
> > > SPAIN
> > >
> 
>