# Manualul &khelpcenter;

## Sistemul de ajutor &kde;

Sistemul de ajutor &kde; este proiectat să facă accesarea sistemelor de ajutor &UNIX; clasice (man şi info), la fel de simplă ca utilizarea sistemului de documentaţie nativ &kde; (&XML;).

Toate aplicaţiile &kde; de bază vin cu documentaţia aferentă, mulţumită Echipei de Documentare. Dacă doriţi să daţi o mînă de ajutor, pentru mai multe informaţii vă rugăm să-i scrieţi coordonatorului Echipei de Documentare, Lauri Watts, la lauri@kde.org. Nu este necesară experienţă, ci numai entuziasm şi răbdare.

Dacă doriţi să ajutaţi la traducerea documentaţiei &kde; în limba dumneavoastră, coordinatorul traducerilor este Thomas Diehl, thd@kde.org, care va aprecia de asemenea acest efort. În secţiunea Contact a acestui document veţi găsi mai multe informaţii, iar pe site-ul Internationalizării &kde;, inclusiv coordinatorii echipelor de traducere a fiecărei limbi.

### Instalare

&khelpcenter; este parte integrală a instalării de bază a &kde;, şi vine cu fiecare copie a mediului &kde;. El poate fi găsit în pachetul kdebase şi este disponibil la &kde-ftp;.

## Obţinerea de ajutor

&khelpcenter; poate fi executat în diferite moduri:

Din meniul Ajutor

- Cel mai adesea va fi probabil dintr-o aplicaţie. Alegeţi Ajutor Cuprins pentru a deschide fişierul de ajutor al aplicaţiei la pagina cu cuprinsul.

Din meniul K

- Alegeţi iconiţa K mare din panou şi selectaţi Ajutor pentru a deschide &khelpcenter; la pagina de întîmpinare implicită.

Din panou

- Implicit, panoul &kicker; conţine o iconiţă pentru execuţia &khelpcenter;. La fel ca mai sus, este afişată pagina de întîmpinare.

Din linia de comandă

- &khelpcenter; poate fi pornit utilizînd un &URL; pentru a afişa un fişier. Au fost adăugate &URL;-uri şi pentru paginile `info` şi `man`. Le puteţi utiliza astfel:

  Un fişier de ajutor de aplicaţie

- `khelpcenter` `help:/`kedit``

  Deschide fişierul de ajutor &kedit; la cuprins.

Un &URL; local

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

O pagină de manual

- `khelpcenter` `man:/`strcpy``

O pagină INFO

- `khelpcenter` `info:/`gcc``

Execuţia `khelpcenter` fără parametrii determină afişarea paginii de întîmpinare.

## Interfaţa &khelpcenter;

Interfaţa &khelpcenter; este formată din două panouri.

Meniurile şi de bara de unelte sînt explicate detaliat în menu-and-toolbar-ref.

Documentele pot conţine propriile lor unelte de navigare ce vă permit să vă deplasaţi fie secvenţial, utilizînd legăturile Înainte, Înapoi şi Acasă, fie într-un mod mai puţin structurat folosind hiperlegăturile.

Legăturile vă pot tranporta în părţi diferite ale aceluiaşi document sau într-un document diferit. Puteţi utiliza iconiţele Înapoi (săgeata stînga) sau Înainte (săgeata dreapta) din bara de unelte pentru a vă deplasa prin documentele vizitate în această sesiune.

Cele două paneluri afişează cuprinsul sistemului de ajutor şi fişierele de ajutor propriu-zise, în stînga şi respectiv în dreapta.

### Panoul Cuprinsului

Panoul Cuprins din &khelpcenter; este afişat în partea stîngă a ferestrei. Aşa cum intuiţi, puteţi muta bara despărţitoare pentru a citi confortabil oricare din cele două paneluri.

Panoul Cuprins este la rîndul lui împărţit în două subferestre, una conţinînd un menu care arată informaţiile de ajutor cunoscute de către &khelpcenter;, iar cealaltă glosarul de termeni &kde;.

#### Meniul Cuprinsului

Cuprinsul conţine următorii itemi impliciţi:

Introducere

- Bine aţi venit în &kde; - o introducere în Mediul Grafic K.

