[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: [SUMMARY] Divergance with LSB spec



Adam Di Carlo writes:

> Once I have consensus on this and Mark's new /usr/share/sgml layout, I
> will propose this as an amendment to Erik Biscoff & co.
> 
I'm currently writing up a summary document explaining/proposing the
layout. Should be done in a day or two. 
 
> Norm has pointed out that jade / openjade will be *forced* to use that
> when it uses *any* of the files in that directory.
> 
> Is this a known plus or a bug?  We're going to need to try it out and
> find out.  Seems like a bug to me.
>

I don't think this causes any problems -- I have files named "catalog"
in the directories with the DTDs and jade doesn't seem to mind at all.

However, it sounds like psgml chokes on the CATALOG directive in the
super-catalog:

 http://www.geocrawler.com/lists/3/SourceForge/7085/0/5229979/

As far as the new layout goes, a short summary is given below.  For
ease of packaging, I tried to make it so that upstream packages can be
dropped as-is into a directory. 

Feedback is encouraged. I'm sure there are typos.


---------------------------------------
The /usr/share/sgml tree would look like:

/usr/share/sgml/
                 declaration/
                 dtd/
                 entities/
                 stylesheet/
                 misc/
                 ...
                 html/
                 jade/
                 tei/ 
                 docbook/

The dtd/ and stylesheet/ dirs are for stuff that doesn't warrant it's own
subtree.

-----------------------------------------
THe docbook subdirectory looks like:

/usr/share/sgml/docbook/
                        dtd/
                           sgml/
                           xml/

                        stylesheet/
                                   dsssl/  
                                   xsl/

------------------------------------------

DTDs derived from, or dependent on, a DTD should be in subdirectories
of the DTD. Selected sections of the docbook-xml tree would look like:

/usr/share/sgml/docbook/dtd/xml/
                                docbookx.CAT (for docbook-xml 3X & 4X)
                                (symlinks??)
                                3.1.7/
                                      ent/
                                      *.dtd 
                                      *.mod
                                      simple/

                                4.1.2/
                                      ent/
                                      *.dtd 
                                      *.mod
                                      simple/ 
                                      website/ 

And for the Simplified DTD:
 
/usr/share/sgml/docbook/dtd/xml/4.1.2/simple/
                                             sdocbookx.CAT 
                                             4.1.2.1/
                                             4.1.2.4/
                                                     ent/
                                                     *.dtd
                                                     *.mod

Note that the catalogs for a given package (*.CAT) are NOT in the
directories with the DTDs. They sit one level up--alongside the
versioned directories. The naming convention should be consistent.
This catalog structure is only a suggestion...

------------------------------------------------------------
Stylesheets are similar, but no versioned directories:

/usr/share/sgml/docbook/stylesheet/
                                   dsssl/
                                   xsl/
                                       gnome/
                                       nwalsh/
                                              bin/
                                              common/
                                               ...
                                              xhtml/
                                              VERSION
                                              *.css+
                                              website/
And for the Website Stylesheets:

/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/website/
                                                      VERSION
                                                      *.xsl
                                                      *.xml
                                                      *.css+

 (+ The css stylesheets are specific to given a set of stylesheets,
 and should therefore be part of tree for those stylesheets. They could
 also be placed in a new dir named "css")
-------------------------------------------------------------

I haven't yet thought about the super/central/localized catalogs. That
structure might need to be modified as well. Entities need to be
addressed, as well.


Mark

> 
> -- 
> .....Adam Di Carlo....adam@onShore.com.....<URL:http://www.onShore.com/>
> 
> 
> --  
> To UNSUBSCRIBE, email to debian-sgml-request@lists.debian.org
> with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org



Reply to: