# The &kjots; Handbook

## Using &kjots;

&kjots; has two basic items used to organize your notes - Books and Pages.

&kjots; Main Window &kjots; Main Window

You can create a number of books in &kjots;, and each book can contain a number of pages, where you actually type your notes. Each book should be given a name (so you can find what you are looking for), as should each page. Although you aren't forced to give a page a name, it is sensible to do so.

The left pane of the main window shows the Local Notes and all books and pages in a tree view.

If Local Notes or book items are selected, the editor in the right pane displays tables of contents with titles of books and pages as links, which allow to navigate quickly through the notes and read the pages.

The content of pages is shown in read only mode. Only if a page is selected in the tree view or by clicking on a page title in the editor pane, the page content can be edited.

### Using Books

To create a new book, use &Ctrl;&Shift; N or the menu entry File New Book, and you will get a new book named New Book with an empty page named New Page.

The name of the new book should now appear in the left part of the window. If you want the book to be in your Bookmarks, use &Ctrl; B or the menu entry Bookmarks Add Bookmark . You can even organize your bookmarks in separate folders just as you probably do in &konqueror;.

If you want to have your books in a different order, you can simply drag and drop the book to the place where you want it to be.

Maybe you have noticed that there is no Save anywhere. This is not an error, &kjots; saves your books and pages automatically, so you will never lose that small note you write when you are on the phone and need to write down something in a hurry.

You can also export an entire book as a text, html file or as a book file, using the items in File Export . You will be then prompted to enter a location for the file to be saved. The text format of an example saved book in text format is shown below:

    ############
    # First page
    ############
    Remember to go to the shops!

    #############
    # Useful code
    #############
    10 PRINT "HELLO WORLD"
    20 GOTO 10

    ################
    # The third page
    ################
    This is the third page and is an example for &kjots;.

Remember that the dialog where you are prompted for a filename is a standard &kde; dialog. That means it is just as easy to store the file on your local hard disk as it is to save it on a web server, ftp server or USB memory stick. So you can export as html and save it on a webserver; this way you always have your notes available to you.

You can import &kjots; notes in the book file format with an extension `.book`. Copy this file to `$`KDEHOME`/share/apps/kjots`. Now start ``kjotsmigrator `--interactive``` and the data is imported as Book into &kjots;.

### Using Pages

Pages are where you actually write whatever you are going to write. Once you have created a book, you can type text in the main text box.

To create additional pages, you can use &Ctrl; N or the menu entry File New Page , which will create a new page. Similarly, the current page can be removed using File Delete Page.

If you need to insert the current date and time while you are writing a note, you can use &Ctrl;&Shift;I .

So that you can get to the page you want to see, pages can (and should) be given a name. This can be done in the way you are used to: double click the page you want to rename. You are then able to rename the page. Of course there is also a keyboard shortcut you can use at any time while writing a note. The shortcut is: &Ctrl;M.

Another way of renaming the page is by selecting a part of your note and then press &Ctrl;T. The selected text will instantly become the title of the page.

Writing or editing your notes you can use the actions from Format menu or from the toolbar to format your text.

## Credits and License

&kjots;

Program copyright 1997 Christoph Neerfeld Christoph.Neerfeld@home.ivm.de

Based on the `jots` program included in the tkgoodstuff package. The tkgoodstuff package is copyright 1995-96 Mark Crimmins markcrim@umich.edu

Documentation copyright 2000 &Matt.Johnston; matt.kde@caifex.org

Some parts taken from documentation copyright 1998 Christoph Neerfeld Christoph.Neerfeld@home.ivm.de

&underFDL; &underGPL;

## Installation

### How to obtain &kjots;

&install.intro.documentation;

### Compilation and Installation

&install.compile.documentation;
&documentation.index;