PL:Instrukcja użytkownika

[edit] Zaawansowane tematy

[edit] Konfiguracja

[edit] PSIDATADIR

PSIDATADIR jest zmienną środowiskową (ang. environment variable), wskazującą na położenie plików danych Psi (m.in. konfiguracji, profili, historii).

Zmiana wartości zmiennych środowiskowych nie wymaga żadnych specjalnych umiejętności.

Z drugiej jednak strony, odwołanie do wartości zmiennych środowiskowych jest różne w zależności od używanego systemu operacyjnego:

• Systemy uniksowe używają znaku dolara "$" jako przedrostka przed nazwą zmiennej, np. $PSIDATADIR
• Systemy Windows używają znaku procenta "%" jako przedrostka przed i przyrostka za nazwą zmiennej, np. %PSIDATADIR%

[edit] Wartości domyślne zmiennej

Domyślna wartość zmiennej środowiskowej (używana gdy nie jest ona zdefiniowana explicit) jest zależna od używanego systemu operacyjnego:

Linux, MacOS X, systemy *BSD i inne Uniksy

~/.psi/

Windows NT, Windows 2000, Windows XP, Windows Server 2003, Windows Vista i Windows Server 2008

 %UserProfile%\PsiData\

Windows 95, Windows 98 oraz Windows Me

 %ProgramFiles%\Psi\PsiData\

gdzie:

 %UserProfile%

Określa Twój folder domowy w systemach operacyjnych Windows NT/2000/XP/Server 2003. Zwykle jest to folder C:\Users\loginname w systemach Windows Vista i Windows Server 2008, C:\Documents and Settings\loginname w systemach Windows 2000/XP/Server 2003 lub C:\WINNT\Profiles\loginname w systemach Windows NT. Nie jest to folder tożsamy z folderem Moje dokumenty.

 %ProgramFiles%

Określa Twój folder Program Files. Zwykle jest to folder C:\Program Files.

loginname

Twoja krótka nazwa użytkownika w systemach Windows, używana podczas logowania do systemu. Zwykle nie jest to nazwa użytkownika używana na ekranie powitalnym w systemach Windows XP.

[edit] Zmiana wartości zmiennej

UWAGA: Zmiany wartości zmiennej PSIDATADIR zostaną wzięte pod uwagę dopiero po ponownym uruchomieniu Psi.

Windows XP, Windows Server 2003, analogicznie w Windows 2000</dt>

• Przejdź do Właściwości systemu (kliknij prawym przyciskiem myszy na ikonie Mój komputer i wybierz Właściwości lub naciśnij klawisze Win-Break).
• Przejdź do zakładki Zaawansowane.
• Naciśnij przycisk Zmienne środowiskowe
• W rejonie "Zmienne użytkownika dla loginname" naciśnij przycisk "Nowa"
• W polu "Nazwa zmiennej" wpisz PSIDATADIR a w polu "Wartość zmiennej" podaj pełną ścieżkę do folderu, w którym chcesz by Psi przechowywała swoje dane.
• Zamknij wszystkie okna.

</dd>

[edit] Znajdowanie plików konfiguracyjnych

Psi przechowuje swoją konfigurację w pliku config.xml (od Psi-0.11 również w pliku options.xml). Poniższe kroki opisują jak znaleźć pliki konfiguracyjne Psi:

1. Zamknij Psi.
2. Znajdź plik config.xml lub options.xml w zależności od swojego systemu operacyjnego:

   Linux, MacOS X, systemy BSD oraz inne Uniksy:</dt>

   $PSIDATADIR/profiles/profilename/config.xml</dd>

   $PSIDATADIR/profiles/profilename/options.xml</dd>

   Systemy Windows:</dt>

   %PSIDATADIR%\profiles\profilename\config.xml</dd>

   %PSIDATADIR%\profiles\profilename\options.xml</dd>

   gdzie:

   $PSIDATADIR or %PSIDATADIR%</dt>

   Określa wartość zmiennej środowiskowej - jak opisano wcześniej</dd>

   profilename</dt>

   Nazwa Twojego profilu w Psi; domyślnie jest to default</dd>

