<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [ <!ENTITY knowit '<application>KnowIt</application>'> <!ENTITY kapp "&knowit;"><!-- replace knowit here --> <!ENTITY % addindex "IGNORE"> <!ENTITY % English "INCLUDE"><!-- change language only here --> <!-- Do not define any other entities; instead, use the entities from kde-genent.entities and $LANG/user.entities. --> ]> <book lang="&language;"> <bookinfo> <title>The KnowIt Handbook</title> <authorgroup> <author> <firstname>Michal</firstname> <othername></othername> <surname>Rudolf</surname> <affiliation> <address><email>m.rudolf@uw.edu.pl</email></address> </affiliation> </author> </authorgroup> <!-- TRANS:ROLES_OF_TRANSLATORS --> <copyright> <year>2002</year> <year>2003</year> <holder>Michal Rudolf</holder> </copyright> <!-- Translators: put here the copyright notice of the translation --> <legalnotice>&FDLNotice;</legalnotice> <date>12/12/2003</date> <releaseinfo>0.9</releaseinfo> <abstract> <para> &knowit; is an application to help you keep, edit and maintain notes. </para> </abstract> <keywordset> <keyword>KDE</keyword> <keyword>KnowIt</keyword> <keyword>notes</keyword> <keyword>manage</keyword> <keyword>edit</keyword> <keyword>tree</keyword> <keyword>hierarchy</keyword> <keyword>HTML</keyword> </keywordset> </bookinfo> <chapter id="introduction"> <title>Introduction</title> <para> &kapp; is a simple tool for managing notes. It is similar to <ulink url="http://tuxcards.sourceforge.net">TuxCards</ulink>, but designed for KDE 3.x. Notes are organized in tree-like hierarchy, texts are stored in RichText format, so bold, italic and underline fonts are supported, as well as various text colors and unordered lists. </para> <para> &kapp; development depends on user's feedback! If you have suggestions or want to help developing &kapp;, have a look at the <ulink url="http://knowit.sourceforge.net">&kapp; page</ulink> to see what is still to do. </para> </chapter> <chapter id="using-kapp"> <title>Using &knowit;</title> <sect1 id="Interface"> <title>Interface</title> <para> The main screen of &knowit; is divided into two parts: on the left you can see the notes hierarchy (tree-like), on the right you can find the text of the current note. You can browse and manage notes in the tree view and edit them in the edit view. <screenshot> <screeninfo>Here's a screenshot of &kapp;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="screenshot.png" format="PNG"/> </imageobject> <textobject> <phrase>Screenshot</phrase> </textobject> </mediaobject> </screenshot> </para> <sect2 id="editing"> <title>Editing notes</title> <para> You can use standard KDE shortcuts for editing text. Unordered lists are supported: just start the line with <keycap>*</keycap>. <keycap>Enter</keycap> inserts a new paragraph (as in HTML there is an empty line between two paragraphs) - if you just want a line break, use <keycap>Ctrl+Enter</keycap> instead. </para> </sect2> <sect2 id="managing"> <title>Managing notes</title> <para> You can use shortcuts for adding notes. If the notes tree is active, just press <keycap>Ctrl+Enter</keycap> to add a same-level note following the current one, <keycap>Insert</keycap> to add a child-note and <keycap>Delete</keycap> to delete the current note. </para> <para> <guimenu>Notes</guimenu> menu or popup menu (accessed by right-clicking on the list) contains many commands for managing notes. Most of them have shortcuts assigned, for others you could assign them yourself. </para> </sect2> <sect2 id="links"> <title>Links</title> <para> You can create links in notes. Links will be displayed below the note text. There are two kinds of links: <emphasis>external</emphasis> (to any file or URL) - click on it, and it will be opened in appropriate application, and <emphasis>internal</emphasis> (to another note) - click on it, and note with appropriate title will be displayed. </para> </sect2> </sect1> </chapter> <chapter id="about"> <title>About &knowit;</title> <sect1 id="credits"> <title>Credits and License</title> <para> Program and documentation: </para> <para>copyright 2002, 2003 Michal Rudolf <email>m.rudolf@uw.edu.pl</email> </para> &underFDL; <!-- FDL: do not remove. Commercial development should --> &underGPL; <!-- GPL License --> </sect1> <sect1 id="new"> <title>New in this version</title> <para> <itemizedlist> <listitem><simpara>external and internal links</simpara></listitem> <listitem><simpara>better session management</simpara></listitem> <listitem><simpara>more options (autosave, configurable font and colors)</simpara></listitem> <listitem><simpara>many toolbars</simpara></listitem> <listitem><simpara>configurable Enter/Tab handling</simpara></listitem> </itemizedlist> &knowit; 0.9 was released at 12th of December 2003. File <filename>ChangeLog</filename> in source package contains information about changes in previous versions. </para> </sect1> </chapter> <appendix id="installation"> <title>Installation</title> <sect1 id="getting-knowit"> <title>How to obtain &knowit;</title> <para> Newest version of &knowit; can be found at <ulink url="href://knowit.sourceforge.net">knowit.sourceforge.net</ulink>. Updates will probably be announced on <ulink url="http://freshmeat.net">Freshmeat</ulink> and <ulink url="href://apps.kde.com">apps.kde.com</ulink>. </para> </sect1> <sect1 id="requirements"> <title>Requirements</title> <para> I use KDE 3.1 for both developing and testing &knowit;. As far as I know, it should work in both KDE 3.2 and KDE 3.0 without any problems. </para> <para> I doubt that it would compile in KDE 2.x - but I have no access to older KDE versions to check it. Anyway, any information about &knowit; in KDE 2.x would be welcomed. </para> </sect1> <sect1 id="compilation"> <title>Compilation and installation</title> <para> In order to compile and install &knowit; on your system, type the following in the base directory of the &knowit; distribution: <screen width="40"> <prompt>%</prompt> <userinput>./configure</userinput> <prompt>%</prompt> <userinput>make</userinput> <prompt>%</prompt> <userinput>make install</userinput> </screen> </para> <para>Since &knowit; uses autoconf and automake, you should have no trouble compiling it. Should you run into problems please report them to the autor.</para> </sect1> </appendix> &documentation.index; </book> <!-- Local Variables: mode: sgml sgml-minimize-attributes:nil sgml-general-insert-case:lower sgml-indent-step:0 sgml-indent-data:nil End: -->