Introducere în &kde;

- Ghidul de iniţiere rapidă în &kde;. Conţine un tur al interfeţei &kde;, informaţii de ajutor specifice şi sfaturi care vă arată cum să lucraţi în mod inteligent cu &kde;.

Manualul utilizatorului &kde;

- Manualul utilizatorului &kde; este o explorare în detaliu ce include instalarea, configurarea, personalizarea şi utilizarea lui.

Manualele aplicaţiilor

- Documentaţia nativă a aplicaţiilor &kde;. Toate aceste aplicaţii au documentaţia în format &XML;, care este convertită în HTML atunci cînd o citiţi. Această secţiune listează toate aplicaţiile &kde; cu o scurtă descriere şi o legătură către documentaţia completă.

  Aplicaţiile sînt afişate într-o structură arborescentă care aminteşte de structura implicită a meniului K, ceea ce uşurează găsirea aplicaţiei căutate.

Pagini de manuale &UNIX;

- Paginile de manual &UNIX; reprezintă formatul tradiţional de documentaţie de pe sistemele &UNIX;. Majoritatea programelor din sistemul dumneavoastră au o pagină de manual. În plus, există pagini de manual şi pentru funcţiile de programare şi formatul fişierelor de configurare ale sistemului.

Răsforire pagini Info

- Documentaţia TeXinfo este utilizată de foarte multe aplicaţii &GNU; printre care `gcc` (compilatorul de C/C++), `emacs` şi multe altele.

Tutoriale

- Tutoriale scurte, informaţionale sau orientate pe rezolvarea unei operaţii.

R.I.F. &kde;

- Răspunsuri la Întrebări Frecvente (R.I.F.) - întrebări despre &kde; puse frecvent şi răspunsurile la ele.

&kde; pe Internet

- Legături către &kde; pe Internet, atît site-ul oficial &kde;, cît şi alte site-uri utile.

Informaţii de contact

- Informaţii despre modalitatea de contactare a programatorilor &kde; şi subscrierea la listele de discuţii &kde;.

Ajutorarea &kde;

- Cum să ajutaţi şi cum să vă implicaţi.

### Secţiunile Man şi Info

Paginile de manual reprezintă documetaţia standard &UNIX; şi este utilizată de zeci de ani pe acest tip de sisteme de operare. Ele sînt extrem de complete şi sînt cel mai bun loc unde să obţineţi informaţii despre cele mai multe din comenziile şi aplicaţiile &UNIX;. Cînd cineva se exprimă cu acronimul RTFM, documentul la care se referă este adesea o pagină de manual &UNIX;.

Paginile de manual nu sînt perfecte. Ele tind să fie foarte amănunţite, dar şi foarte tehnice, fiind scrise adeseori de programatori pentru alţi programatori. În anumite cazuri acest lucru le face neprietenoase, dacă nu chiar imposibil de înţeles pentru utilizatorii obişnuiţi. Cu toate acestea ele sînt cea mai bună sursă de informaţii solide pentru cele mai multe din aplicaţiile de linie de comandă şi, adeseori, chiar şi unica sursă.

Dacă v-aţi întrebat vreodată ce reprezintă numărul pe care îl folosesc cei care scriu man(1), trebuie să ştiţi că acesta este secţiunea în care se află pagina de manual. Puteţi observa că &khelpcenter; utilizează numerele pentru a împărţi cantitatea foarte mare de pagini de manual după secţiunea în care se află. În acest mod vă este mult mai uşor să navigaţi căutînd pagina de manual care vă interesează.

De asemenea vă stau la dispoziţia paginile Info, care intenţionează să înlocuiască sistemul de pagini de manual. Responsabilii unor anumite aplicaţii nu mai lucrează la actualizarea paginilor de manual &UNIX;.Astfel, dacă există în acelaşi timp o pagină de manual şi una Info, este foarte probabil ca cea Info să fie mai recentă. Cele mai multe dintre aplicaţii au ori pe una ori pe cealaltă. Dacă aplicaţia pentru care căutaţi ajutor este un utilitar &GNU;, este mai mult ca sigur că veţi găsi o pagină Info, şi nu o pagină de manual &UNIX;.

