# A &kjots; kézikönyve

Matt
Johnston

    matt.kde@caifex.org

Christoph
Neerfield

    Christoph.Neerfield@home.ivm.de

Fejlesztő
Lauri
Watts

    vampyr@atconnex.net

Lektor
Tamás
Szántó
Magyar fordítás

    tszanto@mol.hu

2000
Matt Johnston
&FDLNotice;
2000-12-14
0.05.00

Ez a dokumentum a &kjots; 0.5-ös verziójának leírását tartalmazza. A &kjots; egy egyszerűen kezelhető program feljegyzések készítéséhez.

KDE
KJots
kdeutils
feljegyzések
jegyzettömb

## Bevezetés

A &kjots; egy egyszerű jegyzetkészítő program. A feljegyzések ('cetlik') a könnyű áttekinthetőség érdekében csoportosíthatók.

### A &kjots; eddigi verziói

(Carsten Pfeiffer pfeiffer@kde.org)

  - a `KEdit` használata a `QMultiLineEdit` helyett, kiegészítve a Keresés, Csere, Visszavonás lehetőségekkel

  - a `KTMainWindow` lefoglalása a heapről a kilépéskori kétszeres törlés elkerülése érdekében

Új a 0.4-es verzióban (Mario Weilguni mweilguni@kde.org)

  - kompatibilitás a Qt 2.0-val

  - a főablak hibás elrendezése kijavítva

  - az elhelyezés javítása az `AskFileName()`-ben

  - az elhelyzés javítása a `SubjList()`-ben

  - néhány fordítási figyelmeztetés megszüntetése

  - Az Alkalmazás gomb csak módosítás esetén aktiválódik

  - a beállítóablak kialakításának javítása

  - egy betűtípus-választási hiba kijavítása

  - most már lefordítható a program az EGCS-sel is (Robert Williams)

Új a 0.3.0-ás verzióban

  - sok új billentyűparancs

  - a `klocale->translate()` használata

Új a 0.2.6-os verzióban

  - az ikonok láthatók az eszköztárban

Új a 0.2.5-ös verzióban

  - a füzetek és az oldalak kimenthetők szöveges fájlba

  - jobb illeszkedés a &kde; standardhoz a `KTopLevelWidget` használatával

Új a 0.2.4-es verzióban

  - a `KFontDialog` használata a betűtípus kiválasztásához

  - ha kijelöl egy URL-t a szövegben és a jobb egérgombbal kattint, végrehajthat egy programot a megadott URL-lel. A program neve külün megadható a &HTTP; és az &FTP; protokollokhoz.

  - kisebb formai javítások

Új a 0.2.3-as verzióban

  - a program kompatibilis a libkde-970510 verzióval (már nem érdekes)

  - oldal törlésekor jelentkező memóriahiba javítása

  - ha duplán rákattint a lista egyik bejegyzésére, akkor a listaablak bezárul

  - egy betűtípus -> sok betűtípus ;)

Új a 0.2.2 verzióban

  - lefordítható a libkde-0.7.2-vel (már nem érdekes)

  - kisebb hibajavítások

Új a 0.2.1-es verzióban

  - hibátlanul lefordítható a libqt 1.2-vel és a libkde-0.7.1-gyel vagy annál újabbal (már nem érdekes)

Új a 0.2.0-ás verzióban

  - az ablak elrendezése jobban igazodik a KDE-s előírásokhoz (eszköztár, állapotsor, ...)

  - a mappa új neve könyv, a bejegyzés új neve oldal

  - tárgy hozzáadása minden oldalhoz

  - előhívható egy ablak a tárgyak felsorolásával, hogy az oldalak könnyen megtalálhatók legyenek

  - az ablak minimális méretét sikerült tovább csökkenteni

Új a 0.1.1-es verzióban

  - nem törli többé az üres sorokat

  - tabulátorok szúrhatók a szövegbe

  - az ablak minimális méretét sikerült csökkenteni

  - a program elmenti az ablak méretét és a következő induláskor visszatölti

0.1-es verzió (feltehetően)

  - Az eredeti kiadás

## A &kjots; kezelése

