2009-05-09
4.00.00

# Podręcznik użytkownika systemu pomocy &kde;

## System pomocy &kde;

System pomocy &kde; jest zaprojektowany w celu łatwego udostępniania Uniksowych systemów pomocy (man i info) oraz własnej dokumentacji &kde; (&XML;).

Wszystkie podstawowe programy &kde; są w pełni udokumentowane dziękiwysiłkom Zespołu dokumentacyjnego. Jeśli jesteś zainteresowany wsparciempracy edytorów, zapisz się na listę e-mailową i napisz do zespołu pod adres kde-doc-english@kde.org (w j. angielskim).Doświadczenie niewymagane, tylko entuzjazm i cierpliwość.

Jeśli chciałbyś (chciałabyś) pomóc przetłumaczyć dokumentację &kde; na swój rodzimy język, Polski Zespół Tłumaczy serdecznie zaprasza do współpracy. Więcej informacji na naszej stronie.

### Instalacja

&khelpcenter-mianownik; jest nieodłączną częścią podstawowej instalacji &kde; i jest instalowane z każdą kopią tego środowiska. Można je znaleźć w pakiecie kdebase-runtime, który powinien być już w systemie operacyjnym lub jest dostępny na &kde-ftp;.

## Przywoływanie pomocy

&khelpcenter-mianownik; można wywołać na kilka sposobów:

Z menu Pomoc

  Prawdopodobnie najczęściej stanie się to z poziomu programu. Wybierz F1 Pomoc Podręcznik programu, aby otworzyć plik pomocy programu.

Z menu Uruchamianie programów

  Kliknij ikonę K na panelu i z menu wybierz zakładkę Programy, a następnie Pomoc, aby otworzyć &khelpcenter-biernik; na domyślnej stronie powitalnej.

Z linii poleceń

  Uruchomić &khelpcenter-biernik; można także podając &URL; wskazujący na plik pomocy. Dodane zostały również adresy &URL; do stron `info` (hipertekstowy podręcznik GNU) oraz `man` (podręcznik systemowy). Robi się to następująco:

  Plik pomocy programu

    `khelpcenter` `help:/kedit`

    Otwiera plik pomocy &kedit; na stronie spisu treści.

  Lokalny &URL;

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

  Strona podręcznika systemowego man

    `khelpcenter` `man:/strcpy`

  Strona info - hipertekstowego podręcznika GNU

    `khelpcenter` `info:/gcc`

  Uruchomienie `khelpcenter` bez parametrów spowoduje otwarcie pliku pomocy na domyślnej stronie powitalnej.

## Interfejs &khelpcenter-dopelniacz;

Interfejs &khelpcenter-dopelniacz; składa się z dwóch części.

Opis paska narzędzi i paska menu podano w .

Dokumenty zawierają własne narzędzia nawigacyjne, pozwalające poruszać się po dokumencie albo sekwencyjnie, używając dowiązań Dalej, Wstecz i Strona początkowa, albo też w mniej uporządkowany sposób, korzystając z odnośników.

Odnośniki mogą przenieść użytkownika do innych części tego samego dokumentu lub do innego dokumentu. Można używać znajdujących się na pasku narzędzi ikon Wstecz (strzałka wskazująca w lewo) lub Do przodu (strzałka wskazująca w prawo) do poruszania się po tych częściach dokumentu, które były oglądane w czasie aktualnej sesji.

W dwóch częściach wyświetlane są: po lewej stronie spis treści systemu pomocy, po prawej zaś stronie sam plik pomocy.

### Część Spis treści

W &khelpcenter-miejscownik; Spis treści jest wyświetlany po lewej stronie okna. Jak można się było spodziewać, słupek oddzielający części można przesuwać tak, aby wygodnie czytać zawartość każdej z nich.

Spis treści ma dwie zakładki, z których jedna zawiera menu całej znanej informacji systemu &khelpcenter-mianownik;, druga zaś zakładka zawiera słowniczek terminów stosowanych w &kde;.

#### Menu Spisu treści

Spis treści obejmuje następujące elementy:

Witamy w &kde;

  Zawiera odnośniki do Ogólnych informacji na temat &kde;, jak również informacje o możliwościach maksymalnego wykorzystania &kde;.

Podręcznik użytkownika &kde;

  Podręcznik użytkownika &kde; jest szczegółowym opisem &kde; dotyczącym: instalowania, konfiguracji, własnych ustawień użytkownika i samego użytkowania.