3. Wykonaj kopię bezpieczeństwa pliku config.xml (oraz options.xml, jeśli takowy istnieje).

[edit] Kopia bezpieczeństwa

Od czasu do czasu możesz stwierdzić, że potrzebujesz utworzyć kopię bezpieczeństwa konfiguracji Psi, a potem ją przywrócić. Na przykład, podczas reinstalacji systemu operacyjnego lub przenosin na inny komputer.

[edit] Wykonanie

[edit] Pliki konfiguracyjne

1. Skopiuj w bezpieczne miejsce katalog wskazywany przez zmienną środowiskową PSIDATADIR.
2. Zanotuj jaką wartość ma zmienna środowiskowa PSIDATADIR. Jeśli Psi używa wartości domyślnej, zanotuj ten fakt.
3. Jeśli używasz systemu operacyjnego Windows, musisz dodatkowo wyeksportować pewne informacje z Rejestru Systemowego. Psi używa Rejestru by zapisać nazwę ostatnio używanego profilu oraz języka tłumaczenia interfejsu. Różne wersje Psi używają różnych kluczy Rejestru do przechowywania swojej konfiguracji:
   • Psi-0.9.2 i starsze:
     HKEY_LOCAL_MACHINE\Software\Affinix\psi
   • Psi-0.9.3 oraz Psi-0.10:
     HKEY_CURRENT_USER\Software\Affinix\psi
   • Psi-0.11 i nowsze:
     HKEY_CURRENT_USER\Software\psi-im.org\Psi
   Aby zrobić kopię zapasową danych z Rejestru, otwórz okno Uruchom (znajdziesz je w Menu Start), wpisz regedit i naciśnij Enter. Uruchomi się Edytor Rejestru. Uwagi:
   • Rejestr jest centralną bazą danych o systemie Windows. Nieprawidłowe użycie Edytora Rejestru doprowadzi do nienormalnego zachowania systemu lub spowoduje niestabilność systemu Windows. Programiści Psi nie są odpowiedzialni za wszelkie szkody powstałe w wyniku stosowania Edytora Rejestru.
   • Wszystkie zmiany w Rejestrze Systemowym dokonane przy użyciu Edytora Rejestru mają natychmiastowy skutek i nie mogą zostać cofnięte.
   Okno Edytora Rejestru przypomina okno Eksploratora Windows - po lewej stronie znajduje się drzewiasta struktura Rejestru oraz zawartość klucza Rejestru po prawej. Przejdź po strukturze drzewa Rejestru do odpowiedniego klucza (spośród podanych powyżej). Otwórz menu Plik i kliknij na opcję Eksportuj.... Zostaniesz poproszony o podanie ścieżki i nazwy pliku, do którego ma zostać zapisana zawartość klucza Rejestru. Nazwij go opisowo i zapisz w bezpiecznym miejscu.

[edit] Pliki wykonywalne

Zwykle stosuje się programy instalacyjne do instalacji Psi w nowym systemie operacyjnym lub na nowym komputerze, ponieważ instalator może umieszczać dodatkowe pliki lub skróty w Twoim systemie operacyjnym. Wystarczy jednak skopiować pliki wykonywalne Psi aby Psi zadziałała.

W zależności od systemu operacyjnego, pliki wykonywalne są umieszczane w różnych miejscach:

• Windows:
  Domyślnie %ProgramFiles%\Psi; zwykle C:\Program Files\Psi. Sprawdź wartość zmiennej środowiskowej %ProgramFiles% by znaleźć rzeczywistą lokalizację folderu Program Files.
• Mac OS X:
  

 Czy jest co zapisywać?

• Linux, *BSD oraz inne systemy uniksowe poza Mac OS X:
  Zazwyczaj /usr/local/share/psi. Wykonaj polecenie which psi w konsoli by dowiedzieć się gdzie naprawdę jest Psi.

Zrób kopię bezpieczeństwa znalezionych plików w bezpiecznym miejscu.

[edit] Przywracanie

[edit] Pliki konfiguracyjne

