<para>System pomocy &kde; jest zaprojektowany w celu łatwego udostępniania Uniksowych systemów pomocy (<application>man</application> i <application>info</application>) oraz własnej dokumentacji &kde; (&XML;). </para>
<para>Wszystkie podstawowe programy &kde; są w pełni udokumentowane dzięki wysiłkom Zespołu dokumentacyjnego. Chętnych do pomocy prosimy o list do koordynatora Zespołu dokumentacyjnego, Lauri Watts pod adresem <email>lauri@kde.org</email> z prośbą o informacje. Nie jest wymagane doświadczenie. Wystarcza entuzjazm i cierpliwość. </para>
<para>Jeśli ktoś chciałby pomóc przetłumaczyć dokumentację &kde; na swój rodzimy język, to koordynator tłumaczeń Thomas Diehl (<email>thd@kde.org</email>) zaprasza do współpracy. Więcej informacji, dotyczących w szczególności koordynatorów poszczególnych zespołów językowych, można znaleźć na stronie <ulink url="http://i18n.kde.org"> dotyczącej lokalizacji</ulink>, a także w rozdziale <link linkend="contact">Kontakty</link> tego dokumentu. </para>
<para>&khelpcenter-mianownik; jest nieodłączną częścią podstawowej instalacji &kde; i jest instalowane z każdą kopią &kde;. Można go znaleźć w pakiecie tdebase, który powinien być w systemie operacyjnym lub jest dostępny z &kde-ftp;. </para>
<para>&khelpcenter-mianownik; można wywołać na kilka sposobów: </para>
<variablelist>
<varlistentry>
<term>Z menu <guimenu>Pomoc</guimenu></term>
<listitem>
<para>Prawdopodobnie najczęściej stanie się to z poziomu programu. Wybieramy <menuchoice><guimenu>Pomoc</guimenu> <guimenuitem>Podręcznik programu</guimenuitem></menuchoice>, aby otworzyć plik pomocy programu na stronie spisu treści. </para>
<para>Wybieramy ikonę <guiicon>K</guiicon> na panelu i z menu wybieramy <guimenuitem>Pomoc</guimenuitem>, aby otworzyć &khelpcenter-biernik; na domyślnej stronie powitalnej. </para>
<para>Uruchomić &khelpcenter-biernik; można także podając &URL; wskazujący na plik pomocy. Dodane zostały również adresy &URL; do stron <command>info</command> (hipertekstowy podręcznik GNU) oraz <command>man</command> (podręcznik systemowy). Robi się to następująco: </para>
<para>Interfejs &khelpcenter-dopelniacz; składa się z dwóch części. </para>
<para>Opis paska narzędzi i paska menu podano w <xref linkend="menu-and-toolbar-ref"/>. </para>
<para>Dokumenty zawierają własne narzędzia nawigacyjne, pozwalające poruszać się po dokumencie albo sekwencyjnie, używając dowiązań <guilabel>Dalej</guilabel>, <guilabel>Wstecz</guilabel> i <guilabel>Strona początkowa</guilabel>, albo też w mniej uporządkowany sposób, korzystając z odnośników. </para>
<para>Odnośniki mogą przenieść użytkownika do innych częsci tego samego dokumentu lub do innego dokumentu. Można używać znajdujących się na pasku narzędzi ikon <guiicon>Wstecz</guiicon> (strzałka wskazująca w lewo) lub <guiicon>Do przodu</guiicon> (strzałka wskazująca w prawo) do poruszania się po tych częściach dokumentu, które były oglądane w czasie aktualnej sesji. </para>
<para>W dwóch częściach wyświetlane są: po lewej stronie spis treści systemu pomocy, po prawej zaś stronie sam plik pomocy. </para>
<para>W &khelpcenter-miejscownik; <guilabel>Spis treści</guilabel> 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. </para>
<para><guilabel>Spis treści</guilabel> ma dwie zakładki, z których jedna zawiera <link linkend="contents-menu">menu</link> całej znanej informacji systemu &khelpcenter-mianownik;, druga zaś zakładka zawiera <link linkend="kde-glossary">słowniczek terminów</link> stosowanych w &kde;. </para>
<para>Podręcznik użytkownika &kde; jest szczegółowym opisem &kde; dotyczącym: instalowania, konfiguracji, własnych ustawień użytkownika i samego użytkowania. </para>
<para>Dokumentacja programów &kde;. Wszystkie programy &kde; mają dokumentację w formacie &XML;, który jest zamieniany na <acronym>HTML</acronym> na czas wyświetlania. W tej części wymienione są wszystkie programy &kde; z krótkim opisem i odnośnikiem do pełnej dokumentacji. </para>
<para>Programy są wyświetlane w strukturze drzewa, które jest repliką struktury menu <guimenu>K</guimenu>, co ułatwia znalezienie szukanego programu. </para>
<para>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. </para>
<para>Dokumentacja w formacie TeXinfo jest używana przez wiele programów &GNU;, w tym <command>gcc</command> (kompilator C/C++), <command>emacs</command> i wiele innych. </para>
<para>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ą <quote>RTFM</quote>, najczęściej sugerują, żeby zajrzeć do stron podręcznika systemowego.</para>
<para>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.</para>
<para>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.</para>
<para>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.</para>
<title>Nawigacja po stronach <application>Info</application></title>
<para>Dokumenty informacyjne są zorganizowane hierarchicznie, a każda strona nazywana jest węzłem. Wszystkie dokumenty informacyjne maja węzeł <guilabel>Początek strony</guilabel>, czyli stronę początkową. Do <guilabel>początku strony</guilabel> dokumentu informacyjnego można wrócić naciskając <guilabel>Początek strony</guilabel>.</para>
<para><guibutton>Wstecz</guibutton> i <guibutton>Dalej</guibutton> są używane do przemieszczenia się o jedną stronę wstecz lub dalej na bieżącym poziomie hierarchii.</para>
<para>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 <guibutton>Do góry</guibutton>.</para>
<para>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.</para>
<para>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;. </para>
<para>W panelu po lewej stronie zobaczymy drzewo z dwoma gałęziami: <guilabel>Alfabetycznie</guilabel> lub <guilabel>Według tematu</guilabel>. Obie gałęzie zawierają te same elementy, tylko w odmienny sposób ułożone, co pozwala szybko znaleźć poszukiwany zapis. </para>
<para>&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. </para>
<para>Zmienia kodowanie bieżącej strony. Zwykle, domyślne ustawienie <guimenuitem>Rozpoznawanie automatyczne</guimenuitem> 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. </para>
<para>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.</para>
<para>U góry menu <guimenu>Przejdź</guimenu> znajduje się lista kilku ostatnio przeglądanych stron. Wybierając pozycję z tej listy, można przenieść się wprost do tej strony.</para>