02/10/2000
1.94.00

# Manual för KDE:s hjälpsystem

## KDE:s hjälpsystem

KDE:s hjälpsystem är designat för att enkelt komma åt UNIX:s standardhjälpsystem (man och info), lika väl som KDE:s egna dokumentation (HTML).

Alla KDE:s basprogram är fullständigt dokumenterade tack vare dokumentationsgruppens arbete. Om du vill hjälpa till så kan du skriva till Mike McBride (e-post mmcbride@ematic.com), som är samordnare för dokumenteringen. Du behöver inte ha någon erfarenhet, utan det räcker med entusiasm och tålamod. Om du skulle vilja hjälpa till med att översätta KDE:s dokumentation till ditt modersmål så kan du kontakta éric Bischoff ebisch@cybercable.tm.fr, som är samordnare för översättningarna. Mer information, inklusive samordnarna för översättningen av de olika språken, kan du hitta på Webbplatsen för internationalisering samt i kontakt-sektionen av det här dokumentet.

### Installation

&khelp; är en integrerad del av KDE:s basinstallation, och installeras med varje kopia av KDE. Du hittar det i paktete kdebase, som du kan hämta från KDE:s FTP-plats eller genom att installera paketet kdebase i din Linux-distribution.

## Att ta fram hjälpen

&khelp; kan startas på flera sätt:

Från Hjälp-menyn

  Det vanligaste sättet är förmodligen inifrån programmet. Välj Hjälp Innehåll för att öppna ett programs hjälpfil. Du startar då på innehållssidan.

Från K menyn

  Klicka på det stora K:et i panelen och välj Hjälp för att öppna &khelp;. Du startar då på välkomstsidan.

Från panelen

  Panelen (Kicker) innehåller som standard en ikon som heter &khelp;. Välkomstsidan kommer att visas igen.

Från kommandoraden

  &khelp; kan startas enom att använda en webbadress för att visa en fil. Webbadresser har även lagts till för info- och man-sidor. Du kan använda dem på följande sätt:

  Ett programs hjälpfil

    `khelpcenter `help:/kedit``

    Öppnar Kedit:s hjälpfil på innehållssidan.

  En lokal webbadress

    `khelpcenter `file:/usr/local/src/qt/html/index.html``

  En manualsida

    `khelpcenter `man:/strcpy``

  En infosida

    `khelpcenter `info:/gcc``

  Om `khelpcenter` körs utan några parametrar så öppnas välkomstsidan

## Gränssnittet i &khelp;

Gränssnittet i &khelp; består av två avdelningar med information, inlagda i ett &konq;-fönster. Det här medför att det blir enkelt och intuitivt att navigera med hjälp av &konq;s egna verktygsrader, precis som du skulle göra på en webbsida. Dessutom innehåller de flesta dokumenten sina egna navigeringsverktyg som gör det möjligt att läsa dokumentets delar i ordning med länkarna Nästa och Föregående , alternativt att förflytta sig mindre strukturerat med hjälp av hyperlänkarna. Länkar kan förflytta dig till andra delar av samma dokument eller till ett annat dokument. Du kan använda ikonerna Bakåt (en pil åt vänster) eller Framåt (en pil åt höger) i verktygsraden för att förflytta dig genom de dokument som du har läst i den aktuella sessionen.

I den vänstra avdelningen visas hjälpsystemets innehåll, och i den högra visas själva hjälpfilerna.

### Avdelningen Innehåll

Avdelningen Innehåll i &khelp; visas i den vänstra sidan av fönstret. Som du kanske har gissat så kan du flytta på avgränsningskanten så att du på ett bekvämt sätt kan läsa innehållet i de båda avdelningarna.

Avdelningen Innehåll är dessutom uppdelad i två flikar, en som innehåller en meny som visar all hjälpinformation som &khelp; känner till, samt en annan flik som ger dig möjlighet att Söka efter specifik information.

#### Innehållsmenyn

I Innehåll finns följande poster som standard:

Introduktion

  Välkommen till KDE - en introduktion till K skrivbordsmiljö.

Introduktion till KDE

  KDE:s snabbstartsvägledning. Innehåller en rundvisning av KDE:s gränssnitt och specifik hjälp och tips för hur kan arbeta smartare med KDE.

KDE:s användarhandbok

  KDE:s användarhandbok är en ingående genomgång av KDE, som tar upp inställning, anpassning och användning.

