24 Aug
2014
24 Aug
'14
11:02 p.m.
Hi,
I am now looking forward updating the ''TDEUI'' files of the TDE Help
Center.
But, it seems to be completely different than the layout of other apps using TDEUI, and I
will need help on this one, if it is possible.
First of all, I'd like to know how help files are built.
As I understand it, many stylesheets are applied to it until something like an HTML page
is built, to be displayed.
As we have seen with E. Liddell, it will probably be very hard to have the Help Center to
use a user-replaceable background file, so I am okay with building non-transparent picture
set, with the background being part of the same picture as the ribbon.
But, there is still the need to find how to:
1. Align left the title, as we did in the other TDEUI files, with a the same left-spacing
for the TDE logo
2. Change the color of the title
Thank you!
-Alexandre
26 Aug
26 Aug
2:09 p.m.
New subject: R: [trinity-devel] TDEUI update adaptation for Help Center
I am now looking forward updating the
''TDEUI'' files of the TDE Help Center.
But, it seems to be completely different than the layout of other apps using TDEUI, and I
will need help on this one, if it >is possible.
...
But, there is still the need to find how to:
1. Align left the title, as we did in the other TDEUI files, with a the same left-spacing
for the TDE logo
2. Change the color of the title
Hi Alex,
I will try to find some time this week/weekend to investigate the whole thing and provide
some feedback to your questions. I am quite busy this period, so bear with me if I will be
a little late to reply.
Cheers
Michele
6:58 p.m.
New subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
Date: Tue, 26 Aug 2014 15:09:58 +0100
From: michele.calgaro(a)yahoo.it
To: trinity-devel(a)lists.pearsoncomputing.net
Subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
No problems!
-Alexandre
I am now looking forward updating the
''TDEUI'' files of the TDE Help Center.
But, it seems to be completely different than the layout of other apps using TDEUI, and I
will need help on this one, if it >is possible.
...
But, there is still the need to find how to:
1. Align left the title, as we did in the other TDEUI files, with a the same left-spacing
for the TDE logo
2. Change the color of the title
Hi Alex,
I will try to find some time this week/weekend to investigate the whole thing and provide
some feedback to your questions. I am quite busy this period, so bear with me if I will be
a little late to reply.
Cheers
Michele 
11:21 p.m.
New subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
On Tue, 26 Aug 2014 14:58:32 -0400
Alexandre <ac586133(a)hotmail.com> wrote:
Sorry for not responding to this before--I've been having hellish migraines.
The Help Center uses the same style files as everything else (konq.css,
kde-default.css), but the title alignment and colour are being embedded
during the docbook creation process.
The fragment currently governing the style is this:
<div style="position: absolute;top: 25px;right: 100px;text-align: right;font-size:
xx-large;font-weight: bold;text-shadow: #fff 0px 0px 5px;color: #444">
It seems to be coming from [tde]/share/apps/ksgmltools2/customization/kde-navig.xsl
starting at line 49 (and you would not believe the amount of grepping I had to do to
find that). So "right: 100px" becomes "left: [some distance]" and
"color: #444"
becomes "color: [whatever]".
kde-navig.xsl seems to be the source of most, if not all, of the hard-coded styles
being injected into these documents. I'd like to perform an exorcism on it and
move them all to a stylesheet, but I'm going to have to look up the commands
to regenerate the documentation first. (I did know this stuff at one point . . .)
E. Liddell
Date: Tue, 26 Aug 2014 15:09:58 +0100
From: michele.calgaro(a)yahoo.it
To: trinity-devel(a)lists.pearsoncomputing.net
Subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
No problems! I am now looking forward updating the
''TDEUI'' files of the TDE Help Center.
But, it seems to be completely different than the layout of other apps using TDEUI, and I
will need help on this one, if it >is possible.
...
But, there is still the need to find how to:
1. Align left the title, as we did in the other TDEUI files, with a the same left-spacing
for the TDE logo
2. Change the color of the title
Hi Alex,
I will try to find some time this week/weekend to investigate the whole thing and provide
some feedback to your questions. I am quite busy this period, so bear with me if I will be
a little late to reply.
Cheers
Michele
27 Aug
27 Aug
1:30 a.m.
New subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
kde-navig.xsl seems to be the source of most, if not
all, of the hard-coded styles
being injected into these documents. I'd like to perform an exorcism on it and
move them all to a stylesheet, but I'm going to have to look up the commands
to regenerate the documentation first. (I did know this stuff at one point . . .)
E.,
thanks a lot for yuor feedback, this will save us a lot of time.
The command to create the documentation is 'meinproc'. I do not remember the exact
syntax by memory (not on a TDE machine right now) but if you grep for meinproc in tdebase
you should easily find the right syntax. Later on when I am on TDE I can look it up and
update.
Cheers
Michele
29 Aug
29 Aug
11:04 p.m.
New subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
Date: Wed, 27 Aug 2014 02:30:57 +0100
From: michele.calgaro(a)yahoo.it
To: trinity-devel(a)lists.pearsoncomputing.net
Subject: Re: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
Thank you very much for the info!
The only thing I'd need too is how to rebuild the documentation. Or if I delete it,
will it be rebuilt automatically? Still, I'll have to know where are the generated
help files.
-Alexandre
kde-navig.xsl seems to be the source of most, if
not all, of the hard-coded styles
being injected into these documents. I'd like to perform an exorcism on it and
move them all to a stylesheet, but I'm going to have to look up the commands
to regenerate the documentation first. (I did know this stuff at one point . . .)
E.,
thanks a lot for yuor feedback, this will save us a lot of time.
The command to create the documentation is 'meinproc'. I do not remember the
exact syntax by memory (not on a TDE machine right now) but if you grep for meinproc in
tdebase you should easily find the right syntax. Later on when I am on TDE I can look it
up and update.
Cheers
Michele
31 Aug
31 Aug
1:16 p.m.
New subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
The only thing I'd need too is how to rebuild the
documentation. Or if I delete it, will it be rebuilt automatically?
Still, I'll have to know where are the generated help files.
To generate the help files on your own, create a folder and from there use the following
command:
meinproc /path/to/index.docbook
For example for the Kate handbook:
meinproc /path/to/tdebase/doc/kate/index.docbook
This will create a set of html files in the folder. The same files are the one used in the
actual handbook, even though in most cases they are stored in a bz2 archive.
Cheers
Michele
1 Sep
1 Sep
12:44 p.m.
New subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
The only thing
I'd need too is how to rebuild the documentation. Or if I delete it, will it be
rebuilt automatically?
Still, I'll have to know where are the generated help files.
To generate the help files on your own, create a folder and from there use the following
command:
meinproc /path/to/index.docbook
For example for the Kate handbook:
meinproc /path/to/tdebase/doc/kate/index.docbook
This will create a set of html files in the folder. The same files are the one used in
the actual handbook, even though in most cases they are stored in a bz2 archive.
Cheers
Michele
1:13 p.m.
New subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
Okay, it helps a lot!
I provided in the archive all the files needed for the adaptation. It does not not
feature true transparency, but it will fit with the default TDEUI
background.
Hi Alex, the screenshots look reeeeally good, especially the bottom part.
Are you sure the files you sent are the only ones required? I did a quick test, by
replacing the original files in /opt/trinity/.... with the one you sent, but the result is
not the same. The writing are still in black and right aligned and the bottom part is
still the same as before. Note: I did not regenerate the html files, only copied and
opened KHelpCenter (but I don't think this was the problem).
Cheers
Michele
1:38 p.m.
New subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
Okay, it helps
a lot!
I provided in the archive all the files needed for the adaptation. It does not not
feature true transparency, but it will fit with the default TDEUI
background.
Hi Alex, the screenshots look reeeeally good, especially the bottom part.
Are you sure the files you sent are the only ones required? I did a quick test, by
replacing the original files in /opt/trinity/.... with the one you sent, but the result is
not the same. The writing are still in black and right aligned and the bottom part is
still the same as before. Note: I did not regenerate the html files, only copied and
opened KHelpCenter (but I don't think this was the problem).
Cheers
Michele
2:08 p.m.
New subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
Unfortunately, they do need to be re-generated, or you
will get what you see: The old file with the new picture.
Ok, I regenerated
Kate's help files and the title now looks ok (white color, on the leftish side).
But the bottom part still shows the old blueish KDE color and the horizontal ribbon as
well. I can post a screenshot if required.
When are these files generated? At build time or the
first time they are open?
They are generated at build time, often stored as a zip
archive.
Cheers
Michele
2:35 p.m.
New subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
Subject: RE: [trinity-devel] R: [trinity-devel] TDEUI
update adaptation for Help Center
The reason for this is simple: I forgot to send the 3 bottom files :)
Unfortunately, they do need to be re-generated,
or you will get what you see: The old file with the new picture.
Ok, I regenerated
Kate's help files and the title now looks ok (white color, on the leftish side).
But the bottom part still shows the old blueish KDE color and the horizontal ribbon as
well. I can post a screenshot if required.
When are these
files generated? At build time or the first time they are open?
They are generated
at build time, often stored as a zip archive.
Cheers
Michele
2 Sep
2 Sep
10:27 a.m.
New subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
When are these files generated? At build time or the
first time they are open?
They are generated at build time, often stored as a zip
archive.
9 Sep
9 Sep
12:20 a.m.
New subject: [trinity-devel] R: [trinity-devel] TDEUI update adaptation for Help Center
I am testing the changes locally to make sure
everything is ok. If I can I will push later today, otherwise tomorrow.
Same for the minimalist TDM theme.
Cheers
Michele
Hi,
I decided to forget about the glossary pages part of the help center. It is too much of a
mess, and I prefer to not make an even bigger mess with it.
It is hard to integrate, parts are coming from many files thamt I am not too sure if they
are really used or not and they are too outdated.
I'll probably have some time to update my R14 system this week, so I will confirm if
the modification for KHelpCenter works as it should or not.
Thank you!
-Alexandre
2 Sep
2 Sep
3:36 p.m.
New subject: TDEUI update adaptation for Help Center / TDM minimalist style
1) TDEUI update adaptation for Help Center
Pushed in commit 8814b54. Still a couple of things to look at:
a) the title of the main help page categories is still in black color and right aligned. I
have already rebuilt tdelibs and tdebase, so I expected it to be in the new style.
b) the style of pages in the glossary, as Alex already pointed out.
2) Minimalist TDM style
Pushed in commit 232cce7, 34d83f4
Good job Alex, thanks for the contribution.
Cheers
Michele
7:13 p.m.
New subject: [trinity-devel] TDEUI update adaptation for Help Center / TDM minimalist style
1) TDEUI update adaptation for Help Center
Pushed in commit 8814b54. Still a couple of things to look at:
a) the title of the main help page categories is still in black color and right aligned.
I have already rebuilt tdelibs and tdebase, so I expected it to be in the new style.
Do you mean the first page shown when KHelpCenter is open?
b) the style of pages in the glossary, as Alex already
pointed out.
2) Minimalist TDM style
Pushed in commit 232cce7, 34d83f4
Good job Alex, thanks for the contribution.
Cheers
Michele
Good!
-Alexandre
3 Sep
3 Sep
1:15 a.m.
New subject: [trinity-devel] TDEUI update adaptation for Help Center / TDM minimalist style
a) the title
of the main help page categories is still in black color and right aligned. I have already
rebuilt tdelibs and
tdebase, so I expected it to be in the new style.
Do you mean the first page shown
when KHelpCenter is open?
4 Sep
4 Sep
1:21 a.m.
New subject: [trinity-devel] TDEUI update adaptation for Help Center / TDM minimalist style
Date: Wed, 3 Sep 2014 02:15:05 +0100
From: michele.calgaro(a)yahoo.it
To: trinity-devel(a)lists.pearsoncomputing.net
Subject: RE: [trinity-devel] TDEUI update adaptation for Help Center / TDM minimalist
style
Yes, and also some other first level pages in the left
panel. Some of the pages are legitimate because I haven't done a full TDE rebuild yet,
but I thought the first page shown would be ok since I rebuilt tdelibs and tdebase. There
must be something else, not major though.
Cheers
Michele
Hi,
I did lots of searches in the /opt/trinity/* folders, by using Kate's ''search
in files'' function for the ''text-shadow'' string in *.css,
*.xsl, *.xml, *.html files, and I found nothing interesting. The
''text-shadow'' string is used for the header text, so it is a good
reference point.
Can you push the modification to GIT when you will have some time? After the new TDE
packages with be rebuilt, we'll see if everything is as it should. The worst thing
that could happen is that the header text would still be in black color and right
aligned.
-Alexandre
a) the
title of the main help page categories is still in black color and right aligned. I have
already rebuilt tdelibs and
tdebase, so I expected it to be in the new style.
Do you mean the first page shown
when KHelpCenter is open?
6:27 a.m.
New subject: [trinity-devel] TDEUI update adaptation for Help Center / TDM minimalist style
Can you push the modification to GIT when you will have
some time? After the new TDE packages with be rebuilt, we'll >see if everything is
as it should. The worst thing that could happen is that the header text would still be in
black color and >right aligned.
Actually I already pushed to GIT a couple of days
ago and informed everybody :-)
When you get the new packages, have a look. Then if you need some help let us know.
Cheers
Michele
3514
days inactive
3530
days old
18 comments
3 participants
participants (3)
-
Alexandre -
E. Liddell -
Michele Calgaro