[kde-doc-english]hitting the limits of kioslave documentation II

[Leo Savernik]

Am Freitag, 14. Februar 2003 12:26 schrieb Frederik Fouvry:
[...]
>
> May be due to the incomplete implementation of the style sheets.
> Dunno.  The article should have other info anyway (that may well
> be the cause of the empty page: the style sheets expect that, and
> generate an empty page if you don't give anything).  It's only
> enforced in KDE through book because that's the standard document
> element.
>
> If my previous assumptions are true, you get a bad result because
> <article> is used as a hack.  ;-) The solutions seems to be to
> make a book out of it, with a <reference> (or <chapter>) element,
> followed by a <bibliography>.  In the refentry, you can refer to
> the bibliography.  Or still: mark up the bibliography with other
> means (a list).  It's not as nice, but if there's no other way to
> do it (and the solution proposed above does not satisfy), then
> you can get dispensation from me on this issue.

<book> is far too big for this purpose. It'd contain chapters that had no more 
than two paragraphs. <article> would just do, didn't it insist on the page 
breaks.
>
[...]
> Page breaks are a matter of style sheets, not of markup.
> The Duck Book says about refentries:
>
> Formatted as a displayed block. It is not uncommon for RefEntrys
> to introduce a forced page break in print media.

Heh, and I hoped online html wouldn't count as print media :-(
[...]

mfg
	Leo