Podręczniki programów

  Dokumentacja programów &kde;. Wszystkie programy &kde; mają dokumentację w formacie &XML;, który jest zamieniany na HTML na czas wyświetlania. W tej części wymienione są wszystkie programy &kde; z krótkim opisem i odnośnikiem do pełnej dokumentacji.

  Programy są wyświetlane w strukturze drzewa, które jest repliką struktury menu K, co ułatwia znalezienie szukanego programu.

Moduły centrum sterowania

  Lista odnośników do pomocy dla różnych modułów programu &systemsettings-mianownik;.

Wtyczki wejścia/wyjścia

  Lista odnośników do pomocy dla różnych wtyczek protokołu (KIO).

Podręcznik Plazmy

  Podręcznik &plasma-dopelniacz; zawiera dokumentację najbardziej widocznej części &kde;, pulpitu.

Samouczki

  Krótkie samouczki zadaniowe lub informacyjne.

Podręcznik systemu &UNIX;

  Strony man są w systemie &UNIX; tradycyjnym formatem dokumentacji programów. Większość programów w Twoim systemie &UNIX; ma zapewne swoje strony w formacie podręcznika systemowego. Istnieją także strony podręcznika systemowego dotyczące funkcji programowania oraz formatów plików.

Przeglądanie stron informacyjnych

  Dokumentacja w formacie TeXinfo jest używana przez wiele programów &GNU;, w tym `gcc` (kompilator C/C++), `emacs` i wiele innych.

Często zadawane pytania &kde;

  Często zadawane pytania dotyczące &kde; wraz z odpowiedziami.

Informacje kontaktowe

  Informacje dotyczące tego, jak się skontaktować z osobami rozwijającymi &kde; oraz jak się zapisać na listy dyskusyjne &kde;.

&kde; w sieci

  Odnośniki do &kde;, zarówno do oficjalnych stron &kde;, jak i do innych użytecznych stron.

Wspomaganie &kde;

  Jak pomóc i jak się zaangażować.

### Rozdziały dokumentacji man oraz info

Strony podręcznika systemowego są stronami podręcznika systemu &UNIX;, który jest od wielu lat używany w wielu systemach operacyjnych. Podręcznik systemowy jest napisany bardzo sumiennie i jest najlepszym miejscem do umieszczania informacji dotyczących większości poleceń i programów systemu &UNIX;. Gdy ludzie mówią RTFM, najczęściej sugerują, żeby zajrzeć do stron podręcznika systemowego.

Podręcznik systemowy nie jest doskonały. Autorzy starają się dokładnie omawiać zagadnienia, ale także zbyt technicznie; często strony pisane są przez programistów i dla programistów. W niektórych przypadkach czyni to strony trudnymi do zrozumienia, jeśli nie nawet całkowicie niezrozumiałymi. Pomimo tego, podręcznik systemowy jest najlepszym źródłem konkretnej informacji o większości programów obsługiwanych z wiersza poleceń i to bardzo często źródłem jedynym.

Jeśli zastanawiałeś się co oznaczają liczby w napisach takich jak man(1), to liczby te oznaczają rozdział podręcznika, w którym opisany jest dany element. Zauważysz, że &khelpcenter-mianownik; stosuje te liczby do dzielenia wielu stron podręcznika systemowego na sekcje, co czyni łatwiejszym znalezienie poszukiwanej informacji.

Dostępne są także strony Info, których przeznaczeniem było zastąpienie stron podręcznika systemowego. Opiekunowie niektórych programów nie uaktualniają stron podręcznika systemowego, dlatego jeśli program ma zarówno strony w podręczniku systemowym, jak i strony informacyjne, to strony informacyjne są prawdopodobnie bardziej aktualne. Jeżeli program, do którego szukasz pomocy, jest programem narzędziowym na licencji &GNU;, to bardziej prawdopodobne jest znalezienie stron informacyjnych niż stron w podręczniku systemowym.

#### Nawigacja po stronach Info

Dokumenty informacyjne są zorganizowane hierarchicznie, a każda strona nazywana jest węzłem. Wszystkie dokumenty informacyjne maja węzeł Początek strony, czyli stronę początkową. Do początku strony dokumentu informacyjnego można wrócić naciskając Początek strony.

Wstecz i Dalej są używane do przemieszczenia się o jedną stronę wstecz lub dalej na bieżącym poziomie hierarchii.

Kliknięcie na pozycji menu w dokumencie przenosi nas na niższy poziom hierarchii. Przeniesienie się o poziom wyżej nastąpi po naciśnięciu Do góry.

Podręcznik systemowy jest traktowany jako strony informacyjne, ze spisem treści w charakterze węzła początkowego i pozostałymi stronami leżącymi na niższym poziomie. Pozycje podręcznika systemowego mają tu długość jednej strony.

### Słowniczek &kde;

