Podręcznik użytkownika

  1. 1. Instalacja
    1. 1.1 Windows
    2. 1.2 Linux
    3. 1.3 Instalacja wtyczek
  2. 2. Wstępne wymagania
  3. 3. Podstawowe funkcje
  4. 4. Ustawienia
    1. 4.1 Ustawienia ogólne
    2. 4.2 Wygląd
    3. 4.3 Konfiguracja wtyczek
    4. 4.4 Zaawansowana konfiguracja motywów

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.