Re: [gentoo-dev] Gentoo Linux documentation

[AGottinger@t-online.de (Achim Gottinger)]

drobbins@gentoo.org wrote:
> 
> On Sat, Mar 17, 2001 at 07:03:51PM +0100, Achim Gottinger wrote:
> 
> > Another thing. I want to make two new categories:
> 
> > - app-spell: (for i/a/pspell, their backendsand the dictionaries.
> > - app-ml: for all the xml/sgml/html whatever ml stuff.
> 
> > Or should ml be a new major categorie with ml-apps and ml-libs subcategories?
> > Then we can put stuff like libwww, libxslt, libxml in ml-libs. And things
> > like jade, sablotron, and all the sgml-tools to ml-apps.
> 
> Since "ml" reminds me of "machine language", how about these categories:
> 
> markup-apps
> markup-libs
> 
> ???
> 
> Maybe ml is better.
Hmm I'm still thinking about a category name that merges markup
languages with tes related stuff.

Yesterday I reworked the sgml related part of docbook. This produces now
quite better output results 
than the xsl way.
The following output's now work fine: html, dvi, pdf, ps, tex
I had to hack the plain-text backend so text should worke fine once I
commited my changes.
I have still problems producing man and texi output (They both depend on
the perl package SGMLSpm, maybe this is buggy).

Here is a list of packages required to handle sgml docbook stuff:

sgml-common:			Includes basic entitie definitions and a script to manage
catalogs.
docbook-sgml-dtd:		Includes docbook SGML DTD's 
docbook-dsssl-stylesheets:	Includes the conversion stylesheets 

openjade:	Does the conversion job
jadetex:	Is required to produce the dvi pdf ps output.


docbook-sgml-utils:		Includes conversion stylesheets and scripts for
conversion (docbook2html, ...)

Here is a list of packages required to handle sgml docbook stuff:

docbook-xml-dtd:	 The XML DTD's
docbook-xml-simple-dtd:	 The XML DTD's for simplified docbook (100
instead of 300 entities)
docbook-xsl-stylesheets: XSLT Stylesheets for html and fo output
(Coming soon: docbook-xml-2X:	Stylesheets and scripts to convert
xml-docbook to man and texi)
xmltex:		An xml parser for tex.
passivetex:	Macros required to convert fo to pdf and tex.

libxslt:	Includes the xslt parser.

The sgml-packages now add and remove their catalogs from a centralized
catalog.
This is a LSB conform handling of catalogs.

All cataolges get stored in /etc/sgml

There is one global catalog that keeps all the other centralized
catalogs. called "catlog".

The three packages sgml-common, docbook-dsssl-stylesheets and openjade
create the catalogs

sgml-ent, dsssl-docbook-stylesheets and openjade-1.3.

They add their centralized catalog to a catalog named
/etc/sgml/sgml-docbook.cat.

The docbook-sgml-dtd packages creates an centralized catalog called
/etc/sgml/sgml-docbook-{3,4}.[0,1}.cat
and add the global sgml-docbook.cat to that version specific catalog.

The docbook utils scan the sgml input for the doctype and use the
matching sgml-docbook catalog automatic.
These utils also detect if the input is and xml file. In this case it
wants to use /etc/sgml/xml-docbook-{PV}.cat. Not working, because the
XML way of handling docbook files does not use catalog
files.

All the sgml dtd's, stylesheets and internal scripts go to
/usr/share/sgml/.
All the names I used for the subdirs are LSB convorm.

I renamed a few packages to be more LSB convorm and to work with the
dependencies system.

Bye Achim



> --
> Daniel Robbins                                  <drobbins@gentoo.org>
> President/CEO                                   http://www.gentoo.org
> Gentoo Technologies, Inc.
> 
> _______________________________________________
> gentoo-dev mailing list
> gentoo-dev@gentoo.org
> http://www.gentoo.org/mailman/listinfo/gentoo-dev