2002-02-03
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, är översättningskoordinatorn Albert Astals Cid, aacid@kde.org, som också välkomnar all hjälp. Mer information, inklusive samordnarna för översättningen av de olika språken, kan du hitta på Webbplatsen för internationalisering, samt i kontakt-avsnittet i det här dokumentet.

### Installation

Hjälpcentralen är en integrerad del av &kde;:s basinstallation, och installeras med varje kopia av &kde;. Det finns i paketet kdebase, och är tillgängligt på &kde-ftp; eller finns i kdebase-paketet för ditt operativsystem.

## Starta hjälpcentralen

Hjälpcentralen kan startas på flera sätt:

Från menyn Hjälp

  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, på innehållssidan.

Från K-menyn

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

Från panelen

  &kicker; innehåller som standard en ikon för att starta Hjälpcentralen. Välkomstsidan kommer att visas igen.

Från kommandoraden

  Hjälpcentralen kan startas genom att använda en webbadress för att visa en fil. Webbadresser har även lagts till för `info`- och `man`. 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 Hjälpcentralen

Gränssnittet i Hjälpcentralen består av två avdelningar med information.

Verktygsraden och menyerna förklaras närmare i avsnittet .

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, Föregående och Hem, eller att förflytta sig på ett mindre strukturerat sätt med hjälp av länkar.

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 Hjälpcentralen 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 Hjälpcentralen känner till, och en annan som 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 skrivbordsmiljön &kde;.

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 installation, inställningar, anpassning och användning.

Programmanualer

  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. Det här avsnittet 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.

&kde;:s vanliga frågor

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

&kde; på Internet

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

### Man och Info sektioner

Manualsidor är &UNIX; standardmanualsidor, 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 &UNIX;-kommandon och program. När man säger RTFM på engelska, är det ofta dessa manualer man hänvisar till.

Manualsidor är inte helt perfekta. De är mycket detaljerade men också mycket tekniska, oftast skriva av utvecklare för utvecklare. I några fall gör detta dem något ogästvänliga om inte omöjliga för flera att förstå. De är i alla fall den bästa källan med helgjuten information om de flesta kommandoradsprogram, och mycket ofta den enda källan.

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. Hjälpcentralen 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, dvs. 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.

Hjälpcentralen 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

Tillbaka

  Gå till föregående sida som du tittade på.

Framåt

  Gå framåt en sida. Den här ikonen är bara aktiv om du redan har använt ikonen Tillbaka.

Skriv ut ram

  Skriv ut den aktuella sidan.

Sök

  Sök ett eller flera ord på sida som för närvarande visas.

Ö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;Q Arkiv Avsluta

    Stäng och avsluta Hjälpcentralen

Redigera
  &Ctrl;A Redigera Markera alla

    Markera all text i aktuell avdelning.

  &Ctrl;F Redigera Sök

    Sök ett eller flera ord på sida som för närvarande visas.

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.

Gå Tillbaka

  Gå tillbaka till föregående sida som du tittade på.

Gå Framåt

  Om du tidigare har gått tillbaka med ikonen eller menyvalet Tillbaka, kan du ta dig framåt igen med det här menyvalet.

Gå ...

  Längst ner i menyn Gå, hittar du en lista med historik över några av de senaste sidorna som du har tittat på. Att välja en tar dig direkt tillbaka till den sidan.

## Tack till och licens

Hjälpcentralen

Ursprungligen utvecklad av &Matthias.Elter; &Matthias.Elter.mail;

Nuvarande utvecklare är &Cornelius.Schumacher; &Cornelius.Schumacher.mail;

&underFDL; &underGPL;