Programhandböcker

  Dokumentation för program som ingår i KDE. Alla KDE-program har dokumentation i HTML-format. Den här sektionen innehåller en lista med alla KDE-program med kortfattade beskrivningar och länkar till den fullständiga dokumentationen.

  Programmen visas i en trädstruktur som motsvarar den förinställda strukturen i K-menyn, vilket gör det enkelt att hitta programmet som du letar efter.

Systemets manualsidor

  UNIX manualsidor är det traditionella formatet på dokumentationen för UNIX-system. De flesta program i ditt system har en manualsida. Dessutom finns det manualsidor för programmeringsfunktioner och filformat.

Systemets info-katalog

  TeXinfo-dokumentation används av många GNU-program, bland annat gcc (C/C++-kompilatorn), emacs och många andra.

KDE:s frågor och svar

  Vanliga frågor om KDE, och svaren till dem.

KDE på webben

  Länkar till KDE på webben, både KDE:s officiella webbplats och andra användbara platser.

Kontaktinformation

  Information om hur du kan kontakta KDE-utvecklare, och hur du går med i KDE:s e-postlistor.

Stöd KDE

  Hur du kan hjälpa till, och hur du gör för att engagera dig.

#### Sök-fliken

För att kunna söka måste du ha programmet ht://Dig installerat. Information om hur du installerar och ställer in sökindexet finns tillgänglig i dokumentet. Inställningen av sökindexet görs i KDE:s Inställningscentral genom att välja Hjälp Index, och detaljerad hjälp finns tillgänglig i den modulen.

För ändamålet med det här dokumentet så antar vi att du redan har installerat och ställt in detta.

Searching the help files is fairly intuitive, enter the word(s) you wish to search for in the text box, choose your options (if any), and press Search. The results display in the viewer pane to the right.

The options available are:

Method

  Choose how to search for multiple words. If you choose and, results are returned only if all your search terms are included in the page. or returns results if any of the search terms are found, and boolean lets you search using a combination.

  Boolean syntax lets you use the operators `AND`, `OR` and `NOT` to create complex searches. Some examples:

  `cat and dog`

    Searches for pages which have both the words `cat` and `dog` in them. Pages with only one or the other will not be returned.

  `cat not dog`

    Searches for pages with `cat` in them, but only returns the ones that don't have the word `dog` in them.

  `cat or (dog not nose)`

    Searches for pages which contain `cat`, and for pages which contain `dog` but don't contain `nose`. Pages which contain both `cat` and `nose` would be returned, pages containing all three words would not.

  If your searches are not returning the results you expect, check carefully you haven't excluded the wrong search term with an errand `NOT` or a stray brace.

Max. results

  Determines the maximum number of results returned from your search.

Format

  Decide if you want just a short link to the page containing your search terms, or do you want a longer summary.

Sort

  Sort the results in order of Score (how closely your search terms were matched,) alphabetically by Title or by Date. Selecting the Reverse order check box, naturally enough, reverses the sort order of the results.

Update index

  Update the search index, to incorporate new documents, or if you think your database is incomplete or damaged. This may take some time.

### The Man and Info sections

Man pages are the standard unix manual pages, and have been in use for many years on many operating systems. They are extremely thorough, and are the very best place to get information about most linux commands and applications. When people say RTFM, the Manual they're referring to is very often the man page.

The man pages are not perfect however. They tend to be in depth, but also extremely technical, often written by developers, and for developers. In some cases this makes them somewhat unfriendly, if not downright impossible for many users to understand. They are however, the best source of solid information on most commandline applications, and very often the only source.

If you've ever wondered what the number is when people write things like man(1) it means which section of the manual the item is in. You'll see &khelp; uses the numbers to divide the very many man pages into their own sections, making it easier for you to find the information you're looking for, if you're just browsing.

Also available are the Info pages, intended to be a replacement for the man pages. The maintainer of some applications no longer update the man pages, so if there is both a man page and an info page available, the info page is probably the most recent. Most applications have one or the other though. If the application you are looking for help on is a GNU utility, you will most likely find it has an info page, not a man page.

#### Navigating inside the Info pages

Info documents are arranged hierarchically with each page called a node. All info documents have a Top node, i.e. the opening page. You can return to the Top of an info document by pressing Top.

Prev & Next are used to move to the previous/next page at the current level of the hierarchy.

Clicking on a menu item within a document moves you to a lower level in the hierarchy. You may move up the hierarchy by pressing Up.

Man is treated similarly to info, with the section index being the Top node and each man page on the level below. Man entries are one page long.

## Utvecklare och Licenser

&khelp;

Ursprungligen utvecklad av Matthias Elter me@kde.org

Nuvarande underhållare är Matthias Hoelzer-Kluepfel mhk@kde.org

&underFDL; &underGPL;