2002-02-03 0.08.00 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ęki wysiłkom Zespołu dokumentacyjnego. Chętnych do pomocy prosimy o list do koordynatora Zespołu dokumentacyjnego, Lauri Watts pod adresem lauri@kde.org z prośbą o informacje. Nie jest wymagane doświadczenie. Wystarcza entuzjazm i cierpliwość. Jeśli ktoś chciałby pomóc przetłumaczyć dokumentację &kde; na swój rodzimy język, to koordynator tłumaczeń Thomas Diehl (thd@kde.org) 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 dotyczącej lokalizacji, a także w rozdziale Kontakty tego dokumentu. &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;. &khelpcenter-mianownik; można wywołać na kilka sposobów: Z menu Pomoc Prawdopodobnie najczęściej stanie się to z poziomu programu. Wybieramy Pomoc Podręcznik programu, aby otworzyć plik pomocy programu na stronie spisu treści. Z poziomu menu K Wybieramy ikonę K na panelu i z menu wybieramy Pomoc, aby otworzyć &khelpcenter-biernik; na domyślnej stronie powitalnej. Z panelu Domyślnie panel &kicker; zawiera ikonę otwierającą &khelpcenter-biernik;. I w tym wypadku wyświetlana jest domyślna strona powitalna. 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; 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ęsci 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. 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;. Spis treści obejmuje następujące elementy: Wstęp Witamy w &kde; - wprowadzenie do środowiska &kde;. Wprowadzenie do &kde; Krótkie wprowadzenie do &kde;. Zawiera wycieczkę po interfejsie &kde; oraz wskazówki, jak sprytniej pracować w &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. 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. Samouczki Krótkie samouczki zadaniowe lub informacyjne. Często zadawane pytania &kde; Często zadawane pytania dotyczące &kde; wraz z odpowiedziami. &kde; w sieci Odnośniki do &kde;, zarówno do oficjalnych stron &kde;, jak i do innych użytecznych stron. Informacje kontaktowe Informacje dotyczące tego, jak się skontaktować z osobami rozwijającymi &kde; oraz jak się zapisać na listy dyskusyjne &kde;. Wspomaganie &kde; Jak pomóc i jak się zaangażować. 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. 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 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. &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: 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 Drukuje zawartość aktualnie przeglądanej strony. Znajdź Wyszukuje słowo lub słowa na aktualnie przeglądanej stronie. Zwiększ czcionkę Zwiększa rozmiar tekstu w oknie przeglądarki. Zmniejsz czcionkę 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... Drukuje zawartość aktualnie przeglądanej strony. &Ctrl;Q Plik Zakończ Zamyka &khelpcenter-biernik; Edycja &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 Pokaż źródło dokumentu Pokazuje źródło HTML aktualnie przeglądanej strony. 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. 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. &khelpcenter-mianownik; Pierwszy autor: &Matthias.Elter;&Matthias.Elter.mail; Bieżącym opiekunem projektu jest &Cornelius.Schumacher;&Cornelius.Schumacher.mail; &underFDL; &underGPL;