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
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:
- Align left the title, as we did in the other TDEUI files, with a the same left-spacing for the TDE logo
- 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
Date: Tue, 26 Aug 2014 15:09:58 +0100 From: michele.calgaro@yahoo.it To: trinity-devel@lists.pearsoncomputing.net Subject: [trinity-devel] 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:
- Align left the title, as we did in the other TDEUI files, with a the same left-spacing for the TDE logo
- 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
No problems!
-Alexandre
On Tue, 26 Aug 2014 14:58:32 -0400 Alexandre ac586133@hotmail.com wrote:
Date: Tue, 26 Aug 2014 15:09:58 +0100 From: michele.calgaro@yahoo.it To: trinity-devel@lists.pearsoncomputing.net Subject: [trinity-devel] 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:
- Align left the title, as we did in the other TDEUI files, with a the same left-spacing for the TDE logo
- 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
No problems!
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
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
Date: Wed, 27 Aug 2014 02:30:57 +0100 From: michele.calgaro@yahoo.it To: trinity-devel@lists.pearsoncomputing.net Subject: Re: [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
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
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
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
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.
Thank you! -Alexandre
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
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
Unfortunately, they do need to be re-generated, or you will get what you see: The old file with the new picture.
When are these files generated? At build time or the first time they are open?
-Alexandre
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
Subject: RE: [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.
The reason for this is simple: I forgot to send the 3 bottom files :)
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
We'll have it. One day...
I still need to work on KHelpCenter. Some part of it are really really old. I think that computers were not even invented when these pages has been built... 1. Open KHelpCenter 2. Go in the Glossary tab 3. Choose any definition in the glossary
-Alexandre
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.
We'll have it. One day...
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
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
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
- 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.
- Minimalist TDM style
Pushed in commit 232cce7, 34d83f4
Good job Alex, thanks for the contribution. Cheers Michele
Good!
-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?
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
Date: Wed, 3 Sep 2014 02:15:05 +0100 From: michele.calgaro@yahoo.it To: trinity-devel@lists.pearsoncomputing.net Subject: RE: [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?
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
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
-
Alexandre -
E. Liddell -
Michele Calgaro