>&kde; definiuje hierarchię systemu plików, która jest używana zarówno przez samo środowisko &kde;, jak i przez programy &kde;. Ogólnie rzecz biorąc, &kde; przechowuje wszystkie swoje pliki w drzewie katalogów o ustalonej strukturze. </para>
<para
>Domyślnie, &kde; używa dwóch drzew katalogów:</para>
<itemizedlist>
<listitem
><para
>Jednego na poziomie systemowym (na przykład <filename class="directory"
>/opt/kde3</filename
>).</para
></listitem>
<listitem
><para
>Drugiego na poziomie użytkownika, w katalogu domowym użytkownika (zwykle <filename class="directory"
>. (Specyficzne dla &SuSE;, inne dystrybucje mogą używać <filename class="directory"
>/usr</filename
> lub <filename class="directory"
>/usr/kde3</filename
>)</para
></listitem>
<listitem
><para
><filename class="directory"
>/etc/opt/kde3</filename
>. (Zostało to dodane przez &SuSE;).</para
></listitem>
</itemizedlist>
<para
>Jeśli posiadasz zainstalowane narzędzie KIOSK Admin w wersji 0.7, lub późniejszej, możesz sprawdzić, które drzewa katalogów są wykorzystywane, komendą: <userinput
>&kde; oraz programy &kde; szukają plików przeszukując wszystkie drzewa katalogów &kde;. Sprawdzanie następuje w kolejności według pierwszeństwa. Jeśli plik znajduje się w wielu drzewach, pierwszeństwo ma ostatnie drzewo. Zwykle drzewo położone w katalogu domowym użytkownika posiada najwyższe pierwszeństwo. Jest to także drzewo, do którego są zapisywane zmiany.</para>
>Sytuacja wygląda nieco inaczej, jeśli chodzi o pliki konfiguracyjne. W momencie wystąpienia wielu plików konfiguracyjnych o tej samej nazwie w drzewach, ich zawartość zostaje połączona. Pierwszeństwo drzewa odgrywa tu rolę. Kiedy dwa pliki definiują ten sam klucz konfiguracji, plik o wyższym pierwszeństwie określa użytą dla niego wartość.</para>
<informalexample
><para
>Na przykład, jeśli istnieją następujące dwa pliki, z tą zawartością:</para>
>Teraz mamy możliwość przypisania profilu na podstawie nazwy użytkownika, lub grupy uniksowej, do której on należy.</para
>
<para
>Aby przypisać profil staff do wszystkich użytkowników, którzy są członkami uniksowej grupy staff_members, dodarj do <filename
>/etc/kde-user-profile</filename
>:</para>
<programlisting
>[General]
groups=staff_members
[Groups]
staff_members=staff
</programlisting>
<para
>Można również przypisać profil pojedynczemu użytkownikowi:</para>
<programlisting
>[Users]
bastian=staff
</programlisting>
</sect1>
<sect1 id="directory-layout-revisited">
<title
>Rozmieszczenie katalogów - powtórka</title>
<para
>Każde drzewo katalogów wykorzystywane przez &kde; posiada ustaloną strukturę katalogów. Jednakże katalogi nieistotne z punktu widzenia danego drzewa, lub po prostu niewykorzystywane, mogą nie zostać dołączone. Na przykład katalogi używane dla plików tymczasowych można zwykle znaleźć w <filename class="directory"
>. Pod koniec sesji programy &kde; zapisują tu swój stan. Nazwy plików składają się z nazwy programu z dołożonym numerem. <command
>ksmserver</command
> zarządzający sesjami przechowuje odniesienia do tych numerów podczas zapisywania sesji w <filename
>ksmserverrc</filename
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/doc/HTML</filename
></term>
<listitem
><para
>Katalog zawierający dokumentację dla programów &kde;. Dokumentacja jest sklasyfikowana zgodnie z językiem i programem, do którego należy. Zwykle mogą tu być znalezione co najmniej dwa pliki: <filename
>index.docbook</filename
>, który zawiera dokumentację w niesformatowanym formacie DocBook i <filename
>index.cache.bz2</filename
>, który zawiera tą samą dokumentację sformatowaną jako &HTML; spakowany <command
>bzip2</command
>. Wersja &HTML; jest wykorzystywana przez &khelpcenter-biernik;. W przypadku braku wersji &HTML; zostanie ona wygenerowana przez &khelpcenter-biernik; z wersji DocBook, ale jest to czasochłonny proces.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/icons</filename
></term>
<listitem
><para
>W tym katalogu są przechowywane ikony. Są one poklasyfikowane wg motywu, wymiarów i kategorii użycia.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/mimelnk</filename
></term>
<listitem
><para
>W tym katalogu,<literal role="extension"
>.desktop</literal
> są przechowywane pliki opisujące typy &MIME;. &kde; używa typów &MIME; do zidentyfikowania typu pliku.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/services</filename
></term>
<listitem
><para
>Ten katalog zawiera pliki <literal role="extension"
>.desktop</literal
> określające usługi. Usługi są jak programy, ale zwykle są uruchamiane przez inne programy zamiast przez użytkownika. Nie pojawiają się one w menu &kde;.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/servicetypes</filename
></term>
<listitem
><para
>Ten katalog zawiera pliki <literal role="extension"
>.desktop</literal
> określające typy usług. Typy usług zwykle reprezentują pewien interfejs programistyczny. Programy i serwisy zawierają w w swoich plikach <literal role="extension"
>
>.desktop</literal
> typy serwisów, które udostępniają.</para
> </listitem
></varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/sounds</filename
></term>
<listitem
><para
>Katalog zawierający pliki dźwiękowe.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/templates</filename
></term>
<listitem
><para
>Ten katalog zawiera szablony do tworzenia plików różnych typów. Szablon składa się z pliku <literal role="extension"
>.desktop</literal
>, który opisuje plik i zawiera odniesienie do pliku w podkatalogu <filename class="directory"
>.source</filename
>. Szablony w tym katalogu pojawiają się w menu <guimenu
>Create New</guimenu
>, dostępnym na pulpicie i w przeglądarce. Kiedy użytkownik wybiera szablon z menu, jego źródło jest kopiowane.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/wallpapers</filename
></term>
<listitem
><para
>Ten katalog zawiera obrazki mogące zostać użyte jako obrazki tła.</para
></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="host-specific-directories">
<title
>Katalogi specyficzne dla komputera</title
>
<para
>Istnieją trzy katalogi specyficzne dla komputera; są one zwykle dowiązane symbolicznie do innych lokalizacji. Jeżeli katalogi jeszcze nie istnieją, następujące dowiązania symboliczne i katalogi zostaną utworzone z użyciem narzędzia <command
> są zapisywalne przez wszystkich użytkowników, istnieje możliwość, że jeden z powyższych katalogów już istnieje, ale jego właścicielem jest inny użytkownik. W takim wypadku narzędzie <command
>lnusertemp</command
> stworzy nowy katalog z alternatywną nazwą i utworzy dowiązanie właśnie do niego.</para>
</sect1>
<sect1 id="configuration-files">
<title
>Pliki konfiguracyjne</title
> <para
>&kde; używa prostego, tekstowo-zorientowanego formatu plików dla wszystkich swoich plików konfiguracyjnych. Składa się on z par klucz-wartość, które są umieszczone w grupach. Wszystkie pliki konfiguracyjne &kde; używają kodowania <acronym
>UTF</acronym
>-8 dla tekstu spoza zakresu <acronym
>ASCII</acronym
>.</para>
<para
>Początek grupy jest oznaczony nazwą grupy umieszczoną w nawiasach kwadratowych. Wszystkie kolejne wpisy klucz-wartość należą do tej grupy. Koniec grupy ma miejsce po napotkaniu początku innej grupy, lub po osiągnięciu końca pliku. Wpisy na początku pliku, nie poprzedzone nazwą grupy, należą do grupy domyślnej.</para>
<informalexample
><para
>Następujący przykład pokazuje plik konfiguracyjny składający się z dwóch grup. Pierwsza grupa zawiera klucze <varname
>LargeCursor</varname
> i <varname
>SingleClick</varname
>, a druga grupa <varname
>Pokazuj ukryte pliki</varname
> i <varname
>Sortuj wg</varname
>:</para>
<programlisting
>[KDE]
LargeCursor=false
SingleClick=true
</programlisting>
<programlisting
>[KFileDialog Settings]
Pokazuj ukryte pliki=false
Sortuj wg=Name
</programlisting>
</informalexample>
<para
>Na wpisy (pozycje) w grupie składają się klucze i wartości oddzielone znakiem równości. Klucz może zawierać spacje i mogą za nim być umieszczone opcje w nawiasach kwadratowych. Część wpisu po znaku równości jest wartością wpisu. Wszystkie białe znaki otaczające znak równości są ignorowane, tak jak kończące wpis białe znaki. Bardziej treściwie, format ma postać:</para>
<programlisting
><replaceable
>pozycja</replaceable
>=<replaceable
>wartość</replaceable
>
</programlisting>
<para
>Jeśli oczekuje się, że wartość będzie zawierać na początku, lub na końcu spację, może to zostać osiągnięte przez użycie znaku odwrotnego ukośnika (backslash) z następującą po nim literą <quote
>s</quote
>.</para>
<para
>Istnieje wiele innych kodów z odwróconym ukośnikiem, oto kompletna lista: <itemizedlist>
<listitem
><para
><token
>\s</token
> może być użyty jako spacja</para>
</listitem>
<listitem
><para
><token
>\t</token
> może być użyty do dołączenia znaku tabulacji</para>
</listitem>
<listitem
><para
><token
>\r</token
> dla znaku powrotu karetki</para>
</listitem>
<listitem
><para
><token
>\n</token
> dla znaku wysunięcia linii (nowa linia)</para>
</listitem>
<listitem
><para
><token
>\\</token
> do dołączenia samego znaku odwróconego ukośnika</para>
</listitem>
</itemizedlist
></para>
<informalexample
><para
>W następującym przykładzie wartość wpisu <varname
>Nagłówek</varname
> rozpoczyna się dwoma spacjami, podczas gdy wpis <varname
>Opis</varname
> zawiera trzy linie tekstu. Znaki nowej linii w notacji z odwrotnym ukośnikiem są używane do oddzielenia odrębnych linii.</para>
<programlisting
>[Preview Image]
Nagłówek=\s My Caption
Opis=This is\na very long\ndescription.
</programlisting>
</informalexample>
<para
>Puste linie w plikach konfiguracyjnych są ignorowane, podobnie jak linie rozpoczynające się znakiem <quote
>#</quote
>. Znak ten może być używany dla dodania komentarzy do plików konfiguracyjnych. Trzeba zauważyć, że podczas uaktualniania przez program &kde; plików konfiguracyjnych komentarze <emphasis
>nie są</emphasis
> zachowywane.</para>
<para
>W podkatalogach <filename class="directory"
>share/config</filename
> różnych drzew katalogów &kde; może istnieć wiele plików konfiguracyjnych o tej samej nazwie. W takim wypadku informacja z nich wszystkich jest łączona klucz po kluczu. Jeśli taki sam klucz w pewnej grupie jest zdefiniowany w więcej, niż jednym miejscu, to zostanie użyta wartość przeczytana z drzewa katalogów z najwyższym pierwszeństwem. Pliki konfiguracyjne spod <filename class="directory"
>Aby zabezpieczyć użytkowników przed nadpisaniem domyślnych ustawień, mogą one zostać oznaczone jako niezmienne. Może to być określone indywidualnie, dla grupy, lub dla pliku. Pojedynczy wpis może zostać zablokowany przez dodanie <userinput
>[$i]</userinput
> za kluczem, np.: <programlisting
>Color[$i]=blue
</programlisting>
</para>
<para
>Grupa wpisów może zostać zablokowana przez umieszczenie <userinput
>[$i]</userinput
> za nazwą grupy, np.: <programlisting
>[MyGroup][$i]
</programlisting>
</para>
<para
>Aby zabezpieczyć cały plik, powinien on rozpoczynać się <userinput
> może zostać użyte dla zapewnienia bardziej dynamicznych wartości domyślnych. Z rozszerzaniem wartość klucza konfiguracyjnego może być skonstruowana z wartości zmiennej środowiskowej, lub z wyjścia polecenia powłoki. Dla włączenia rozszerzania w powłoce dla wpisu w konfiguracji, po kluczu musi wystąpić <token
>[$e]</token
>. Normalnie rozszerzona forma zostaje zapisana do pliku konfiguracji użytkownika po pierwszym użyciu. Aby tego uniknąć, zaleca się zablokować wpis konfiguracji używając <token
>[$ie]</token
>. Użytkownik naturalnie nie ma później możliwości jego zmiany.</para>
<informalexample>
<para
>W następującym przykładzie wartość wpisu <varname
>Host</varname
> jest określona przez wynik działania programu <command
>hostname</command
>. Ustawienie to zostało również zablokowane, żeby upewnić się, że zawsze jest określane dynamicznie.</para>
<para
>Wartość wpisu <varname
>Email</varname
> jest określona przez wypełnienie wartości zmiennych środowiskowych $<envar
>USER</envar
> i $<envar
>HOST</envar
>. Kiedy <systemitem class="username"
>joe</systemitem
> jest zalogowany do <systemitem class="systemname"
>joes_host</systemitem
>, da to w sumie wartość <literal
>joe@joes_host</literal
>. Ustawienie nie zostało zablokowane.</para>
<programlisting
>[Mail Settings]
Host[$ie]=$(hostname)
Email[$e]=${USER}@${HOST}
</programlisting>
</informalexample>
<para
>Większość wpisów konfiguracyjnych może być indeksowana kodem języka. W takim wypadku język, który został wybrany przez użytkownika do użycia na pulpicie, będzie również użyty do odnalezienia wartości klucza. W wypadku wybrania domyślnego języka (angloamerykański), lub kiedy nie ma indeksu odpowiadającego wybranemu językowi, zostanie użyty wpis bez indeksu.</para>
<informalexample>
<para
>W następującym przykładzie wartość wpisu <varname
>Caption</varname
> zależy od języka. Kiedy użytkownik wybierze jako język francuski (kod języka <literal
>fr</literal
>) wartość wpisu będzie równa <quote
>Ma Légende</quote
>. W każdym innym wypadku zostanie użyta wartość <quote
>My Caption</quote
>.</para>
<programlisting
>[Preview Image]
Caption=My Caption
Caption[fr]=Ma Légende
</programlisting>
</informalexample>
<informalexample>
<para
>W tym przykładzie wartość wpisu <varname
>Caption</varname
> zależy od języka. Kiedy użytkownik wybierze jako język francuski (kod języka <literal
>fr</literal
>) wartość wpisu będzie równa <quote
>Ma Légende</quote
>. W każdym innym wypadku zostanie użyta wartość <quote
>My Caption</quote
>.</para>
<programlisting
>[Preview Image]
Caption=My Caption
Caption[fr]=Ma Légende
</programlisting>
</informalexample>
<para
>Ogólnie rzecz biorąc wpisy, które mogą się pojawić w pliku konfiguracyjnym, nie są udokumentowane. Od &kde; 3.2 rozpoczął się proces mający na celu zmianę tego. W In <filename class="directory"
> można znaleźć pliki, które zapewniają formalny opis możliwych wpisów w pliku konfiguracyjnym. Są one używane przez nowy Edytor konfiguracji &kde; kiedy jest to możliwe.</para>
> o wystartowanie procesu menedżera sesji <command
>ksmserver</command
>. Menedżer sesji określa czas jej życia. W momencie zakończenia tego procesu użytkownik zostaje wylogowany.</para>
</sect2>
</sect1>
<sect1 id="background-processes">
<title
>Procesy drugoplanowe</title>
<para
>Wszystkie procesy drugoplanowe &kde; są uruchamiane dla danego użytkownika - w przeciwieństwie do demonów systemowych nie są współdzielone pomiędzy użytkownikami. Oprócz tego, że są unikalne dla użytkownika, są również unikalne dla danego ekranu X-serwera. Procesami tymi są:</para>
> to demon, który dostarcza ułatwienia dla komunikacji międzyprocesowej (&DCOP;) dla wszystkich programów &kde;. Ułatwienia te są dostępne z powłoki poprzez narzędzie linii poleceń <command
>dcop</command
>. &DCOP; jest istotny dla wszystkich programów &kde;.</para>
<para
>Kilka powiązanych plików:</para>
<variablelist>
<varlistentry>
<term
><filename
>$<envar
>HOME</envar
>/.DCOPserver_$<envar
>HOSTNAME</envar
>_$<envar
>DISPLAY</envar
></filename
></term>
<listitem
><para
>np. <filename
>.DCOPserver_linux__0</filename
>. Kontrolowany przez $<envar
>DCOPAUTHORITY</envar
></para>
</listitem>
</varlistentry>
<varlistentry>
<term
><filename
>/tmp/.ICE-unix/dcop<replaceable
>pid</replaceable
>-<replaceable
>number</replaceable
></filename
></term>
<listitem
><para
>Np. <filename
>dcop7634-1069677856</filename
>. Plik, na który wskazuje powyższy plik <filename
>DCOPserver</filename
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><filename
>$<envar
>HOME</envar
>/.ICEauthority</filename
></term>
<listitem
><para
>Informacje na temat autoryzacji kontrolowane przez $<envar
>ICEAUTHORITY</envar
></para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="kcminit">
<title
>kcminit</title>
<para
><command
>kcminit</command
> wywołuje usługi inicjalizacyjne podczas startu. Usługi inicjalizacyjne są określone w plikach .desktop programów lub usług przez linię <varname
> są ustawione poprawnie, kiedy coś takiego robisz!</para>
</sect2>
<sect2 id="knotify">
<title
><command
>knotify</command
></title>
<para
>Podstawowym zadaniem <command
>knotify</command
> jest przekazywanie powiadomień dźwiękowych do serwera dźwięku, zapewnia on również alternatywne metody powiadomień.</para>
</sect2>
</sect1>
<sect1 id="ksmserver">
<title
>KSMServer</title>
<para
><command
>ksmserver</command
> jest menedżerem sesji &kde;. Podczas startu menedżer sesji uruchamia programy samostartujące i przywraca programy z poprzedniej sesji. Samostartujące programy są określone przez pliki <literal role="extension"
> automatycznie otworzy dowolne pliki znajdujące się w tym katalogu, włączając dokumenty, pliki binarne, lub programy w formie plików <literal role="extension"
>.desktop</literal
>.</para>
<para
>Menedżer sesji &kde; przywraca również jedną z poprzednich sesji. Sesja zawiera zbiór programów, jak również określone dla programu dane, które odzwierciedlają stan programu występujący w momencie zapisu sesji. Sesje przechowywane są pliku konfiguracyjnym <filename
>ksmserverrc</filename
>, który zawiera odniesienia do informacji na temat stanu specyficznego dla programu. Stan ten jest zapisywany w <filename class="directory"
> i powinien wskazywać na katalog główny drzewa instalacyjnego &kde;. Umożliwia &kde; odnalezienie swoich danych, takich jak ikony, menu i biblioteki.</para>
> i umożliwia określenie wielu katalogów, w których &kde; szuka swoich danych. Użyteczne, jeśli chce, lub musi się mieć zainstalowane niektóre programy w innym prefiksie, niż reszta &kde;.</para
> jako katalogu dla danych prywatnych użytkownika <systemitem class="username"
>root</systemitem
>. Zostało wprowadzone, żeby zabezpieczyć &kde; przed przypadkowym nadpisaniem danych użytkownika z prawami roota, kiedy użytkownik uruchamia program &kde; po przełączeniu się poleceniem <command
>(Od &kde; 3.2) Automatycznie ustawiane na true przy starcie &kde;, używane np. przez &konqueror-biernik; w celu określenia, czy powinno się rozważyć pozostanie w pamięci podczas zamykania dla przyszłego wykorzystania. Jeśli nie ustawione, &konqueror; opuści pamięć po zamknięciu (np. &tdesu; tak robi, jest to również przydatne przy debugowaniu).</para>
>Pozwala określić inną, niż <filename class="directory"
>/var/tmp</filename
> ścieżkę, w której &kde; przechowuje swoje zmieniające się pliki.</para>
</listitem>
</varlistentry>
<varlistentry
><term
>$<envar
>XDG_DATA_HOME</envar
></term
><listitem
><para
>(Od &kde; 3.2) Definiuje katalog bazowy, względem którego powinny być przechowywane specyficzne dla użytkownika dane. Domyślnie to <filename class="directory"
>$<envar
>HOME</envar
>/.local/share</filename
></para>
</listitem>
</varlistentry>
<varlistentry
><term
>$<envar
>XDG_DATA_DIRS</envar
></term
><listitem
><para
>(Od &kde; 3.2) Określa uporządkowany według preferencji zbiór bazowych katalogów do przeszukania plików danych w uzupełnieniu do katalogu bazowego <filename class="directory"
> i profili. Używane dla <literal role="extension"
>.desktop</literal
> i plików menu <literal role="extension"
>.directory</literal
>. Pliki <literal role="extension"
>.desktop</literal
> spod <filename class="directory"
>$<envar
>XDG_DATA_DIRS</envar
>/applications</filename
>. Pliki <literal role="extension"
>.directory</literal
> spod $XDG_DATA_DIRS/desktop-directories </para>
</listitem>
</varlistentry>
<varlistentry
><term
>$<envar
>XDG_CONFIG_HOME</envar
></term
><listitem
><para
>(&kde; 3.2) - Definiuje katalog bazowy, względem którego powinny być przechowywane określone dla użytkownika pliki konfiguracyjne. Domyślna wartość to <filename class="directory"
>$<envar
>HOME</envar
>/.config</filename
>.</para>
</listitem>
</varlistentry>
<varlistentry
><term
>$<envar
>XDG_CONFIG_DIRS</envar
></term
><listitem
><para
>(&kde; 3.2) Określa uporządkowany według preferencji zbiór bazowych katalogów do przeszukania plików konfiguracyjnych w uzupełnieniu do katalogu bazowego $<envar
>XDG_CONFIG_HOME</envar
>. Domyślna wartość to <filename class="directory"
>Pokaż skaczący kursor, wyłącz, gdy nie działa.</para>
</callout>
<callout arearefs="co-x-dcop-servicetype"
><para
>Program uruchomił się poprawnie? Usuń, jeśli to nie działa</para>
</callout>
<callout arearefs="co-categories"
><para
>Kategorie menu &kde;, nie używane na pulpicie</para>
</callout>
</calloutlist>
</sect2>
<sect2 id="desktop-icons-exec">
<title
>Opcja <varname
>Exec</varname
> w plikach <literal role="extension"
>.desktop</literal
></title>
<para
>Po samym poleceniu może występować wiele miejsc, które zostaną zastąpione właściwymi wartościami, kiedy właściwy program jest uruchamiany: <variablelist>
<varlistentry>
<term
>%f</term
> <listitem
><para
>Pojedyncza nazwa pliku; używana podczas upuszczania pliku na ikonę, lub z powiązaniami pliku.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%F</term>
<listitem
><para
>Lista plików; do użycia przy programach, które mogą naraz otwierać wiele plików.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%u</term>
<listitem
><para
>Pojedynczy &URL;: jeśli program może sam obsłużyć &URL;-e, np. &FTP;, lub &HTTP;, w przeciwnym wypadku &kde;.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%U</term>
<listitem
><para
>Lista &URL;-i; ściągnie najpierw plik, a do programu przekaże jego lokalną kopię(!!!)</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%d</term>
<listitem
><para
>Katalog pliku do otwarcia; użyteczne, gdy program potrzebuje mieć plik w bieżącym katalogu roboczym.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%D</term>
<listitem
><para
>Lista katalogów, niezbyt praktyczna.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%i</term
>
<listitem
><para
>Ikona; opcja <option
>--icon</option
>; program &kde; użyje ikony z linii <varname
>Icon</varname
>= w pasku zadań.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%m</term>
<listitem
><para
>Mini-ikona - odziedziczone.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%c</term
>
<listitem
><para
>Nagłówek; opcja <option
>--caption</option
>; program użyje nazwy z linii <varname
>Name</varname
>= na pasku zadań.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<informalexample>
<para
>Przykłady: <segmentedlist>
<segtitle
><varname
>Exec</varname
> linia</segtitle>
<segtitle
>Polecenie wykonano</segtitle>
<seglistitem
><seg
>ksirc %i</seg
><seg
><command
>ksirc --icon ksirc</command
></seg>
</seglistitem>
<seglistitem
><seg
>cd %d; kedit $(basename %f)</seg
><seg
><command
>cd /tmp; kedit file.txt</command
></seg>
</seglistitem>
</segmentedlist>
</para>
</informalexample>
<!--Dont' know what this refers to: -->
<!--See What's This (Shift-F1) in Properties Dialog-->
</sect2>
<sect2 id="desktop-icons-devices">
<title
>Urządzenia</title>
<para
>Dowiązania do urządzeń z wykorzystaniem pliku <literal role="extension"
>.desktop</literal
>: Utwórz nowe -> Urządzenie </para>
</sect2>
<sect2 id="where-to-define">
<title
>Gdzie definiować</title>
<para
>Istnieje wiele miejsc do zdefiniowania ikon pulpitu: <itemizedlist>
> przechowuje w pamięci podręcznej strukturę menu i informacje na temat wszystkich dostępnych programów. Można przebudować jego bazę za pomocą <userinput
>, zmiany odnośnie programów do <filename class="directory"
>~/.local/share/applications/</filename
>, a zmiany w podmenu (ikona, nazwa) do <filename class="directory"
>~/.local/share/desktop-directories/</filename
>. Narzędzie administracji KIOSK używa &kmenuedit; i kopiuje powyższe zmiany do lokacji związanych z profilem, lub ogólnosystemowych. </para>
</sect2>
</sect1>
<!-- This section might be redundant. If it isn't, it needs some screenies -->
<sect1 id="kde-panel">
<title
>Panel &kde;</title>
<para
>Panel &kde; jest również znany jako &kicker;. Jego cechą jest modularność, a składa się on z następujących komponentów: <itemizedlist>
<listitem
><para
>Applety</para
></listitem>
<listitem
><para
>Przyciski programów</para
></listitem>
<listitem
><para
>Specjalne przyciski</para
></listitem>
</itemizedlist>
</para>
<para
>Domyślnie panel zawiera następujące applety: <itemizedlist
> <listitem
><para
>Przełącznik i przeglądarka pulpitów - pokazuje wirtualne pulpity</para
></listitem
> <listitem
><para
>Pasek zadań</para
></listitem
> <listitem
><para
>Tacka systemowa</para
></listitem
> <listitem
><para
>Zegar</para
></listitem
> </itemizedlist
> i następujące przyciski specjalne: <itemizedlist>
<listitem
><para
>Menu &kde;</para
></listitem>
<listitem
><para
>Przycisk pulpitu</para
></listitem>
</itemizedlist>
</para>
<para
>Różne przyciski programów są również dodawane, o ile jest wolna przestrzeń: <itemizedlist>
<listitem
><para
>Katalog domowy</para
></listitem>
<listitem
><para
>Przeglądarka WWW</para
></listitem>
<listitem
><para
>Przycisk KMail</para
></listitem>
</itemizedlist>
</para>
</sect1>
<sect1 id="file-associations">
<title
>Powiązania plików</title>
<para
>Powiązania plików kojarzą typ pliku z programem, lub programami. Typ pliku zostaje ustanowiony przez określenie jego typu &MIME;. Typy &MIME; rozpoznawane przez &kde; przechowywane są w <filename class="directory"
>. Aby użyć tych samych ustawień dla wielu użytkowników, należy je przechować w katalogu profilu użytkownika, lub globalnym katalogu konfiguracyjnym &kde; w celu użycia jako domyślnych dla wielu użytkowników.</para>
</informalexample>
</sect1>
</chapter>
<chapter id="locking-down-kde">
<title
>Blokowanie &kde;</title>
<sect1 id="how-it-works-the-basics">
<title
>Jak to działa - podstawy</title>
<para
>Cechy &kde; związane z blokowaniem skoncentrowane są wokół następujących opcji:</para>
>Ograniczenie dostępu do pewnych modułów konfiguracyjnych</link
></para
></listitem>
</itemizedlist>
</sect1>
<sect1 id="immutable-configuration-options">
<title
>Niezmienne opcje konfiguracyjne</title>
<subtitle
>Blokowanie &kde;</subtitle>
<para
>Opcje niezmienne pozwalają administratorowi systemu na dostarczenie opcji domyślnych, które nie mogą być zmieniane przez użytkownika.</para>
<para
>Istniejące wcześniej opcje konfiguracyjne użytkownika będą ignorowane od momentu uczynienia opcji konfiguracyjnej niezmienną.</para>
<para
>Opcje mogą być kontrolowane w ramach pojedynczego wpisu, w ramach grupy, lub plik po pliku.</para>
<para
>Kiedy plik, lub grupa są niezmienne, wszystkie opcje konfiguracyjne, które do nich należą, są niezmienne, nawet te, dla których administrator systemu nie dostarczył wartości domyślnych.</para>
<note
><para
>Wsparcie ze strony programu dla niezmiennych opcji może się wahać od programu do programu. Jakkolwiek użytkownik nie będzie w stanie dokonać permanentnych zmian w niezmiennych opcjach konfiguracyjnych, ciągle może mieć zaprezentowany interfejs użytkownika do zrobienia takiej zmiany.</para
></note>
</sect1>
<sect1 id="action-restrictions">
<title
>Ograniczenia akcji</title>
<para
>Programy &kde; są zbudowane wokół pojęcia akcji. Akcje mogą być aktywowane w różnoraki sposób, typowo przez pasek menu, jeden z pasków narzędzi albo skrót klawiszowy. <action
>Zapisz dokument</action
> jest przykładem akcji. Jeśli znasz wewnętrzną nazwę akcji, jest możliwe jej ograniczenie. Kiedy akcja jest ograniczona, nie pojawia się w pasku menu, lub pasku narzędziowym. Wewnętrzną nazwą dla <action
>Zapisz dokument</action
> jest <option
>action/file_save</option
>. Struktura blokowania zapewnia również zestaw bardziej abstrakcyjnych ograniczeń, które mogą zostać użyte do wyłączenia funkcjonalności nie pokrytej przez pojedynczą akcję. Przykładem może być ograniczenie <option
>shell_access</option
>, które wyłącza całą funkcjonalność, która mogłaby udostępnić użytkownikowi powłokę &UNIX;-ową.</para>
<example>
<title
>Ograniczenie dostępu do powłok</title>
<para
>Aby uniemożliwić dostęp użytkownika do powłoki poleceń można uniemożliwić akcję <option
>shell_access</option
> dodając do <filename
>kdeglobals</filename
>: </para
>
<screen
>[KDE Action Restrictions]
shell_access=false</screen>
<para
>Ponieważ ma to wpływ na menu &kde; i dostępne programy, trzeba wymusić aktualizację bazy sycoca:</para>
>Zezwól na wygaszacze ekranu, które nie ukrywają całego ekranu</para
></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="url-restrictions">
<title
>Restrykcje &URL;</title>
<para
>Istnieją trzy typy ograniczeń, które można zastosować w stosunku do &URL;-i:</para>
<variablelist>
<varlistentry>
<term
>list</term>
<listitem
><para
>Do kontroli, czy wyświetlanie spisu zawartości katalogu jest dozwolone.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>open</term>
<listitem
><para
>Do kontroli, czy pewne &URL;-e mogą być otwierane</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Redirect</term>
<listitem
><para
>Do kontroli, czy jeden &URL; może otworzyć inny &URL; - automatycznie, lub poprzez odnośnik.</para
></listitem>
</varlistentry>
</variablelist>
<para
>Reguły sprawdzane są w kolejności ich zdefiniowania. Ostatnia reguła, którą można zastosować w stosunku do &URL;-a, określa, czy można uzyskać do niego dostęp.</para>
<para
>Następujące reguły wyłączają otwieranie &URL;-i http i https poza domeną <systemitem class="domainname"
>Pierwsze cztery przecinki pozwalają ominąć kryteria wyboru w stosunku do początkowego &URL;-a. Ta część potrzebna jest tylko w wypadku reguł przekierowania.</para
>
</callout>
<callout arearefs="url_rule1"
><para
><option
>rule_1</option
> zabrania otwierania jakiegokolwiek &URL;-a http, lub https</para
></callout>
<callout arearefs="url_rule2"
><para
><option
>rule_2</option
> pozwala na otwarcie dowolnego &URL;-a http, lub https w domenie <systemitem class="domainname"
>.ourcompany.com</systemitem
>. Zauważ, że znak zastępczy <token
>*</token
> może zostać użyty na początku nazwy domeny.</para
></callout>
</calloutlist>
<para
>Następujące reguły powodują, że użytkownik nie może już przeglądać katalogów na lokalnym systemie plików, położonych poza jego katalogiem $<envar
>Następujące reguły powodują, że użytkownik nie może już otwierać plików na lokalnym systemie plików, położonych poza jego katalogiem $<envar
>HOME</envar
>:</para>
<screenco
><areaspec>
<area id="local_rule1" coords="3"/>
<area id="local_rule2" coords="4"/>
<area id="local_rule3" coords="5"/>
</areaspec>
<screen
>[KDE URL Restrictions]
rule_count=3
rule_1=open,,,,file,,,false
rule_2=open,,,,file,,$HOME,true
rule_3=open,,,,file,,$TMP,true</screen
></screenco>
<calloutlist>
<callout arearefs="local_rule1"
><para
><option
>rule_1</option
> zabrania otwierania lokalnych plików w ogóle</para
></callout>
<callout arearefs="local_rule2"
><para
><option
>rule_2</option
> pozwala na otwieranie lokalnych plików znajdujących się pod własnym katalogiem $<envar
>HOME</envar
> użytkownika.</para
></callout>
<callout arearefs="local_rule3"
><para
><option
>rule_3</option
> pozwala na otwieranie plików w tymczasowym katalogu użytkownika w &kde;. Niektóre programy &kde; tego wymagają, na przykład te, które wpierw ściągają plik, lub dokument do katalogu tymczasowego, a potem otwierają go w programie.</para
></callout>
</calloutlist>
<para
>Opcja przekierowania ma wpływ na to, czy dokumenty z określonej lokalizacji mogą odnosić się (automatycznie, lub przez odnośnik) do pewnej innej lokalizacji. Zestaw domyślnych reguł jest obecny jako ogólny wyznacznik bezpieczeństwa. Na przykład dokumenty zlokalizowane na Internecie nie mogą odwoływać się do dokumentów przechowywanych lokalnie.</para>
<para
>Na przykład, jeśli chcemy dać serwerowi intranetowemu <systemitem class="systemname"
>www.mycompany.com</systemitem
> możliwość odnoszenia się do lokalnych plików, możemy dodać następującą regułę:</para>
>Protokoły :local mogą odwoływać się do każdego innego protokołu</para
></listitem>
<listitem
><para
>Zawsze można się odwołać do protokołu :internet</para
></listitem>
<listitem
><para
>Nie wszystkie protokoły są częścią grupy, na przykład fish:/.</para
></listitem>
</itemizedlist>
</sect1>
<sect1 id="configuration-modules">
<title
>Moduły konfiguracyjne</title>
<para
>&kde; posiada moduły konfiguracyjne do konfigurowania różnych aspektów swojego środowiska. Moduły konfiguracyjne występują w Centrum sterowania, w oknie dialogowym konfiguracji programu, albo w obydwu powyższych miejscach.</para>
<informalexample>
<para
>Moduł konfigurujący serwer pośredniczący (proxy) jest obecny w Centrum sterowania, ale również jako część okna dialogowego <guilabel
>Konfiguruj konquerora</guilabel
> w &konqueror-miejscownik;</para>
<para
>Indywidualne moduły konfiguracyjne mogą być uruchomione przy pomocy <command
>Zdalne współdzielenie pulpitu pozwala zdalnym użytkownikom oglądać, i opcjonalnie kontrolować pulpit aktualnego użytkownika. Zdalny użytkownik musi przysłać zaproszenie i jest możliwe stałego zaproszenia zabezpieczonego hasłem. Jest to doskonałe rozwiązanie dla zespołów wsparcia technicznego i administratorów, aby mogli dostać się do pulpitów użytkowników w celu rozwiązania problemu lub przeprowadzenia użytkownika przez jakąś procedurę.</para>
<para
>Zdalne współdzielenie pulpitu używa dwóch programów: &krfb; ( serwera VNC dla &kde;) i &krdc; (klienta VNC dla &kde;)</para>
<para
>&krfb; może być używane przez każdego użytkownika do tworzenia i zarządzania zaproszeniami. Utworzenie zaproszenia powoduje utworzenie jednorazowego hasła, które umożliwia odbiorcy połączenie z Twoim pulpitem. Domyślnie jest ono ważne tylko na jedno pomyślnie rozpoczęte połączenie i wygasa po jednej godzinie.</para>
<para
>Nadchodzące połączenia są obsługiwane przez moduł kinetd w kded. Możesz użyć polecenia <userinput
><command
>dcop</command
> kded kinetd services</userinput
>, aby zobaczyć czy jest uruchomiony. &krfb; domyślnie oczekuje na połączenia na porcie 5900. Kiedy nadejdzie połączenie, pojawi się okienko dialogowe z prośbą o zgodę aktualnego użytkownika.</para>
<!-- TODO: Write a bit more here, with a walk through maybe? -->
</sect1>
<sect1 id="kde-diy">
<title
>&kde; Zrób To Sam - Budowanie własnych narzędzi</title>
<sect2 id="dcop">
<title
>DCOP</title>
<para
>Protokół komunikacji pulpitu (Desktop COmmunication Protocol, <acronym
>DCOP</acronym
>), to prosty sposób komunikacji międzyprocesowej. <acronym
>DCOP</acronym
> pozwala użytkownikowi komunikować się z aktualnie uruchomionymi programami. &kde; udostępnia dwa programy pozwalające używać bezpośrednio <acronym
>DCOP</acronym
>: <application
>dcop</application
> - program uruchamiany z linii poleceń oraz <application
>kdcop</application
>, program z graficznym interfejsem użytkownika. </para>
>, czy pokazać ponownie (zapisując do wymienionego pliku następujące linie):</para>
<screen
>[Notification Messages]
mykey=false</screen>
<para
>Zamiast <option
>--msgbox</option
> można również użyć <option
>--sorry</option
> i <option
>--error</option
>, w odpowiednim kontekście. Na przykład można użyć <command
>kdialog</command
> <option
>--sorry 'Sieć docelowa jest nieosiągalna'</option
>, lub <command
>kdialog</command
> <option
>--error 'Nie da się otworzyć skrzynki pocztowej'</option
>.</para>
<para
>Można również stworzyć okienka wiadomości, które akceptują odpowiedź tak, lub nie.</para>
<screen
><command
>kdialog</command
> <option
>--yesno 'Czy chcesz połączyć się
z internetem?'</option
> <command
>echo</command
> <returnvalue
>$?</returnvalue
></screen>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Wartości zwracane</entry>
<entry
>Znaczenie</entry>
</row>
</thead>
<tbody>
<row
><entry
>0</entry
><entry
>Tak, OK, Dalej</entry
></row>
<row
><entry
>1</entry
><entry
>Nie</entry
></row>
<row
><entry
>2</entry
><entry
>Anuluj</entry
></row>
</tbody>
</tgroup>
</informaltable>
<para
>Nie zapomnij zachować wyniku w zmiennej. Jeśli nie zostanie użyte bezpośrednio, następne polecenie ustawi nową wartość $?. Można tutaj również użyć opcji <option
>--dontagain</option
>, spowoduje ona zapamiętanie wyboru użytkownika i zwrócenie tej wartości następnym razem bez pokazywania okienka dialogowego.</para>
<para
>Dalsze możliwości to:</para>
<variablelist>
<varlistentry>
<term
><option
>--warningyesno</option
></term>
<listitem>
<para
>tak jak <option
>--yesno</option
>, ale z inną ikoną</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--warningcontinuecancel</option
></term>
<listitem
><para
>Z przyciskami <guibutton
>Dalej</guibutton
> i <guibutton
>Anuluj</guibutton
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--warningyesnocancel</option
></term>
<listitem
><para
>Z przyciskami <guibutton
>Tak</guibutton
>, <guibutton
>Nie</guibutton
> i <guibutton
>Anuluj</guibutton
>. Na przykład:</para>
<screen
><command
>kdialog</command
> <option
>--warningyesnocancel 'Czy chcesz
zapisać zmiany?'</option
></screen>
</listitem>
</varlistentry>
</variablelist>
<screen
><command
>kdialog</command
> <option
>--inputbox "Wpisz swoje imię:" "YourName"</option
></screen>
<para
>Rezultat jest wypisywany na standardowe wyjście, aby umieścić go w zmiennej można użyć <userinput
>name=$(kdialog --inputbox "Wpisz swoje imię:" "YourName")</userinput
>. Ostatni argument nie jest obowiązkowy, używa się go do wstępnego wypełnienia pola.</para>
<screen
><userinput
><varname
>password</varname
>=$(<command
>kdialog</command
> <option
>--password "Wpisz hasło:"</option
>)</userinput
></screen>
<para
>Opcja <option
>--dontagain</option
> nie działa z <option
>--inputbox</option
>, ani <option
>--password</option
></para>
<para
>Istnieją dwa dialogi, które pozwalają użytkownikowi dokonać wyboru na podstawie listy:</para>
<variablelist>
<varlistentry>
<term
><option
>--menu</option
></term>
<listitem>
<para
>Pozwala użytkownikowi wybrać z listy pojedynczą wartość.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--checklist</option
></term>
<listitem>
<para
>Pozwala użytkownikowi wybrać jedną, lub więcej wartości z listy.</para>
</listitem>
</varlistentry>
</variablelist>
<screen
><userinput
><varname
>city</varname
>=$(<command
>kdialog</command
> <option
>--menu "Wybierz miasto" a Londyn b Madryt c Paryż d Berlin</option
>)</userinput
></screen>
<para
><varname
>$city</varname
> zwróci <returnvalue
>a</returnvalue
>, <returnvalue
>b</returnvalue
>, <returnvalue
>c</returnvalue
> lub <returnvalue
>d</returnvalue
>.</para>
<screen
><userinput
><varname
>city</varname
>=$(<command
>kdialog</command
> <option
>--checklist "Wybierz miasta" a Londyn off b Madryt on c Paryż on d Berlin off</option
>)</userinput
></screen>
<para
>Madryt i Paryż będą wstępnie zaznaczone. Rezultatem przy ich zostawieniu będzie <returnvalue
>"b"</returnvalue
> <returnvalue
>"c"</returnvalue
>.</para>
<para
>Kiedy dodasz opcję <option
>--separate-output</option
>, spowoduje to umieszczenie <returnvalue
>b</returnvalue
> i <returnvalue
>c</returnvalue
> w osobnych liniach, ułatwiając przetworzenie wyniku.</para>
