diff options
Diffstat (limited to 'tde-i18n-pl/docs/tdenetwork/kopete/chatstyle.docbook')
| -rw-r--r-- | tde-i18n-pl/docs/tdenetwork/kopete/chatstyle.docbook | 650 |
1 files changed, 650 insertions, 0 deletions
diff --git a/tde-i18n-pl/docs/tdenetwork/kopete/chatstyle.docbook b/tde-i18n-pl/docs/tdenetwork/kopete/chatstyle.docbook new file mode 100644 index 00000000000..7613394157b --- /dev/null +++ b/tde-i18n-pl/docs/tdenetwork/kopete/chatstyle.docbook @@ -0,0 +1,650 @@ +<!-- Copyright (c) 2005 by Michaël Larouche <michael.larouche@kdemail.net +> --> +<!-- Licensed under the GNU Free Documentation License --> + +<appendix id="chatwindowstyleguide"> +<title +>Przewodnik po stylach okna rozmowy &kopete;</title> +<sect1 id="chatstyle-reference"> +<title +>Informacje o stylach okna rozmowy &kopete;</title> +<para +>Począwszy od &kopete; 0.12, w stylu okna rozmowy wykorzystywany jest format <ulink url="http://www.adiumx.com/" +>Adium</ulink +>. Ten format motywów bazuje na szablonach <acronym +>HTML</acronym +> i <acronym +>CSS</acronym +>. Są one łatwiejsze do tworzenia i rozwijania, konieczna jest tylko znajomość <acronym +>HTML</acronym +> i <acronym +>CSS</acronym +>. Styl może mieć również warianty (określone jako plik <acronym +>CSS</acronym +>), podnoszące jego możliwości dostosowania do upodobań użytkownika. </para> + +<sect2 id="chatstyle-reference-guide"> + <title +>Krótki przewodnik</title> +<para +>Format Adium określa strukturę katalogów, szablony <acronym +>HTML</acronym +>, pliki <acronym +>CSS</acronym +> i słowa kluczowe, które są zastępowane za każdym razem, gdy przetwarzany jest szablon. Końcowym efektem jest okno rozmowy, w postaci strony <acronym +>XHTML</acronym +>, gdzie wiadomości są dodawane operacjami <acronym +>DOM</acronym +> (drzewa obiektów dokumentu). Centralnym elementem jest element div, nazywany <filename +>Chat</filename +>. Przed i po elemencie div znajdują się szablony Header i Footer. Wiadomości są elementami potomnymi elementu div <filename +>Chat</filename +>. </para> + +<sect3 id="chatstyle-refrerence-directory"> + <title +>Struktura katalogu</title> +<para +>Styl musi trzymać się określonej struktury katalogów. Kod &kopete; również został napisany z myślą o tej strukturze. Archiwizując styl, musisz zarchiwizować katalog <filename +>styleName</filename +>. Struktura katalogu odpowiada strukturze pakietu w systemie <application +>Mac OS X</application +>, jeśli znasz ten system operacyjny, to poczujesz się jak w domu. Musisz zwrócić uwagę na wielkość liter, ponieważ system <acronym +>UNIX</acronym +> rozróżnia małe i wielkie litery.</para> +<programlisting +>styleName\ (może posiadać przyrostek .adiumMessageStyle, ponieważ w Mac OS X jest to pakiet) + Contents\ + Info.plist + Resources\ + main.css + Header.html + Footer.html + Status.html + Incoming\ (i Outgoing\) + Content.html + NextContent.html (dla kolejnych wiadomości) + Context.html (dla historii wiadomości) + NextContext.html + Action.html + Variants\ + *.css +</programlisting> +</sect3> + +<sect3 id="chatstyle-reference-divinsert"> + <title +>Element <div id="insert"></div></title> + <para +>Jest to specjalny element div używany wewnętrznie. To symbol zastępczy, który ma wskazywać, gdzie wstawić następną wiadomość. Jeśli to nowa wiadomość, stara wiadomość jest usuwana, a jej miejsce zajmuje nowa. Ale jeśli to kolejna wiadomość, element div jest zastępowany zawartością nowej wiadomości. Specjalny element div jest <emphasis +>wymagany</emphasis +> w szablonach Content, Context, NextContent, NextContext. Ale można go również umieścić w szablonach Action i Status. </para> +</sect3> + +<sect3 id="chatstyle-reference-templates"> + <title +>Szablony HTML</title> + +<variablelist +><title +>Opis szablonu</title> + +<varlistentry +><term +><filename +>Header.html</filename +> (Wymagany)</term> +<listitem> +<para +>Użyj szablonu Header, aby wyświetlić nad rozmową ładny nagłówek. Ten szablon jest umieszczany przed elementem div <filename +>Chat</filename +>. Jeśli nie chcesz z tego korzystać, umieść tam pusty plik. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>Footer.html</filename +> (Wymagany)</term> +<listitem> +<para +>Podobny do szablonu Header, ale umieszczany jest w stopce rozmowy. Ten szablon jest wstawiany po elemencie div <filename +>Chat</filename +>. Jeżeli nie będziesz go używać, umieść tam pusty plik. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>Status.html</filename +> (Wymagany)</term> +<listitem> +<para +>Ten szablon jest używany do wyświetlania wewnętrznych komunikatów. Chodzi o komunikaty typu zmiana statusu, czy komunikaty od Kopete (np. o nadchodzącym pliku). Jeśli styl nie zawiera szablonu Action, szablon Status używany jest do wyświetlania komunikatów Action. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>Incoming/Content.html</filename +></term> + <term +><filename +>Outgoing/Content.html</filename +> (Wymagany)</term> +<listitem> +<para +>Szablon Content to główna część okna wiadomości. Traktuj go jak blok zawierający wiadomości. Upewnij się, że jest w stanie dodawać kolejne wiadomości, nie projektuj go tak, by wyświetlił tylko jedną. Kolejne wiadomości będą umieszczane w elemencie div insert. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>Incoming/NextContent.html</filename +></term> + <term +><filename +>Outgoing/NextContent.html</filename +> (Wymagany)</term> +<listitem> +<para +>Szablon NextContent to element z wiadomością dla kolejnych wiadomości. Zostanie on wstawiony do głównego bloku wiadomości. Szablon HTML powinien zawierać tylko minimum konieczne do wyświetlenia wiadomości. </para> +</listitem> +</varlistentry> + + +<varlistentry +><term +><filename +>Incoming/Action.html</filename +></term> + <term +><filename +>Outgoing/Action.html</filename +> (Opcjonalne) (Rozszerzenie &kopete;)</term> +<listitem> +<para +>Ten szablon jest rozszerzeniem &kopete; w stosunku do formatu Adium. Jest dostępny dla kierunku przychodzącego i wychodzącego. Wiadomości Action to specjalne wiadomości informujące o tym, że podejmujemy jakieś działanie. Przykład: "/me instaluje &kopete;" będzie wyświetlane jako "DarkShock instaluje &kopete;". </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>Incoming/Context.html</filename +></term> + <term +><filename +>Incoming/NextContext.html</filename +></term> + <term +><filename +>Outgoing/Context.html</filename +></term> + <term +><filename +>Outgoing/NextContext.html</filename +> (Opcjonalne)</term> +<listitem> +<para +>Te szablony nie są stosowane w Kopete. W formacie Adium są używane do wyświetlania historii. Bardzo przypominają szablony Content i NextContent, jedynie kilka elementów odróżnia je od zwykłych wiadomości. </para> +</listitem> +</varlistentry> + +</variablelist> + +</sect3> + +<sect3 id="chatstyle-reference-css"> + <title +>Style CSS i warianty</title> + <para +>Szablony HTML są używane do opisu utworzonej struktury. Cały styl jest opisany jednak w plikach <acronym +>CSS</acronym +>. <filename +>main.css</filename +> to główny styl, a warianty to odmiany głównego stylu. Przykładem wariantu są zmienione kolory, czy brak pokazanego zdjęcia użytkownika. Zarówno <filename +>main.css</filename +>, jak i warianty są dołączane do wynikowej strony <acronym +>XHTML</acronym +>.</para> + <sect4 id="chatstyle-reference-css-main"> + <title +><filename +>main.css</filename +></title> + <para +>Jest to główny plik <acronym +>CSS</acronym +>, który jest wspólny dla wszystkich wariantów. W tym pliku powinien być zawarty cały główny opis stylu.</para> + </sect4> + <sect4 id="chatstyle-refrence-css-variants"> + <title +>Warianty</title> + <para +>Warianty to pliki <acronym +>CSS</acronym +> umieszczone w katalogu <filename +>Variants/</filename +>. Każdy wariant to pojedynczy plik <acronym +>CSS</acronym +>, który dołącza do siebie <filename +>main.css</filename +> i wprowadza modyfikacje głównego stylu.</para> + </sect4> +</sect3> + +<sect3 id="chatstyle-reference-debug"> + <title +>Usuwanie błędów ze stylów</title> + <para +>Oto dwie wskazówki pomagające wypróbować utworzony styl.</para> + <sect4 id="chatstyle-reference-debug-save"> + <title +>Zapisz próbną rozmowę</title> + <para +>W oknie rozmowy możesz <action +>zapisać</action +> dyskusję. Jest to kopia wyświetlanej, wewnętrznej strony XHTML. Otwórz ją w przeglądarce <application +>Konqueror</application +>, aby przetestować Twoje pliki <acronym +>CSS</acronym +>.</para> + </sect4> + <sect4 id="chatstyle-reference-debug-disable-cache"> + <title +>Wyłącz buforowanie stylu</title> + <para +>Parametr konfiguracji &kopete; pozwala wyłączyć buforowanie stylu. Gdy buforowanie jest wyłączone, szablony HTML są wczytywane ponownie za każdym razem, gdy pojawia się prośba o styl. Dodaj poniższe wiersze do Twojego pliku <filename +>kopeterc</filename +>. Jest to bardzo użyteczne przy testowaniu stylów w &kopete;.</para> + <programlisting +>[KopeteStyleDebug] +disableStyleCache=true +</programlisting> + </sect4> +</sect3> + +</sect2> + +<sect2 id="chatstyle-reference-keywords"> + <title +>Słowa kluczowe</title> + <para +>Słowa kluczowe są jak puste miejsca do wypełnienia szczegółami. Z nadejściem nowej wiadomości, są one zastępowane prawidłową wartością, odpowiadającą kontekstowi. Aby możliwa była pełna obsługa funkcji w Kopete, dodane zostało kilka rozszerzeń słów kluczowych do Adium. Również niektóre słowa kluczowe są dostępne tylko w pewnym kontekście.</para> + +<variablelist +><title +>Słowa kluczowe dla szablonów Header i Footer </title> +<para +>Te słowa kluczowe są przetwarzane na początku rozmowy.</para> +<varlistentry +><term +><filename +>%chatName%</filename +></term> +<listitem> +<para +>Jest to nazwa bieżącej sesji rozmowy. W typowej sesji, wyświetlana jest nazwa rozmówcy i jego status. W przypadku <acronym +>IRC</acronym +> pokazywany jest temat kanału. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>%sourceName%</filename +></term> + <term +><filename +>%destinationName%</filename +></term> +<listitem> +<para +>Są to nazwy uczestników rozmowy. <filename +>%sourceName%</filename +> to Twoja nazwa. <filename +>%destinationName%</filename +> to nazwa osoby z którą rozmawiasz. Zalecamy używanie <filename +>%chatName%</filename +>, ponieważ dwa pozostałe mogą wprowadzać w błąd w rozmowach grupowych i IRC. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>%incomingIconPath%</filename +></term> + <term +><filename +>%outgoingIconPath%</filename +></term> +<listitem> +<para +>Są to obrazy/zdjęcia/awatary uczestników rozmowy. Incoming przedstawia zdjęcie rozmówcy, a Outgoing Twoje własne zdjęcie. Jeśli brak jest dostępnych zdjęć, użyty zostanie obrazek <filename +>buddy_icon.png</filename +>, znajdujący się w katalogu <filename +>Incoming</filename +> lub <filename +>Outgoing</filename +>. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>%timeOpened%</filename +></term> + <term +><filename +>%timeOpened{X}%</filename +></term> +<listitem> +<para +>To czas rozpoczęcia rozmowy. <filename +>%timeOpened%</filename +> używa domyślnego formatu czasu dla bieżącego czasu lokalnego. Jeśli chcesz używać określonego formatu czasu, użyj <filename +>%timeOpened{X}%</filename +>, gdzie X jest ciągiem zawierającym format czasu. Parametry formatu czasu są te same co w funkcji glibc <function +>strftime</function +>. Wpisz <command +>man:strftime</command +> w oknie &konqueror-dopelniacz; , aby otrzymać listę dostępnych parametrów. </para> +</listitem> +</varlistentry> + +</variablelist> + +<variablelist +><title +>Słowa kluczowe dla szablonów Content, NextContent, Context, NextContext, Action</title> +<para +>Te słowa kluczowe są przetwarzane dla każdej wiadomości.</para> + +<varlistentry +><term +><filename +>%userIconPath%</filename +></term> +<listitem> +<para +>Jest to obraz/zdjęcie/awatar osoby powiązanej z wiadomością. Jeśli zdjęcie nie jest dostępne, użyty zostanie obrazek <filename +>buddy_icon.png</filename +>, znajdujący się w katalogu <filename +>Incoming</filename +> lub <filename +>Outgoing</filename +>, w zależności od kierunku wiadomości. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>%senderScreenName%</filename +></term> +<listitem> +<para +>To identyfikator osoby powiązany z wiadomością. Przykłady: me@hotmail.com, 45566576, JohnSmith. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>%sender%</filename +></term> +<listitem> +<para +>To nazwa osoby powiązana z wiadomością. Używa wyświetlanej nazwy metakontaktu jako źródła. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>%service%</filename +></term> +<listitem> +<para +>Zawiera nazwę serwisu powiązaną z wiadomością. Przykłady: Jabber, Yahoo, MSN. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>%textbackgroundcolor{X}%</filename +></term> +<listitem> +<para +>To słowo kluczowe jest używane w &kopete; do przedstawienia tła podświetlenia. Zignoruj parametr w nawiasach klamrowych i używaj tylko jako <filename +>%textbackgroundcolor{}</filename +>. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>%senderStatusIcon%</filename +> (Rozszerzenie &kopete;)</term> +<listitem> +<para +>Wyświetla ikonę stanu kontaktu powiązaną z wiadomością. Jest to ścieżka do pliku. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>%senderColor%</filename +></term +> <term +><filename +>%senderColor{N}%</filename +> (Rozszerzenie &kopete;)</term> +<listitem> +<para +>Tworzy kolor z identyfikatora osoby wysyłającej. Może być używane do wyświetlenia odmiennego koloru dla pseudonimu kontaktu. </para> +<para +><filename +>%senderColor{N}%</filename +>, gdzie N jest liczbą dodatnią. Jeśli N jest większe niż 100, wówczas przedstawia kolor jaśniejszy niż kolor czcionki kontaktu. Jeśli N jest równe 150 to jest to kolor, który jest jaśniejszy o 50%. Jeśli N jest mniejsze niż 100, to wówczas kolor jest ciemniejszy. Może służyć w do zróżnicowania tła każdego kontaktu. </para> +<para +>Jeśli chcesz używać tych kolorów w wariantach, a nie w stylu głównym, musisz zastosować sztuczkę. <programlisting> +<![CDATA[ +<div style="color:%senderColor%;border:none;border-color:%senderColor{40}%;" +><p class="message" +>...</p +></div> +]]> +</programlisting +> możesz zastosować kolor dla p.message w Twoim pliku <filename +>main.css</filename +>, a w wariancie musisz zrobić tak <programlisting +>p.message { color:inherit; border-color:inherit; } +</programlisting> + +</para> +</listitem> +</varlistentry> + +</variablelist> + +<variablelist +><title +>Wspólne słowa kluczowe dla wiadomości i Status.html</title> + +<varlistentry +><term +><filename +>%message%</filename +></term> +<listitem> +<para +>To właściwa wiadomość, która jest fragmentem HTML. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>%time%</filename +></term> + <term +><filename +>%time{X}%</filename +></term> +<listitem> +<para +>Czas otrzymania wiadomości. <filename +>%time%</filename +> korzysta z domyślnego formatu czasu dla czasu lokalnego. Jeśli chcesz używać określonego formatu czasu, użyj <filename +>%time{X}%</filename +>, gdzie X jest ciągiem zawierającym format czasu. Parametry czasu są te same co w funkcji glibc <function +>strftime</function +>. Wpisz <command +>man:strftime</command +> w oknie &konqueror-dopelniacz;, aby otrzymać listę dostępnych parametrów. </para> +</listitem> +</varlistentry> + +<varlistentry +><term +><filename +>%messageDirection%</filename +> (Rozszerzenie &kopete;)</term> +<listitem> +<para +>Określa kierunek wiadomości, jeśli wiadomość musi być wyświetlana od prawej do lewej lub od lewej do prawej. Wartością może być "rtl" lub "ltr". Przeczytaj <link linkend="chatstyle-guideline-direction" +>reguły Kierunek wiadomości</link +>, aby zobaczyć jak używać tego słowa kluczowego poprawnie. </para> +</listitem> +</varlistentry> +</variablelist> + +</sect2> +</sect1> + +<sect1 id="chatstyle-guideline"> + <title +>Reguły stylów okna rozmowy &kopete;</title> +<para +>Reguły stylu okna rozmowy &kopete; określają, co styl ma obsługiwać, aby być zgodnym z Kopete.</para> +<sect2 id="chatstyle-guideline-highlight"> + <title +>Obsługa podświetlenia</title> + <para +>Twój styl musi umożliwiać podświetlenie. W Kopete i Adium <filename +>%textbackgroundcolor{}%</filename +> jest zastępowany kolorem podświetlenia. Dodaj ten atrybut stylu: <userinput +>background-color: %textbackgroundcolor{}%</userinput +> do elementu HTML wyświetlającego wiadomość.</para> +</sect2> +<sect2 id="chatstyle-guideline-consecutive"> + <title +>Wymagane są szablony kolejnych wiadomości</title> + <para +>Ta reguła odnosi się do ludzi przekształacających stare style XSL do nowego formatu. Wszystkie style muszą posiadać szablon dla kolejnych wiadomości. Jest to obecnie domyślna funkcja.</para> +</sect2> + +<sect2 id="chatstyle-guideline-encoding"> + <title +>Używaj kodowania <acronym +>UTF-8</acronym +></title> + <para +>Tytuł mówi wszystko. Musisz zapisywać pliki w <acronym +>UTF-8</acronym +>.</para> +</sect2> + +<sect2 id="chatstyle-guideline-info"> + <title +>Dodaj <filename +>Contents/Info.plist</filename +> dla zgodności z Adium</title> + <para +>Plik <filename +>Contents/Info.plist</filename +> nie jest jeszcze używany w Kopete. Ale jeśli chcesz, by Twój styl był zgodny z <application +>Adium</application +>, musisz zamieścić ten plik. Oto prosty przykład pliku. Ciągi do zastąpienia znajdują się pomiędzy "$".</para> +<programlisting +><![CDATA[ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> +<plist version="1.0"> +<dict> + <key +>CFBundleDevelopmentRegion</key> + <string +>English</string> + <key +>CFBundleGetInfoString</key> + <string +>$Your style full name$</string> + <key +>CFBundleIdentifier</key> + <string +>$Your style ID in the form: com.adiumx.smooth.operator.style$</string> + <key +>CFBundleInfoDictionaryVersion</key> + <string +>1.0</string> + <key +>CFBundleName</key> + <string +>$Your style name here$</string> + <key +>CFBundlePackageType</key> + <string +>AdIM</string> + <key +>MessageViewVersion</key> + <integer +>3</integer> +</dict> +</plist> +]]> +</programlisting> + +</sect2> + +<sect2 id="chatstyle-guideline-buddyicon"> + <title +>Dodaj <filename +>buddy_icon.png</filename +></title> + <para +>Musisz umieścić plik o nazwie <filename +>buddy_icon.png</filename +> w katalogach <filename +>Incoming</filename +> i <filename +>Outgoing</filename +>. Te obrazy zostaną użyte, gdy nie ma zdjęcia rozmówcy.</para> +</sect2> + +<sect2 id="chatstyle-guideline-direction"> + <title +>Obsługa języków od prawej do lewej za pomocą słowa kluczowego <filename +>%messageDirection%</filename +></title> + <para +>Dostępne jest słowo kluczowe <filename +>%messageDirection%</filename +> dla języków pisanych od prawej do lewej. Określa ono kierunek wiadomości: "rtl"(od prawej do lewej) lub "ltr"(od lewej do prawej). Dodaj ten atrybut stylu do elementu HTML wyświetlającego wiadomość: <userinput +>direction: %messageDirection%</userinput +>. Podgląd stylu w konfiguracji wyglądu zawiera tekst pisany od prawej do lewej, w celu sprawdzenia, czy styl jest wyświetlany poprawnie. Napis powinien rozpoczynać się od prawej.</para> +</sect2> +</sect1> +</appendix> |