A &kjots;-ban a feljegyzések két szinten csoportosíthatók: könyveket és oldalakat lehet létrehozni.

A feljegyzések könyvekbe csoportosíthatók, a könyvekben pedig lapokat lehet létrehozni. A könyveknek érdemes valamilyen jellemző nevet adni (a keresés megkönnyítése érdekében), sőt az oldalak is elláthatók névvel. Ez utóbbi nem kötelező, de a könnyű áttekinthetőséget nagyban elősegíti.

### A könyvek használata

Új könyv létrehozásához használja a Ctrl n billentyűparancsot vagy a Fájl Új könyv menüpontot. A program megkérdezi az új könyv nevét.

A könyv neve az ablak bal alsó részén lesz látható. Ha azt szeretné, hogy a könyv felkerüljön a Gyorslistára, válassza a Gyorslista Az aktuális könyv hozzáadása a gyorslistához menüpontot. Ezután a könyv nevét tartalmazó nyomógomb megjelenik az ablak alsó részén. A gyorslista legfeljebb 8 könyvet tartalmazhat. Egy könyv eltávolításához válassza a Gyorslista Az aktuális könyv eltávolítása a gyorslistából menüpontot.

Egy könyv elmentéséhez nyomja meg a Ctrl S billentyűkombinációt vagy válassza a Fájl Az aktuális könyv elmentése menüpontot. Könyv váltásakor és a programból való kilépéskor az aktuális könyvet automatikusan elmenti a program.

Akár az egész könyv elmenthető szöveges fájlként a Fájl A könyv mentése ASCII fájlba menüponttal. A program bekéri ilyenkor a létrehozandó fájl elérési útját. Alább látható egy tesztként használt könyv elmentésének eredménye:

    ############
    # Első oldal
    ############
    Szombaton bevásárlás!!

    #############
    # Fontos programjaim
    #############
    10 PRINT "HELLO WORLD"
    20 GOTO 10

    ################
    # Harmadik oldal
    ################
    Ez egy mintaszöveg a harmadik oldalról.

### Az oldalak használata

Az oldalak tartalmazzák a feljegyzéseket. Egy könyv létrehozása után az oldalak tartalma szabadon szerkeszthető.

Új oldalakat lehet létrehozni a Szerkesztés Új oldal menüponttal. Az aktuális oldal törléséhez válassza a Szerkesztés Az oldal törlése menüpontot.

Az oldalak könnyű azonosíthatóságához érdemes nekik tárgyat (egy azonosító nevet) adni. A tárgy beírható az ablak alján látható szöveges mezőben. Megnézheti az aktuális könyvhöz tartozó tárgylistát a Ctrl L billentyűparanccsal vagy a Gyorslista Tárgylista menüponttal.

Az oldalak közötti váltáshoz használja a Ctrl K (következő oldal) és a Ctrl J (előző oldal) parancsokat. A szerkesztőablak alatti gördítősáv is használható.

Ha kijelöl egy URL-t, például a http://www.kde.org -ot vagy az ftp://ftp.kde.org -ot, és a jobb egérgombbal rákattint a kijelölt szövegre, akkor megnyithatja az URL-t a &konqueror;ban vagy bármely más programban, ha korábban beállította itt: Beállítások A KJots beállításai.

## A parancsok listája

### A Fájl menü

Ctrl N Fájl Új könyv...

  Létrehoz egy új könyvet.

Ctrl S Fájl Az aktuális könyv elmentése

  Elmenti az aktuális könyvet. A könyvek tartalma a `$HOME/.kde/share/apps/kjots/` könyvtárba kerül. Minden könyv külön fájlba kerül, olvasható (szöveges) formában.

Fájl A könyv mentése ASCII fájlba

  Elmenti az aktuális könyv tartalmát egy szöveges fájlba. Lásd: a könyvek használata.

Fájl Az oldal mentése ASCII fájlba

  Elmenti az aktuális oldalt egy szöveges fájlba.

Fájl Az aktuális könyv törlése

  Törli az aktuális könyvet.

Ctrl Q Fájl Kilépés

  Bezárja a programot

### A Szerkesztés menü

