[PATCH] Improve rendering of DocBook documentation

Burkhard Lück lueck at hube-lueck.de
Mon Jan 4 08:37:53 GMT 2010


Am Samstag, 2. Januar 2010 01:52:34 schrieb Michael Pyne:
> On Wednesday 23 December 2009 02:31:23 Michael Pyne wrote:
> > Hi all,
> >
> > *snip*
> >
> > I've tested making handbooks and generating straight HTML (you can see
> > the HTML on http://kdesvn-build.kde.org/documentation/) and looked at a
> > few handbooks afterwards to see if I left out anything major.  I don't
> > think I have but if so, it's just CSS, just let me know.
> >
> > So, what are your thoughts?
> 
> OK I've had an ack and no negative comments however we are quite a ways
>  past 1 December 2009 (the documentation/handbook freeze date). This
>  doesn't change any of the content of the documentation so it could be
>  argued to be permissible under the artwork freeze I guess but I'd like to
>  get a second opinion on that. ;)
> 
> While I was waiting I made a second revision, which adds a *touch* of text
> shadow to the page title and also forces the page footer to the bottom of
>  the page on very short documents.
> 
> The aforementioned kdesvn-build docs have been revised to match so you can
>  see how it looks in practice, and the patch is attached.
> 
Hallo Michael,

I have applied your patch and tested it with the english documentation and 
some language documentation.

I like the new design but noticed two problems:

1) You changed footer.teamname from "KDE Docs Team" in 
kdelibs/kdoctools/docbook/xsl/common/en.xml to "software author" in 
kdoctools/customization/kde-chunk.xsl.
I'd like to leave it as "KDE Docs Team" and this entry needs to be defined as 
now in kdoctools/docbook/xsl/common/en.xml to make it translatable.

2) A documentation generated with meinproc4 path/to/index.docbook looks 
different wrt the position of header/footer and navigation elements, see 
attached screenshot.

-- 
Burkhard Lück
-------------- next part --------------
A non-text attachment was scrubbed...
Name: doc-generated-with-meinproc4.png
Type: image/png
Size: 90070 bytes
Desc: not available
URL: <http://mail.kde.org/pipermail/kde-core-devel/attachments/20100104/4faa1961/attachment.png>
-------------- next part --------------
_______________________________________________
kde-doc-english mailing list
kde-doc-english at kde.org
https://mail.kde.org/mailman/listinfo/kde-doc-english


More information about the kde-core-devel mailing list