2001-05-14
0.08.00

# Handbok för KDE:s hjälpsystem

## KDE:s hjälpsystem

&kde;:s hjälpsystem är utformat för att enkelt komma åt &UNIX;:s hjälpsystem (man och info), lika väl som &kde;:s egna dokumentation (XML).

Alla &kde;:s basprogram är fullständigt dokumenterade tack vare dokumentationsgruppens arbete. Om du vill hjälpa till så kan du skriva till Lauri Watts lauri@kde.org, 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 Thomas Diehl thd@kde.org, 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

&khelpcenter; är en integrerad del av &kde;:s basinstallation, och installeras med varje kopia av &kde; från paketet kdebase.

## Starta hjälpcentralen

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

Från Hjälpmenyn

  Det vanligaste sättet är förmodligen från något program. Välj Hjälp Innehåll för att öppna programmets 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 &khelpcenter;. Du startar då på välkomstsidan.

Från panelen

  &kicker; innehåller som standard en ikon som heter &khelpcenter;. Välkomstsidan kommer att visas igen.

Från kommandoraden

  &khelpcenter; kan startas genom 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:

  Hjälpfil till ett program

    `khelpcenter` `help:/kedit`

    Öppnar hjälpcentralen för &kedit; 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`

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

## Gränssnittet i &khelpcenter;

Gränssnittet i &khelpcenter; består av två avdelningar med information.

Verktygsfältet och menyerna förklaras närmare i sektionen .

De flesta dokumenten innehåller 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 lä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 tidigare.

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 &khelpcenter; 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 tre flikar, en som innehåller en meny som visar all hjälpinformation som &khelpcenter; känner till, samt en annan flik som ger dig möjlighet att Söka efter specifik information. En tredje flik innehåller ordförklaringar med &kde; och datatermer.

#### Innehållsmenyn

Innehåll har följande poster som standard:

Introduktion

  Välkommen till &kde; - en introduktion till K skrivbordsmiljö.

Introduktion till &kde;

  Snabbstartsvägledningen i &kde; innehåller en rundvisning av gränssnitt, specifik hjälp och tips för hur du kan arbeta smartare med &kde;.

&kde;:s bruksanvisning

  Användarhandboken är en ingående genomgång av &kde;, som tar upp inställningar, anpassning och användning.

Program manualer

  Dokumentation för program som ingår i &kde;. Alla &kde;-program har dokumentation i XML-format som konverteras till HTML när de visas. 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.

Manualsidor för Unix

  &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.

Bläddra bland informationssidor

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

Snabbstartsguide

  Enkel, steg för steg baserad vägledning.

Vanliga frågor om KDE

  Vanliga frågor om &kde; och svaren till dem.

&kde; på Internet

  Länkar till &kde; på webben, 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.

Att stödja &kde;

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

#### Fliken Sök

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 &kcontrol; 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.

Att söka bland hjälpfilerna är ganska enkelt, skriv sökordet i textrutan, välj eventuella alternativ och klicka på Sök. Resultaten visas i avdelningen till höger.

Alternativen är:

Metod

  Väljer hur den ska söka när flera sökord angivits. och visar resultat som innehåller alla sökorden du angav på samma sida. eller returnerar träffar som innehåller endera av sökorden. boolesk tillåter dig att kombinera sökorden.

  Boolesk syntax gör att du kan använda operatorer som `AND`, `OR` och `NOT` för att skapa komplicerade sökningar. Några exempel:

  `katt and hund`

    Söker efter sidor som har båda orden `katt` och `hund` i sig. Sidor som bara ett av orden kommer inte med i resultatet.

  `katt not hund`

    Söker efter sidor som innehåller `katt` men de får samtidigt inte heller innehålla ordet `hund`.

  `katt or (hund not nos)`

    Söker efter sidor som innehåller `katt`, samt för sidor som innehåller `hund` men inte `nos`. Sidor som innehåller både `katt` och `nos` kommer med, men sidorna som innehåller alla tre ord utelämnas.

  Returnerar dina söksvar inte vad du hade tänkt dig, bör du kontrollera att du har rätt sökmetod och inte missat ett `NOT` eller bortsprungen parentes.

Max. resultat

  Begränsar antalet svar som din sökning kan returnera.

Format

  Visar en kort eller längre del av svaren som sökningen gav.

Sortera

  Sorterar resultaten i Poäng hur bra sidan passade till sökningen, alfabetisk ordning på Titel eller i Datum ordning. Väljer man Omvänd ordning, så visas svaren naturligtvis i omvänd ordning.

Uppdatera index

  Uppdaterar sökindexet för att man ska kunna söka på nytillkomna dokument, eller om databasen kanske är gammal, tom eller trasig. Uppdateringar kan ibland ta lång tid.

### Man och Info sektioner

Man sidor är standard UNIX manualsidor, dessa har används i många operativsystem och år. De är mycket detaljerade och det bästa källan till information för de flesta Linux-kommandon och program. När man säger engelska RTFM, är det ofta dessa manualer man hänvisar till.

Man sidor är inte helt perfekta. De är mycket detaljerade men också mycket tekniska, oftast skriva av utvecklare för utvecklare. I några fall något ogästvänliga om inte omöjliga för flera att förstå.

Har du någon gång funderat över vad det är för nummer som skrivs vid manualer som tex man(1). Numret talar om vilken sektion manualen tillhör. &khelpcenter; använder också dessa sektioner för att gruppera alla manualer så att det ska bli enklare att hitta den information du letar efter.

Tillgängliga är även alla info sidor som var tänktes vara en ersättning till man sidor. Vissa utvecklare uppdaterar inte längre man sidorna och finns det både en man och info sida är det troligt att info sidan är den mest aktuella. Vanligast är att man har en man eller en info sida. Många &GNU;-program har oftast en info sida.

#### Navigera bland Info sidor

Info sidorna är arrangerade i en hierarki där varje sida kallas en nod. Alla info dokument har en toppnod, d.v.s. första sida. Man kan återgå till toppen av ett info dokument genom att trycka på topp.

Föregående & Nästa används till att förflytta sig föregående/nästa nod på den aktuell nivå i hierarkin.

Genom att klicka på en länk i dokumentet förflyttas man till en lägre nivå i hierarkin. För att komma upp ur hierarkin trycker man Upp.

Man fungerar nästan som info, med ett index som toppnod och varje man sida på nivån under. Man sidor har bara en lång sida.

### &kde;:s ordförklaringar

Ordförklaringar tillför en snabbreferens där man kan slå upp ord och beteckningar som du kanske inte känner till. De är en hel skala av &kde; specifika program och teknologier till vanliga &UNIX;-termer.

I den vänstra avdelningen finns det ett trädvy med två val: Alfabetiskt och Efter ämne. Båda har samma innehåll, men är sorterade olika, för att du enkelt ska hitta det du söker.

Man väljer i trädvyn till vänster och innehållet man valt visas till höger.

### Menyer och verktygsrad.

&khelpcenter; har inte så många funktioner, vilket gör att man kan koncentrera sig mer på att leta efter hjälpen än att lära sig hur man letar.

Följande ikoner finns på verktygsmenyn:

#### Verktygsikoner

Skriv ut ram

  Skriv ut den aktuella sidan.

Sök

  Sök på denna sida.

Öka teckenstorlek

  Ökar storleken på texten i avdelningen till höger.

Minska teckenstorlek

  Minskar storleken på texten. Detta är bara möjligt om du innan har förstorat texten.

Menyn innehåller följande:

Arkiv
  Arkiv Skriv ut ram

    Skriv ut den aktuella sidan.

  &Ctrl;W Arkiv Stäng

    Stäng och avsluta &khelpcenter;

Redigera
  &Ctrl;A Redigera Markera alla

    Markera all text i aktuell avdelning.

  &Ctrl;F Redigera Sök

    Sök på aktuell sida.

Visa
  Visa Visa dokumentets källa

    Visar HTML-källan från aktuell sida.

  Visa Ange kodning

    Ändrar teckenöversättningen för aktuell sida. I normala fall behöver man inte ändra från Auto men om du får problem med något språk så kan du prova att ändra här.

## Tack till och licens

&khelpcenter;

Ursprungligen utvecklad av by Matthias Elter me@kde.org

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

&underFDL; &underGPL;