Comments on: docs.kde.org 0.2 http://physos.org/2005/07/05/docskdeorg-02/ by Rainer "physos" Endres Mon, 23 Jul 2007 02:24:52 +0000 hourly 1 http://wordpress.org/?v=3.0 By: physos http://physos.org/2005/07/05/docskdeorg-02/comment-page-1/#comment-58 physos Sat, 09 Jul 2005 13:43:16 +0000 http://physos.org/?p=55#comment-58 <p>jmfayard: Ok, fixed. Now the selected language is respected. The branch is still development. This has currently technical reasons. I will look into make this more flexible next week.</p> jmfayard: Ok, fixed. Now the selected language is respected. The branch is still development. This has currently technical reasons. I will look into make this more flexible next week.

]]> By: physos http://physos.org/2005/07/05/docskdeorg-02/comment-page-1/#comment-53 physos Thu, 07 Jul 2005 12:41:13 +0000 http://physos.org/?p=55#comment-53 <p>Till: </p> <p>heh, nice idea!</p> <p>My JavaScript is not up to that job, yet. If you want to try it, I can give you a reduced test page and a list of applications from the PHP array of generated docs. </p> <p>Perheaps you can make more use of the Javascript version of that array, though?</p> Till:

heh, nice idea!

My JavaScript is not up to that job, yet. If you want to try it, I can give you a reduced test page and a list of applications from the PHP array of generated docs.

Perheaps you can make more use of the Javascript version of that array, though?

]]> By: physos http://physos.org/2005/07/05/docskdeorg-02/comment-page-1/#comment-52 physos Thu, 07 Jul 2005 05:39:52 +0000 http://physos.org/?p=55#comment-52 <p>jmfayard: I overlooked this :( It should not be hard to fix. Will do this this afternoon. Thanks for noticing.</p> <p>lukas: Because they are very unreliable. At least thats what I got from forums around the Net. User get annoyed when the page defaults back to a language they do not want. When I have cookies handling the defaults, this may be an option. Untill then, I have to default to the most complete documentation. I have this problem on my ToDo though.</p> jmfayard: I overlooked this :( It should not be hard to fix. Will do this this afternoon. Thanks for noticing.

lukas: Because they are very unreliable. At least thats what I got from forums around the Net. User get annoyed when the page defaults back to a language they do not want. When I have cookies handling the defaults, this may be an option. Untill then, I have to default to the most complete documentation. I have this problem on my ToDo though.

]]> By: Till http://physos.org/2005/07/05/docskdeorg-02/comment-page-1/#comment-51 Till Wed, 06 Jul 2005 13:31:10 +0000 http://physos.org/?p=55#comment-51 <p>physos: You're right of course. You don't need asynchronous information loading. But a nice suggestion-menu popping up while typing would be nice... :-) Maybe I will have time sometime to implement this, but right now, I'm stuck writing my diploma thesis, so this will not happen during the next weeks.</p> physos: You’re right of course. You don’t need asynchronous information loading. But a nice suggestion-menu popping up while typing would be nice… :-) Maybe I will have time sometime to implement this, but right now, I’m stuck writing my diploma thesis, so this will not happen during the next weeks.

]]> By: lukas http://physos.org/2005/07/05/docskdeorg-02/comment-page-1/#comment-50 lukas Wed, 06 Jul 2005 10:34:05 +0000 http://physos.org/?p=55#comment-50 <p>Nice job physos, I've got a small suggestion though: the webbrowser (usually) sends the user's preferred language, why not preselect it for him/her?</p> Nice job physos, I’ve got a small suggestion though: the webbrowser (usually) sends the user’s preferred language, why not preselect it for him/her?

]]> By: jmfayard http://physos.org/2005/07/05/docskdeorg-02/comment-page-1/#comment-49 jmfayard Wed, 06 Jul 2005 08:31:23 +0000 http://physos.org/?p=55#comment-49 <p>Great, but you have a problem with localization : If I choose fr as language, clicking on kdenetwork then on kmail gives me the french version If I type kmail in the search box, I get the english version.</p> <p>What about not displaying ISO codes to the user by the way ? - en - fr - .... + English + Francais + ...</p> <p>Cheers.</p> Great, but you have a problem with localization : If I choose fr as language, clicking on kdenetwork then on kmail gives me the french version If I type kmail in the search box, I get the english version.