Słowniczek jest miejscem, w którym można szybko znaleźć definicje nieznanych słów. Zakres słowniczka rozciąga się od specyficznych programów i technologii &kde; do ogólnych terminów związanych z systemem &UNIX;.

W panelu po lewej stronie zobaczymy drzewo z dwoma gałęziami: Alfabetycznie lub Według tematu. Obie gałęzie zawierają te same elementy, tylko w odmienny sposób ułożone, co pozwala szybko znaleźć poszukiwany zapis.

Kiedy przechodzisz w dół drzewa widocznego po lewej stronie, wybrane elementy są wyświetlane po prawej stronie.

### Menu i pasek narzędzi

&khelpcenter-mianownik; ma oszczędny interfejs, co pozwala użytkownikowi po prostu korzystać z plików pomocy, a nie uczyć się skomplikowanej obsługi przeglądarki plików pomocy.

Na pasku narzędzi są dostępne następujące ikony:

#### Ikony paska narzędzi

Spis treści

  Przejdź do strony powitalnej &khelpcenter-mianownik;.

Wstecz

  Przechodzi do poprzednio przeglądanej strony.

Do przodu

  Przechodzi jedną stronę do przodu. Ta ikona uaktywnia się dopiero po użyciu ikony Wstecz.

Drukuj ramkę

  Drukuje zawartość aktualnie przeglądanej strony.

Kopiuj

  Kopiuje tekst do schowka, aby można go było wkleić w innym programie.

Znajdź

  Wyszukuje słowo lub słowa na aktualnie przeglądanej stronie.

Zwiększ wielkość czcionek

  Zwiększa rozmiar tekstu w oknie przeglądarki.

Zmniejsz wielkość czcionek

  Zmniejsza rozmiar tekstu w oknie przeglądarki. Ta ikona jest dostępna dopiero po wcześniejszym zwiększeniu tekstu.

W menu znajdują się następujące pozycje:

Plik
  Plik Drukuj ramkę...

    Drukuje zawartość aktualnie przeglądanej strony.

  &Ctrl;Q Plik Zakończ

    Zamyka &khelpcenter-biernik;

Edycja
  &Ctrl;C Edycja Kopiuj

    Kopiuje zaznaczony tekst do schowka

  &Ctrl;A Edycja Zaznacz wszystko

    Zaznacza cały tekst na bieżącej stronie.

  &Ctrl;F Edycja Znajdź...

    Wyszukuje słowo albo słowa na aktualnie przeglądanej stronie.

Widok
  Widok Ustaw kodowanie

    Zmienia kodowanie bieżącej strony. Zwykle, domyślne ustawienie Rozpoznawanie automatyczne powinno wystarczyć. Jeśli jednak pojawiają się problemy z widokiem stron napisanych w języku innym niż angielski, to z tego menu należy wybrać właściwe kodowanie.

Idź
  Przejdź Wstecz

    Przechodzi do poprzednio oglądanej strony.

  Przejdź Do przodu

    Jeśli wcześniej cofnęliśmy się za pomocą ikony Wstecz lub odpowiedniej pozycji menu, to ta pozycja menu pozwoli przejść z powrotem do przodu.

  Przejdź ...

    U góry menu Przejdź znajduje się lista kilku ostatnio przeglądanych stron. Wybierając pozycję z tej listy, można przenieść się wprost do tej strony.

Ustawienia
  Ustawienia Wyświetlaj pasek narzędzi

    Pokazuje lub ukrywa pasek narzędzi, zawierający ikony na górze okna programu.

  Ustawienia Wyświetlaj pasek stanu

    Pokazuje lub ukrywa pasek stanu, znajdujący się na dole okna programu.

  Ustawienia Konfiguracja czcionek...

    Umożliwia konfigurację kroju czcionek i rozmiarów używanych w &khelpcenter-miejscownik;.

  Ustawienia Tworzenie indeksu wyszukiwania...

    Jeśli twoja dystrybucja obsługuje tę funkcję, możesz zbudować indeks wyrazów do wyszukiwania.

  Ustawienia Konfiguracja skrótów...

    Umożliwia konfigurację skrótów dostępnych w &khelpcenter-miejscownik;.

  Ustawienia Konfiguracja pasków narzędzi...

    Umożliwia konfigurację pasków narzędzi dostępnych w &khelpcenter-miejscownik;.

## Podziękowania i licencje

&khelpcenter-mianownik;

Pierwszy autor: &Matthias.Elter;&Matthias.Elter.mail;

Bieżącym opiekunem projektu jest &Cornelius.Schumacher;&Cornelius.Schumacher.mail;

&underFDL; &underGPL;