[Ktechlab-devel] Context Help

[Thomas Winkel]

Am Dienstag 24 Januar 2006 17:52 schrieb David Saxton:
> (that's what happens when I try and multitask by eating cornflakes at the
> same time as replying to emails :p ).

Beware, crumbs in the keyboard is a serious matter!! :)

> I've been thinking about where to store the changes. I think that the
> directory should be explicitly specified, instead of ktechlab trying to
> guess where to put them? How does attempting to write
> to /usr/share/apps/ktechlab/contexthelp/, and if that fails, it requests a
> directory location?

Asking for a location is a good idea, also in terms of usability because then 
a user directly knows where to find his writings.
I wouldn't try to overwrite the original file because of three points:
- by using a different file it is allways possible to restore to defaults by 
simply deleting it.
- A "desktop user" may be overstrained to find his changes in file system.
- When he sends his writings to the list, it's easier for us, if the file 
contains only his changes.

> That icon looks good - is it released under a GPL-compatible license?
> Or some appropriate license for distributing with ktechlab?

I'm sure it is, and I used it now. Wikipedia has created an extra stylesheet 
class to handle external links, but my html knowledge is not good enough for 
such things. Now I have an <img src=external.png> after each link.

> > When the user clicks on such a link, which has not been described so far,
> > the "This help item does not yet exist..." message should appear, such
> > that he can create it. Maybe such links can be marked red like in
> > Wikipedia. Great would be an option to create a link of a keyword which
> > needs further description in the editor.
> Good ideas.

Will I have to do something in the html code, or can KTechlab handle all this?

> I'm happy to tidy up any English text you enter. So short texts should just
> be fine - I'll expand any necessary sections.
I'll see what I can do, but at present I'm very busy with my diploma thesis 
and writing English text takes me much more time than German.

If you give me a svn account I can commit the first version soon.
How to handle new files like images? Will I have to add them to the KDevelop 
project in order to make them known for "make install"?

Thomas