#### Navigarea prin paginile Info

Documentele Info sînt aranjate ierarhic, unde fiecare pagină se numeşte nod. Toate acest documente au un nod Top, adică pagina de întîmpinare. Oricînd vă puteţi întoarce în pagina Top a unui document Info dacă daţi clic pe Top.

Prev şi Next sînt utilizate la deplasarea către pagina precedentă şi respectiv următoarea pe nivelul curent din ierarhie.

Dacă daţi clic pe un item de meniu dintr-un document, veţi ajunge pe un nivel mai jos în ierarhie. Vă puteţi deplasa la un nivel superior dacă apăsaţi pe Sus.

Man este tratat similar cu Info, unde indexul secţiunii este nodul "Top", iar fiecare pagină de manual este poziţionată cu un nivel mai jos. Manualele &UNIX; sînt structurate ca o singură pagină.

### Glosarul &kde;

Glosarul reprezintă un punct de referinţă rapid unde puteţi căuta definiţii de cuvinte care nu vă sînt familiare. Domeniul variază de la termeni specifici aplicaţiilor şi tehnologiilor &kde; pînă la cei specifici mediului de lucru &UNIX;.

În panoul din stînga puteţi vedea o structură arborescentă cu două ramuri: Alfabetic sau După subiect. Ambele conţin aceleaşi înregistrări, dar sortate diferit pentru a vă uşura găsirea termenului căutat.

Navigaţi în arborele din stînga şi itemii pe care îi selectaţi vor fi afişaţi în partea dreaptă.

### Meniurile şi bara de unelte

&khelpcenter; are o interfaţă minimală pentru a vă permite să vă concenţraţi pe obţinerea de ajutor, în loc să învăţaţi cum să-l utilizaţi.

Iconiţele disponibile în bara de unelte sînt următoarele:

### Iconiţele barei de unelte

Înapoi

- Vă aduce în pagina pe care aţi citit-o mai înainte.

Înainte

- Merge înainte o pagină. Această iconiţă este activă numai dacă aţi folosit deja iconiţa Înapoi.

Tipăreşte

- Tipăreşte conţinutul paginii curente.

Caută

- Caută un cuvînt sau cuvinte în pagina curentă.

Măreşte fontul

- Creşte mărimea textului în panoul de vizualizare.

Micşorează fontul

- Scade mărimea textului în panoul de vizualizare. Această iconiţă este activată numai dacă aţi mărit textul mai înainte.

Meniul conţine următoarele înregistrări:

Fişier

- Fişier Tipăreşte...

- Tipăreşte conţinutul paginii curente.

&Ctrl;Q Fişier Termină

- Închide şi iese din &khelpcenter;

Editare

- &Ctrl;A Editare Selectează tot

- Selectează tot textul din pagina curentă.

&Ctrl;F Editare Caută...

- Caută un cuvînt sau cuvinte în pagina curentă.

Vizualizare

- Vizualizare Afişează sursa documentului

- Afişează codul sursă HTML al paginii pe care o vedeţi în acel moment.

Vizualizare Setează codarea

- Schimbă codarea paginii curente. În mod normal setare implicită Auto ar trebui să fie suficientă, dar dacă aveţi probleme cu citirea unor pagini scrise în limbaje altele decît engleza, s-ar putea să fie necesar să alegeţi setarea corespunzătoare.

Du-te Înapoi

- Vă întoarce înapoi în pagina precedentă pe care tocmai aţi văzut-o.

Du-te Înainte

- Dacă mai devreme v-aţi deplasat înapoi cu iconiţa "Înapoi" sau din meniu, puteţi să mergeţi din nou înapoi cu acest item de meniu.

Du-te ...

- În partea de jos a meniului Du-te puteţi vedea o listă istorică a ultimelor pagini pe care le-aţi vizitat. Dacă selectaţi un item din istoric veţi fi transportat direct la acea pagină.

## Autori şi licenţe

&khelpcenter;

Dezvoltat pentru prima oară de &Matthias.Elter; &Matthias.Elter.mail;

Responsabilul actual este &Cornelius.Schumacher; &Cornelius.Schumacher.mail;

&underFDL; &underGPL;