Po prostu skopiuj pliki konfiguracyjne do katalogu, z którego została utworzona kopia bezpieczeństwa. Jeśli była ustawiona zmienna środowiskowa PSIDATADIR, przywróć jej poprzednią wartość.

Możesz również powrócić do domyślnych lokalizacji plików konfiguracyjnych i tam przekopiować kopie bezpieczeństwa. Domyślne katalogi konfiguracji Psi są opisane wcześniej. Pamiętaj by w takiej sytuacji nie ustawiać zmiennej środowiskowej PSIDATADIR.

Użytkownicy systemów operacyjnych Windows powinni wykonać podwójne kliknięcie na wcześniej utworzonych plikach Rejestru by wprowadzić zapisane tam dane do Rejestru Systemowego. To utworzy lub zmieni wartości trzem wartościom Rejestru:

 </tr>

[edit] Pliki wykonywalne

Doradza się instalację Psi i niekorzystanie z kopii bezpieczeństwa plików wykonywalnych Psi. Jeśli jednak wolisz skorzystać z kopii bezpieczeństwa, może się okazać, że skróty w Menu Start (dla użytkowników systemów Windows) jak i jakiekolwiek inne skróty (w innych systemach) nie istnieją lub są nieprawidłowe, ponieważ są one tworzone przez instalatory - musisz je samemu odtworzyć.

Jeśli nadal chcesz odtworzyć pliki wykonywalne Psi z kopii bezpieczeństwa, skopiuj pliki w ich pierwotną lokalizację. W systemach Windows oraz X Window System (z GNOME, KDE lub dowolnym innym managerze okien) musisz stworzyć skróty do Psi samemu.

W systemie MacOS X musisz zainstalować Psi ponownie.

Twoja Psi powinna być gotowa do użycia z poprzednimi ustawieniami.

[edit] Zmiana sposobu sortowania elementów listy kontaktów

Poniższe kroki opisują jak wpłynąć na Psi by zmieniła sposób sortowania elementów listy kontaktów.

1. Znajdź plik konfiguracyjny config.xml, jak to opisano wcześniej. Upewnij się, że masz kopię bezpieczeństwa tego pliku.
2. Zmodyfikuj plik config.xml:
   1. Znajdź poniższe znaczniki

       <preferences>
         <general>
           <roster>
      

      w pliku config.xml. Powinieneś mieć w pobliżu coś podobnego do:

        <sortStyle>
          <contact>status</contact>
          <group>alpha</group>
          <account>rank</account>
        </sortStyle>
      

   2. Aby zmienić sposób sortowania kont, zmień wartość między znacznikami <account> oraz </account>. Dopuszczalnymi wartościami są rank (dla ręcznie określonych rang) oraz alpha (dla domyślnego sortowania alfabetycznego).
   3. Aby zmienić sposób sortowania grup, zmień wartość między znacznikami <group> oraz </group>. Dopuszczalnymi wartościami są rank (dla ręcznie określonych rang) oraz alpha (dla domyślnego sortowania alfabetycznego).
   4. Aby zmienić sposób sortowania kontaktów, zmień wartość między znacznikami <contact> oraz </contact>. Dopuszczalnymi wartościami są alpha (dla alfabetycznego sortowania po nazwach) oraz status (dla domyślnego sortowania po stanie).
   5. Jeśli chcesz zmienić kolejność grup lub kont, znajdź wszystkie wystąpienia znaczników <groupState> w pliku config.xml. Pamiętaj, że grupy są przechowywane oddzielnie dla każdego z kont (znacznik <groupState> opisuje grupy należące do jednego konta) a konto jest traktowane jako specjalna grupa (której nazwa zaczyna się /\/ i kończy \/\).
   6. Każda grupa i konto ma powiązany znacznik <group>, który ma parametr rank. Zmień wartość parametru rank. Jeśli reguła sortowania grup ma wartość rank, to grupy będą porządkowane według rosnących wartości rang w ramach pojedynczego konta.
   7. Konta są również porządkowane według rosnących wartości rang, jeśli reguła sortowania kont ma wartość rank.
   8. W obu przypadkach, jeśli dwie lub więcej grup lub kont ma tę samą wartość rangi, to ich kolejność nie jest określona (jednak zwykle grupy lub konta o tej samej randze są sortowane alfabetycznie).
