Re: knowit

Michal Rudolf <mrudolf-W20+MoKGEJdEHWO/[email protected]> Tue, 27 Apr 2004 11:27:36 +0200
Newsgroups gmane.comp.kde.devel.knowit
Message-ID <[email protected]>
=2D----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Jon Black,  wtorek 27 kwiecie=F1 2004 10:36:

>I found this class in the QT development libraries (3.2.2). Not sure what
>version knowit is using.=20
It requires at least Qt 3.1.x.

>This class is a standard text edit box with url=20
>support. The problem is that this is only usable in read mode only, so use=
rs
>can't edit it.=20
There are two classess: QTextEdit and QTextBrowser. The second one is=20
read-only and supports links (i. e. allows detecting if cursor is over a=20
link, handles link click events etc.).
The first one displays links correctly but has no click-on-link event=20
handling. You cannot easily add a link to current text (you can only add ne=
w=20
text containing links, or (perhaps) append a link to the end of text.

Internally text is kept as HTML (<body><b>Text</b>...</body>). And main=20
problems are: how to insert HTML strings in current cursor position (f. e. =
<a=20
href=3D"link">...</a>) and how to detect what is under ther mouse at the=20
moment.

XML structure would be applied to whole file, not to single notes. They wou=
ld=20
be stored as HTML strings, as before.

>This is the KHTMLView, which renders and displays HTML.
>This is certainly a difficult area!
KHTMLView is not suitable because it is too complicated (it handles real HT=
ML=20
document, not only simple ones) and it is read only.

>I'm not entirely sure what you mean by this. Do you mean having the notes
>linked in different ways in memory than visibly, so that operations can be
>performed on the memory structure quicker? Immediately, what comes to mind,
>is a doubly linked-list. Again, depends on what you mean :)
No. I thought about GUI, not implementation. Some thoughts how notes could =
be=20
organized:

Internally:
1. Notes are kept on a list.
2. Each note has unique ID.
3. Each note can link to any other.
4. There are two kind of links: parent-child and note-note.
5. Parent-child links cannot form a cycle.

GUI:
6. We could browse notes as a list (using 1)
7. We could browse notes as a tree (using 1+5)
8. We could browse notes as a graph (probably graphically, there is no widg=
et=20
for it) (using 1+4)

This way we could have different views for the same set of notes - and view=
s=20
could be switched anytime.


>>++ Format: [Current Note][Last Saved:
>>That would require keeping those information per note.
>Not necessarily. Since only one note is in view/focused at a time, we only
>need to know the stats for that note.=20
I think it is reasonable to keep per-note information about:
* date of creation
* date of last modification
* author of last changes (perhaps with an e-mail)
That would make using Knowit easier for group development. Quanta TODO file=
 is=20
kept in KnowIt document.

To save some space, we could make it optional, so that you could save docum=
ent=20
without it.


>> >++ Export html as seperate pages (option). Use frames to link them etc.
>> > Just an alternate knowit feel to it!
>I use knowit to write up revision notes for my exams. Its so useful for
> that, since I can organise it by module, topic etc very easily. The probl=
em
> is when I export it just lumps it into one page, which is very unmanagabl=
e.
> Having a frames HTML page (menu on the left) and content shown in the rig=
ht
> hand frame, the knowit GUI is essentially retained in the export - that w=
ay
> my notes can be on my website without much difference to them being in
> knowit.
It looks interesting. Perhaps, to make everybody happy, we should create=20
templates, where you could use some %note, %title etc fields to create=20
document. But I am not sure if it could be done reasonably.

>Finally, one more idea, which I wouldn't mind starting myself right now, is
> to write the help documentation. Since knowit is such a good format, the
> help file could be written using knowit. All that happens when u click on
> help->index, is that it loads the help knowit file! :O)
KDE Help file is a standard way to keep documentation - and it has some=20
advantages, such as using index.

Knowit TODO file should be written in Knowit, though ;-)

I am sending CC to knowit-devel, it would make sense to move discussion the=
re.
=2D --=20
Michal Rudolf
=2D----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (GNU/Linux)

iD8DBQFAjieV2dfk8YI8//URAkfMAJ4gY0hsmqCqDlHYCJDZN154fbN9qwCfeodf
ZeC+d+D56Ze8xdENJqJ37Hk=3D
=3DWQ+y
=2D----END PGP SIGNATURE-----


-------------------------------------------------------
This SF.net email is sponsored by: The Robotic Monkeys at ThinkGeek
For a limited time only, get FREE Ground shipping on all orders of $35
or more. Hurry up and shop folks, this offer expires April 30th!
http://www.thinkgeek.com/freeshipping/?cpg=12297