What about not displaying ISO codes to the user by the way ? - en - fr - …. + English + Francais + …

Cheers.

]]> By: physos http://physos.org/2005/07/05/docskdeorg-02/comment-page-1/#comment-48 physos Tue, 05 Jul 2005 16:07:00 +0000 http://physos.org/?p=55#comment-48 <p>Till: See <a href="http://physos.org/2005/06/27/docskdeorg-01/" rel="nofollow">my previous blog</a> about the implementation details.</p> <p>AJAX is a nice buzzword, but it has to make sense. I may use JavaScript to get rid of the reload, but thats it. There is no sense in adding the complication of AJAX just for the buzz. The information presented on docs.kde.org is basically there at load time and all that is needed is some JavaScript to change the DOM tree. No need for asyncronus loading of informations. (Which is what AJAX is about)</p> <p>ATM, there are still major browser incompatibilities in using JavaScript (look at the GMail code if you want to see lots of browser hacks.) so JavaScript has to be used sparsely and cautiously.</p> <p>This is docs.kde.org, not KDE. This is a service for a small group of users compared to GMail and others. I prefer putting hours into KDE itself to adding yet another eyecandy to a page nicely doing its job.</p> <p>The Search is the only part where incremental live search would be nice, but that means an new search engine, which is far beyond the time I am willing to put into this and I did already put many hours into docs. </p> <p>If somebody wants to write a fast and powerfull search engine for HTML and PDF, with UTF-8 support, which allows for incremental search in 3GB of HTML files (no PDFs yet but I assume at least the same amount of data which adds up to 6GB, the current index over all 20 languages is 800MB.) I will gladly use it, but I wont write it as long as the current solution works perfectly.</p> Till: See my previous blog about the implementation details.

AJAX is a nice buzzword, but it has to make sense. I may use JavaScript to get rid of the reload, but thats it. There is no sense in adding the complication of AJAX just for the buzz. The information presented on docs.kde.org is basically there at load time and all that is needed is some JavaScript to change the DOM tree. No need for asyncronus loading of informations. (Which is what AJAX is about)

ATM, there are still major browser incompatibilities in using JavaScript (look at the GMail code if you want to see lots of browser hacks.) so JavaScript has to be used sparsely and cautiously.

This is docs.kde.org, not KDE. This is a service for a small group of users compared to GMail and others. I prefer putting hours into KDE itself to adding yet another eyecandy to a page nicely doing its job.

The Search is the only part where incremental live search would be nice, but that means an new search engine, which is far beyond the time I am willing to put into this and I did already put many hours into docs.

If somebody wants to write a fast and powerfull search engine for HTML and PDF, with UTF-8 support, which allows for incremental search in 3GB of HTML files (no PDFs yet but I assume at least the same amount of data which adds up to 6GB, the current index over all 20 languages is 800MB.) I will gladly use it, but I wont write it as long as the current solution works perfectly.

]]> By: physos http://physos.org/2005/07/05/docskdeorg-02/comment-page-1/#comment-47 physos Tue, 05 Jul 2005 15:44:48 +0000 http://physos.org/?p=55#comment-47 <p>mattr: The green is from <a href="http://wiki.kde.org/Colors" rel="nofollow">The CIG Colors</a></p> mattr: The green is from The CIG Colors

]]> By: Till http://physos.org/2005/07/05/docskdeorg-02/comment-page-1/#comment-46 Till Tue, 05 Jul 2005 15:35:43 +0000 http://physos.org/?p=55#comment-46 <p>What about some google-suggest-like AJAX implementation!? That would be a really cool feature. What language is that stuff written in? AJAX doesn't look very complicated. Check this: http://java.sun.com/developer/technicalArticles/J2EE/AJAX/</p> <p>Cheers, Till</p> What about some google-suggest-like AJAX implementation!? That would be a really cool feature. What language is that stuff written in? AJAX doesn’t look very complicated. Check this: http://java.sun.com/developer/technicalArticles/J2EE/AJAX/

Cheers, Till

]]> By: Sam Weber http://physos.org/2005/07/05/docskdeorg-02/comment-page-1/#comment-45 Sam Weber Tue, 05 Jul 2005 14:21:19 +0000 http://physos.org/?p=55#comment-45 >I’m not sure about the green though. maybe if >it was darker it would look better.

I like the green.

-Sam

]]>