[kde-guidelines] Re: www/areas/guidelines/customization

[Lauri Watts]

On Tuesday 07 December 2004 21:58, Frans Englich wrote:
> On Monday 06 December 2004 17:19, Lauri Watts wrote:
> > CVS commit by lauri:
> >
> > Support infrastructure for the new guidelines docs
> > Most of this is straight copy from kdelibs (after being put on a slight
> > diet) + db2latex
>
> Questions:
>
> * Couldn't the Docbook DTD/XSL in www/docbook/ be used? (and be
> complemented with what's missing, such as db2latex?)

Assuming this all stays hosted on the same machine, certainly that would work 
fine.  In case they are not however, it's in my experience much simpler to 
deal with a little duplication (especially to files such as these, which 
should be rarely touched, and aren't all that big), to make it much more 
streamlined and self-contained, so in order to move the entire thing only a 
single directory needs to be checked out in one go.  

> * I don't understand why the Docbook backend is dieted; to me it introduces
> the same problems as if one pulled out the and classes from kdelibs a
> particular program didn't need -- all the troubles that comes of running
> customized software instead of plain vanilla. Some of the XSLs weren't
> used, and others only ment a stylesheet compilation more or two -- no big
> deal.

Committing another 50 odd directories solely to support languages the 
guidelines are not translated to yet, seemed silly to me - it was a huge 
commit already.  They can be easily added on an as needed basis (the catalog 
still contains them, and that is fine too, until a translation is available 
for them.)  It's more like not packaging kde-i18n with kdebase in this case.

I further removed backwards compatibility with older DocBook DTD's - in this 
controlled environment, there is no need to retain it (unlike the situation 
with kdelibs, so don't even ask, it will not be removed there until KDE 4.0)

Then I left out a handful of textfiles from the xsl distribution.  I'm fairly 
sure CVS will survive the excision of the XSL README just this once.

> * Regarding www/areas/guidelines/src/templates/* and the id names of the
> docbook sources, is it temporary/simply followed along, or how is it in
> relation to the guidelines Ellen outlined(with
> /usability/hig/src/GUIDELINES as background)?

It's temporarily, Ellen is entirely free to name id's as she likes, we already 
discussed that on kde-guidelines.

> * Do you mind if I add XML declarations to docbook files, since that's now
> possible when we're using XInclusions?

Please don't.  We are not going to be using XIncludes.

Regards,
-- 
Lauri Watts
KDE Documentation: http://docs.kde.org
KDE on FreeBSD: http://freebsd.kde.org
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://mail.kde.org/pipermail/kde-guidelines/attachments/20041207/207dfb3e/attachment.pgp