On Sat, 16 Aug 2014 22:52:21 -0400
Alexandre <ac586133@...> wrote:

> 
> > >> No other comments?
> > >> So, it's probably ready to be pushed to GIT.
> > >No objections from me.
> > 
> > Ok, I will push either today or during this week.
> > 
> > By the way Alex, I noticed yesterday that we need the same kind of work for the KHelpCenter.
> > The files should be in /opt/trinity/share/apps/khelpcenter or something like that.
> > Could you take a look if you have time?
> > 
> > Cheers
> >   Michele
> > 
> 
> Hi,
> 
> Yes, I am aware of KHelpCenter. It contains stuff that is coming from probably two or three thousands years ago. :)
> 
> This one is different, and I don't fully understand how to do it. 
> I am looking for the ''skeleton'' file, from where, as I understand, help files are built with. A little like the kde_infopage.css, but for the help. 
> It is built in a different way and I fear that it would not work with transparent png files and a user-defined background. 
> At worst, maybe this could have a fixed background.
> 
> I have seen png files in
> /opt/trinity/share/doc/tde/HTML/en/khelpcenter/common/, but I'm not sure yet what to do with it.
> 
> Doing the picture is the easy part of it, but how to adapt the structure to use it is different.

I managed to retrieve the HTML for one of the pages.  It's ugly.  The governing stylesheet
should be [tde]/share/doc/HTML/en/common/kde-common.css, but as far as I can tell
that's empty (file contains comments only), and the style declarations that are actually
used are embedded.  They're being added from various .xsl files applied when the
documentation is generated.

The good news is that I was able to pull out the names of the image files in use.
All are in [tde]/share/doc/HTML/en/common/ (khelpcenter/common/ is just a symlink
to that directory, on my system at least).

header: top-middle.png, top-right-konqueror.png
footer: bottom-middle.png, bottom-right.png, bottom-left.png

A lot of the other images seem to be from a previous version of the chrome, and I don't
think they're in use right now (there may be one or two exceptions).

Changing the opaque backgrounds of some elements may be a bit more
difficult.  Some definitions seem to be in
[tde]/share/apps/ksgmltools2/docbook/xsl/html/docbook.xsl , but there may
be others scattered around.

The best long-term solution may be to conduct a search-and-destroy on the style
definitions embedded in the XSL and move everything to kde-common.css,
assuming kde-common.css isn't auto-generated and we can confirm that all the pages 
import that stylesheet.

E. Liddell