3. Zapisz plik config.xml.
4. Uruchom ponownie Psi.

Psi-Daisy, jeden z nieoficjalnych buildów Psi, ma możliwość zmiany sortowania elementów listy kontaktów z poziomu interfejsu użytkownika.

[edit] Tworzenie zestawów ikon

[edit] Czym jest zestaw ikon?

Odpowiedź na to pytanie można znaleźć tutaj.

[edit] Edytory zestawów ikon

Edytor plików JISP dla Windows, na licencji GPL.

[edit] Jak tworzyć zestawy ikon?

Oto jak krok po kroku stworzyć własny zestaw ikon:

• Utwórz katalog i nazwij go w jakiś sensowny sposób, na przykład Mój_pierwszy_zestaw_ikon.
  • Pamiętaj by nie stosować spacji w nazwie katalogu.
  • Staraj się używać wyłącznie liter z alfabetu łacińskiego, cyfr, znaków podkreśleń (_) i myślników (-). Zapewni to, że wszyscy będą się mogli cieszyć Twoim zestawem ikon.
• W katalogu utwórz plik o nazwie icondef.xml.
• Skopiuj do katalogu wszystkie ikony i dźwięki, które chcesz mieć w zestawie ikon.
• Rozpocznij edycję pliku icondef.xml w Swoim Ulubionym Edytorze Plików XML^TM.
• W pliku icondef.xml wpisz następujące znaczniki:

<?xml version="1.0" encoding="UTF-8"?>
<icondef>
</icondef>

• Teraz dodaj informację o zestawie ikon:

<?xml version="1.0" encoding="UTF-8"?>
<icondef>
	<meta>
		<name>Nazwa zestawu ikon</name>
		<version>Wersja zestawu ikon</version>
		<description>Opis zestawu ikon</description>
		<creation>2006-09-17</creation> 
		<home>http://www.zestawikon.serwer.com</home>
		<author jid="autor.zestawuikon@serwer.com"
			  email="autor.zestawuikon@bez.spamu.proszę.serwer.com"
			  www="http://autor.zestawuikon.serwer.com">Autor Zestawu Ikon</author>
		<author>Gall Anonim</author>
	</meta>
</icondef>

• Teraz pora na dodanie informacji o samych ikonach:

<?xml version="1.0" encoding="UTF-8"?>
<icondef>
	<meta>  </meta>

	<icon>
		<text>:-)</text>
		<text>:)</text>
		<text xml:lang="en">:smiley:</text>

		<object mime="image/png">smiley.png</object>
		<object mime="audio/x-wav">smiley.wav</object>
	</icon>
</icondef>

Ten zestaw ikon zawiera wyłącznie jedną ikonkę, która jest powiązana z następującymi tekstami:

:-)
:)
:smiley:

Gdy ikona będzie miała być wyświetlona na ekranie, to zostanie do tego celu użyty plik smiley.png i odegrany plik dźwiękowy smiley.wav.

[edit] Predefiniowane nazwy ikon

status/online 

Status kontaktu jest Dostępny lub ustaw swój status na Dostępny

status/offline 

Status kontaktu jest Rozłączony lub ustaw swój status na Rozłączony (rozłącz się)

status/away 

Status kontaktu jest Zaraz wracam lub ustaw swój status na Zaraz wracam

status/xa 

Status kontaktu jest Nieobecny lub ustaw swój status na Nieobecny

status/dnd 

Status kontaktu jest Nie przeszkadzać lub ustaw swój status na Nie przeszkadzać

status/invisible 

Ustaw swój status na Niewidoczny

status/chat 

Status kontaktu jest Chętny do rozmowy lub ustaw swój status na Chętny do rozmowy

status/ask and status/noauth 

Dodałeś kontakt do swojego rostera (listy kontaktów), ale nie możesz (jeszcze) zobaczyć jego statusu

status/error 

Nie można się połączyć z serwerem, którego używa kontakt

psi/chat 

Przychodząca rozmowa

psi/message 

Przychodząca wiadomość

psi/headline 

Przychodzący nagłówek wiadomości