Ctrl X Szerkesztés Kivágás

  Kivágja a szerkesztőben kijelölt szöveget a vágólapra.

Ctrl C Szerkesztés Másolás

  Kimásolja a szerkesztőben kijelölt szöveget a vágólapra.

Ctrl V Szerkesztés Beillesztés

  Beilleszti a vágólapon található szöveget a szerkesztőbe.

Ctrl F Szerkesztés Keresés...

  Megkeresi a megadott szöveget (csak az aktuális oldalon).

F3 Szerkesztés A következő keresése

  Megkeresi a megadott szöveg következő előfordulását (a Keresés használata után).

Ctrl R Szerkesztés Csere...

  Kicseréli a megadott szövegrészt egy másikra (csak az aktuális oldalon).

Ctrl W Szerkesztés Új

  Létrehoz egy új, üres oldalt az aktuális könyvben.

Ctrl D Szerkesztés Az oldal törlése

  Törli az aktuális oldalt.

Ctrl J Szerkesztés Előző

  Az aktuális könyv előző oldalára áll (ha van).

Ctrl K Szerkesztés Következő

  Az aktuális könyv következő oldalára áll (ha van).

### A Gyorslista menü

Gyorslista Az aktuális könyv hozzáadása a gyorslistához

  Hozzáadja az aktuális könyvet a gyorslistához. Lásd: a könyvek használata

Gyorslista Az aktuális könyv eltávolítása a gyorslistából

  Eltávolítja az aktuális könyvet a tárgylistából. Lásd: a könyvek használata

Ctrl L Gyorslista Tárgylista

  Megjeleníti az aktuális könyv tárgylistáját, lehetővé téve a kívánt oldalra ugrást.

### A Beállítások menü

Beállítások A billentyűparancsok beállítása...

  Itt lehet megváltoztatni a programban használt billentyűparancsokat.

Bbeállítások A KJots beállításai...

  Itt lehet megváltoztatni a program beállításait, például az URL-ek megnyitásához használt külső program nevét és a betűtípust.

### A Segítség menü

F1 Segítség Tartalom

  Megjeleníti ezt a dokumentumot.

Shift F1 Segítség Mi ez?

  Hatására megváltozik az egérmutató alakja, és ha ilyenkor rákattint egy elemre, rövid tájékoztató szöveget kaphat róla. Egyelőre még nem működik.

Segítség Hibabejelentés...

  A programban talált hibák kényelmes bejelentésére szolgál.

Segítség A KJots névjegye

  Megjeleníti a program verziószámát és a szerzők nevét.

Segítség A KDE névjegye

  Megjelenít néhány adatot a KDE projektről.

## Köszönetnyilvánítások és a licencegyezmény

&kjots;

Program copyright: Christoph Neerfeld (Christoph.Neerfeld@home.ivm.de), 1997.

A tkgoodstuff csomag jots nevű programja alapján készült. A tkgoodstuff csomag: Copyright Mark Crimmins (markcrim@umich.edu), 1995-96.

Documentation copyright: Matt Johnston (matt.kde@caifex.org), 2000.

(Részben) Documentation Copyright Christoph Neerfeld (Christoph.Neerfeld@home.ivm.de), 1998.

&underFDL;

&underGPL;

## Telepítés

### A &kjots; megszerzése

A &kjots; a KDE projekt (http://www.kde.org) része, a kdeutils nevű csomag részeként letölthető innen: ftp://ftp.kde.org/pub/kde/, a KDE projekt központi FTP-kiszolgálójáról.

### Követelmények

A &kjots; használatához a KDE 2.0-ás vagy annál újabb változata szükséges. Más említésre méltó követelmény nincs.

### Lefordítás és telepítés

A program lefordításához és telepítéséhez az alábbi parancsokat kell kiadni a &kjots; forráscsomag alapkönyvtárában:

    % ./configure
    % make
    % make install

A &kjots; fordítási szkriptjei az autoconf és az automake segítségével készültek, külön beállítást nem igényelnek. A felmerült problémák leírását küldje el a KDE levelezőlistákra.

### Beállítás

A &kjots; egy egyszerű kis program, nem igényel külön beállítást az első indítás előtt.

&documentation.index;