Podręcznik użytkownika
1. Instalacja
1.1 Windows
Dla systemów Windows przygotowano paczki ze skompilowanym programem w wersji instalacyjnej oraz archiwum gotowe do uruchomienia.
1.2 Linux
W systemach Linux sugerowaną metodą instalacji jest kompilacja programu z kodu źródłowego. W celu ułatwienia tego procesu przygotowano skrypt build.sh. Sposób użycia:
wejdź do katalogu ze źródłami ECO oraz wtyczek
i uruchom: ./build.sh --release
Wymagane są biblioteki deweloperskie QT w wersji 4.6 lub nowszej.
Udostępniona jest także skompilowana wersja binarna dla i386. W kolejnych wersjach przewidywane są paczki .deb oraz .rpm dla popularnych dystrybucji.
Najnowszą działającą wersję kodu źródłowego możesz pobrać także z repozytorium SVN:
svn://svn.code.sf.net/p/open-eco/code/trunk
1.3 Instalacja wtyczek.
Pobrane pliki .plug (lub .pin) oraz .dll (lub .so) wystarczy umieścić w katalogu 'plugins', będą one automatycznie rozpoznane przez program i gotowe do uruchomienia w managerze wtyczek.
2. Wstępne wymagania.
Program do działania wymaga jedynie bibliotek QT, które dla wersji Windows są już w paczce. Użytkownicy Linux powinni zaopatrzyć system przynajmniej w skompilowane biblioteki umożliwiające korzystanie z programów używających QT w wersji 4.6 lub nowszej. Ilość zużywanych zasobów zależy od uruchomionych rozszerzeń oraz sposobu korzystania z programu. Minimalna granicą jest 128MB pamięci operacyjnej.
3. Podstawowe funkcje
Po uruchomieniu programu, w tacce systemowej pojawi się ikona ECO. Jej aktywacja spowoduje wyświetlenie menu, które domyślnie udostępnia przyciski:
- Wyczyść historię - usuwa wszystkie pozycje z historii schowka
- Ustawienia - uruchamia okno konfiguracji
- Manager wtyczek - uruchamia okno zarządzania rozszerzeniami
- O programie - pokazuje okno informacyjne
- Zakończ - kończy działanie programu
Oprócz powyższych, widoczna jest również zmienna ilość przycisków przechowujących zawartości kopiowanych wcześniej elementów, zwanych dalej slotami. W zależności od uruchomionych wtyczek, pojawić się też mogą dodatkowe przyciski obsługujące rozszerzone funkcje.
4. Konfiguracja.
4.1 Ustawienia ogólne
Ustawienia ogólne pozwalają zdecydować o zachowaniu i prezentacji informacji. Najważniejsze ustawienia:
- pole wyboru: 'usuwaj wybrany slot' - kiedy to pole jest zaznaczone, aktywowanie wybranego slotu w menu oznacza jego 'przejście' na najwyższą pozycje i usunięcie z aktualnie zajmowanego miejsca. Jeżeli pole nie jest zaznaczone, pozycja w menu zostanie powielona.
- Pole wyboru: 'pokazuj zawartość w podpowiedziach' - kiedy to pole jest zaznaczone, pokazywane są podpowiedzi dla slotów, których zawartością jest przybliżona treść wybranej pozycji. Ustawienie to przydatne jest szczególnie podczas kopiowania wielu bardzo podobnych tekstów.
- 'język' - wybór języka interfejsu, do wyboru są dwa języki: polski oraz angielski, dodatkowo użytkownik może wybrać własny plik z tłumaczeniem.
- Ustawienia czcionek - osobne czcionki dla przycisków stałych oraz dla slotów edytować możemy za pomocą okna edycyjnego wyświetlanego po kliknięciu przycisku 'wybierz' przy danej czcionce. Tekstowy opis czcionki widać w wyznaczonych polach, które także można edytować.
- 'zapisuj historie' - jeżeli to pole jest zaznaczone, historia zostanie zapisana i odtworzona przy kolejnym uruchomieniu programu.
- 'ilość slotów' - określa maksymalną liczbę pozycji w historii, w obecnej wersji liczba slotów nie jest ograniczona, jednak nie istnieje jeszcze możliwość przewijania historii w wypadku gdy ich liczba przekracza pojemność ekranu.
4.2 Wygląd
Ustawienia wyglądu dotyczą wyboru skórki ECO. Skórki można dodawać lub usuwać z katalogu 'themes', jej wybór ma wpływ nie tylko na główne menu, ale także na ikonę w tacce systemowej oraz szerokość slotów. Zaawansowana konfiguracja wyglądu znajduje się poniżej.
4.3. Konfiguracja wtyczek
Wtyczki nie muszą posiadać własnych okien konfiguracyjnych. Istnieje możliwość zintegrowania formularzy z głównym oknem konfiguracyjnym ECO. Po aktywacji modułu jego konfiguracja jest wyświetlona jako odrębna pozycja w oknie ustawień. Nazwa działu jest wyznaczona przez wtyczkę i najczęściej jest ona jej nazwą.
4.4 Zaawansowana konfiguracja motywów
Motywy graficzne dla programu ECO znajdują się w katalogu 'themes', a ich pliki można dowolnie edytować. Oprócz plików graficznych *.png w katalogu z motywem znajduje się plik konfiguracyjny theme.etcf, w którym opisane zostały dodatkowe informacje o wyglądzie. Nie istnieje jeszcze żaden moduł pozwalający na edycje pliku theme.etcf z poziomu programu, dlatego trzeba go edytować ręcznie. Skład tego pliku wygląda następująco:
- hover_color=00F00032; - kolor podświetlenia po najechaniu kursorem.
- active_slot_color=EEF0EE30; - kolor podświetlenia aktywnego slotu
- pressed_color=00550032; - kolor przycisku podczas kliknięcia
- bgcolor=111111FF; - kolor tła dla głównego menu
- scroll_color=00FF00FF; - kolor paska przewijania
- slot_font_color=CCCCCCFF; - kolor czcionki dla slotów
- button_font_color=BBBBBBFF; - kolor czcionki dla przycisków
- button_edge_width=5; - rozmiar krawędzi przycisku (obszar ten nie będzie skalowany)
- separator_height=5; - odstęp między przyciskami a slotami
- initial_width=350; - szerokość głównego menu zaraz po załadowaniu motywu
- button_height=-1; - wysokość pojedynczego przycisku, gdy ustawiono wartość -1, przycisk przyjmie wysokość z pliku PNG
- shaped=0; - jeżeli ustawiono wartość 1, główne okno przyjmie maskę przezroczystości z plików PNG ramki
- bgstyle=none; - styl tła, przyjmuje wartości 'none' kiedy brak graficznego tła, 'tile' - kafelkowe tło z pliku background.png, 'scale' skalowane tło z pliku background.png
- logo_left=1; - odległość loga od lewego brzegu menu
- logo_top=1; - odległość loga od górnej krawędzi menu
- author=unknown; - informacje o autorze motywu
- name=ECO SKIN for KDE4; - nazwa motywu
- version=1.0; - wersja motywu
Zapis kolorów użytych w pliku palette.cfg ma składnie RGBA i jest zapisany w systemie szesnastkowym, gdzie: R - czerwony, G - zielony, B - niebieski, A - kanał alpha (przezroczystość). Wartości kolorów muszą mieścić się w przedziale 0 - 255.
Podświetlanie przycisków definiuje wpis hover_color, jednak istnieje możliwość podświetlenia nieregularnego. Jeżeli w katalogu z motywem umieszczony zostanie plik button_mask.png, jego zawartość zostanie użyta jako zamiennik dla podświetlenia.
Więcej informacji o plikach graficznych i konfiguracji motywów znajdziesz komentarzach pliku theme.etcf.