psi/file 

Przychodzący transfer plików

psi/system 

Przychodząca wiadomość systemowa

psi/connect 

Trwa łączenie się z serwerem

psi/groupEmpty 

Pusta grupa kontaktów

psi/groupOpen 

Otwarta niepusta grupa kontaktów

psi/groupClosed 

Zamknięta niepusta grupa kontaktów

[edit] Dopuszczalne typy MIME zawartości

• Dla obrazków:
  • image/png - preferowany format obrazków
  • video/x-mng (animowany) - na chwilę obecną nie wspierany dla emotikon w interfejsie Psi
  • image/gif (animowany) - na chwilę obecną nie wspierany dla emotikon w interfejsie Psi
  • image/x-xpm
  • image/bmp
  • image/jpeg
  • image/svg+xml
• Dla dźwięków:
  • audio/x-wav -- preferowany format dźwięków, ponieważ Psi go obsługuje na wszystkich platformach
  • audio/x-ogg
  • audio/x-mp3
  • audio/x-midi -- tak naprawdę niewspierany (czy ktoś mógłby pomóc naprawić tę sytuację?)

Można łączyć wiele typów MIME dla grafiki i dla dźwięku:

	<icon>
		<object mime="image/png">smiley.png</object>
		<object mime="video/x-mng">smiley.mng</object>
		<object mime="image/gif">smiley.gif</object>

		<object mime="audio/x-wav">smiley.wav</object>
		<object mime="audio/x-ogg">smiley.ogg</object>
	</icon>
	

[edit] Dodatkowe znaczniki ikon w Psi

[edit] Nazwa

Poniższa ikona ma zdefiniowaną nazwę. Jest to głównie używane w zestawach ikon systemowych dla Psi:

	<icon>
		<object mime="image/png">smiley.png</object>
		<object mime="audio/x-wav">smiley.wav</object>

		<x xmlns="name">emoticon/smiley</x>
	</icon>
	

[edit] Animacja

Można wymusić animację (lub brak animacji) ikony

	<icon>
		<object mime="image/png">connect.png</object> 

		<x xmlns="name">psi/connect</x>
		<x xmlns="type">animation</x>
	</icon>
	

Dzięki temu ikona będzie animowana. Kolejne klatki animacji są położone poziomo koło siebie w pojedynczym pliku PNG.

Uwaga:

• Na chwilę obecną nie można animować emotikon.

	<icon>
		<object mime="image/png">connect.png</object>

		<x xmlns="name">psi/connect</x>
		<x xmlns="type">image</x>
	</icon>
	

A tym razem ikona będzie przedstawiana jako pojedyncza, statyczna grafika.

[edit] A teraz pakujemy!

Skompresuj katalog Mój-pierwszy-zestaw-ikon do archiwum ZIP Mój-pierwszy-zestaw-ikon.zip przy użyciu Swojego Ulubionego Programu Archiwizującego^TM. Pamiętaj, że nazwa archiwum musi być identyczna jak nazwa katalogu. Teraz, zmień nazwę archiwum na Mój-pierwszy-zestaw-ikon.jisp. Możesz teraz używać swój pierwszy zestaw ikon i go rozpowszechniać.

Zestaw ikon instaluje się poprzez skopiowanie go do odpowiedniego podkatalogu katalogu iconsets w katalogu instalacyjnym Psi lub katalogu profilu wskazywanym przez zmienną środowiskową PSIDATADIR.

Powodzenia przy tworzeniu pierwszego (i kolejnych) zestawów ikon! :)

[edit] Domyślne zestawy ikon Psi

[edit] Zestawy ikon systemowych

• Stellar: Aż do Psi-0.10, to był domyślny zestaw ikon systemowych dla Psi.

[edit] Zestawy ikon kontaktów

• Stellar: Aż do Psi-0.10, to był domyślny zestaw ikon kontaktów dla Psi.
• Stellar Transport: Aż do Psi-0.10, to był domyślny zestaw ikon dla agentów, transportów i usług dla Psi.
• Stellar ICQ:
• Lightbulb:
• AIM:
• ICQ:
• Yahoo:
• MSN: