From f867212c1762e156553d039319b904a17f7b563d Mon Sep 17 00:00:00 2001 From: tpearson Date: Fri, 19 Feb 2010 18:17:02 +0000 Subject: Added KDE3 version of knutclient git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/knutclient@1092914 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/cs/Makefile.am | 2 + doc/cs/asetting-cs.png | Bin 0 -> 22228 bytes doc/cs/fsetting-cs.png | Bin 0 -> 23450 bytes doc/cs/index.docbook | 1332 ++++++++++++++++++++++++++++++++++++++++++++++ doc/cs/knutclient-cs.png | Bin 0 -> 42103 bytes doc/cs/ksetting-cs.png | Bin 0 -> 21873 bytes doc/cs/mkicker-cs.png | Bin 0 -> 33881 bytes doc/cs/msetting-cs.png | Bin 0 -> 22388 bytes doc/cs/new-cs.png | Bin 0 -> 14626 bytes doc/cs/psetting-cs.png | Bin 0 -> 21681 bytes doc/cs/tkicker-cs.png | Bin 0 -> 11405 bytes doc/cs/usetting-cs.png | Bin 0 -> 17963 bytes doc/cs/variables-cs.png | Bin 0 -> 18185 bytes 13 files changed, 1334 insertions(+) create mode 100755 doc/cs/Makefile.am create mode 100755 doc/cs/asetting-cs.png create mode 100755 doc/cs/fsetting-cs.png create mode 100755 doc/cs/index.docbook create mode 100755 doc/cs/knutclient-cs.png create mode 100644 doc/cs/ksetting-cs.png create mode 100644 doc/cs/mkicker-cs.png create mode 100755 doc/cs/msetting-cs.png create mode 100755 doc/cs/new-cs.png create mode 100755 doc/cs/psetting-cs.png create mode 100644 doc/cs/tkicker-cs.png create mode 100755 doc/cs/usetting-cs.png create mode 100644 doc/cs/variables-cs.png (limited to 'doc/cs') diff --git a/doc/cs/Makefile.am b/doc/cs/Makefile.am new file mode 100755 index 0000000..f097f05 --- /dev/null +++ b/doc/cs/Makefile.am @@ -0,0 +1,2 @@ +KDE_DOCS = knutclient +KDE_LANG = cs diff --git a/doc/cs/asetting-cs.png b/doc/cs/asetting-cs.png new file mode 100755 index 0000000..8961947 Binary files /dev/null and b/doc/cs/asetting-cs.png differ diff --git a/doc/cs/fsetting-cs.png b/doc/cs/fsetting-cs.png new file mode 100755 index 0000000..28c3966 Binary files /dev/null and b/doc/cs/fsetting-cs.png differ diff --git a/doc/cs/index.docbook b/doc/cs/index.docbook new file mode 100755 index 0000000..26991f5 --- /dev/null +++ b/doc/cs/index.docbook @@ -0,0 +1,1332 @@ + +KNutClient'> + + + + + +]> + + + + + + + + + + +Příručka pro &knutclient; + + + +Daniel + +Prynych + +
Daniel@prynych.cz
+
+
+
+ + + +2001 +2002 +2003 +2004 +2006 +2007 +2008 +2009 +Daniel Prynych + + + +&FDLNotice; + + + +3/2/2008 +0.12.01 + + + + + +&knutclient; je grafická klientská aplikace pro UPS systém NUT. + + +Tento dokument popisuje aplikaci &knutclient; verze 0.9.5 + + + + +KDE +kdeutils +KNutClient +NUT +UPS + + +
+ + + +Úvod + + +&knutclient; je program který umožňuje sledovat stav UPS-ek systému NUT. + + + + +Použití &knutclient; + + + +Hlavní okno aplikace &knutclient; + +&knutclient; je klientská grafická aplikace pro systém NUT +"Network UPS Tools". Umožňuje sledovat stav UPS-ek a zobrazovat +hodnoty proměnných které vybraná UPS-ka a její ovladač podporuje. + + + +Od verze 0.6.0 &knutclient; podporuje spouštění okamžitých příkazů, +a možnost změny RW proměnných. + + +Od verze 0.9.0 nepodporuje &knutclient; protokol UDP. + + + + +Hlavní okno aplikace &knutclient; + + + + + + + + +Hlavní okno programu je rozděleno na dvě části. + + +Levé část "Hlavní panel" obsahuje následující údaje indikující stav vybrané +UPS-ky. +Provoz na síť, provoz na baterie, přetížení, nutnost vyměnit +baterii, vybití baterie, kalibraci baterie, údaj o dobu běhu +po odpojení sítě (RUNTIME) a pod. Déle jsou zde neměnné údaje, to jsou údaje +které se za provozu nemění a jsou proto přečteny jen jednou při výběru UPS-ky, +například jméno UPS-ky, její sériové číslo, výrobce a pod. + +Pravá část obsahuje analogové panely (měřáky), které udávají hodnotu +proměnných +veličin jako je vstupní napětí, zatížení UPS-ky, kapacitu baterie, teplotu +UPS-ky, +napětí baterie apod. + + +&knutclient; obsahuje nástrojovou lištu (toolbar) ze standardními tlačítky a +tlačítko pro výběr sledované UPS-ky. + + + + + + +&knutclient; a panel KDE + + + +&knutclient; a panel KDE + + + + + + + + +Od verze 0.8.0 &knutclient; dokuje v panelu KDE. Jeho icona je proměnná a zobrazuje +informace o zatížení UPS, runtime a a kapacitě baterie, podle toho který typ icony je vybrán. +Po přesunu ukazatele myši na ikonu se zobrazí informační okno "ToolTip" které obsahuje více +informací o UPS, Nazev, Jméno, Adresu, Stav, Runtime ... + + + + + +Více o vlastnostech &knutclient; + + +Pro spojení se serverovou části NUT-u (upsd) používá &knutclient; +protokol, TCP.Po vybraní UPS-ky v nástrojové liště se +&knutclient; pokusí přečíst data, pokud se mu to nepodaří, pokus opakuje +a to maximálně 2 krát. &knutclient; poté čte data v pravidelných +intervalech. Při prvním čtení čte všechny vybrané proměnné, v dalších +již jen proměnné které zobrazují analogové panely, RUNTIME a stav +UPS-ky. Proměnné zobrazující jméno UPS-ky, výrobce, sériové číslo a pod +se tedy čtou jen jednou protože se nepředpokládá jejich změna. + + +Novější verze upsd (od verze 1.3), již nepodporují protokol UDP. + + + +Chyby vznikající za běhu programu se zobrazují ve stavové lište. Do stavové +lišty +je vnořen seznam (ComboBox), ktery obsahuje hlašení chyb, a to včetne datumu, +času a nazvy UPS-ky. Maximální délka seznamu je 50 řádek. + + +Chyby vznikající jako odezva na činnost uživatele jsou zobrazeny ve +zvláštním okně. + + + + + +Popis příkazů + + + + +Hlavní okno aplikace &knutclient; + + + + +Menu Soubor + + + + + Soubor + Zobrazení Ups proměnných a příkazů + + Vypíše Ups proměnné pro zvolenou +UPS-ku + + + + Soubor + Spuštění okamžitých příkazů + + Provede na UPS daný okamžitý +příkaz + + + + Soubor + Nastavení UPS RW proměnných + + + Provede změnu UPS RW proměnné + + + + + Ctrlq + + Soubor + Ukončit + + Ukončí činnost programu + + + + + + + +Menu Spojení + + + + + + F1 + + Spojení + Obnovit Spojeni + + Obnoví spojení s UPS serverem (upsd). + + + + + + + + + +Menu Nastavení + + + + + Nastavení + Zobrazovat nástrojovou lištu + + Zapne/Vypne zobrazení nástrojové lišty +(Toolbar) + + + + + Nastavení + Zobrazovat stavovou lištu + + Zapne/Vypne zobrazování nástrojové +lišty + + + + + + Nastavení + Nastavení klávesových zkratek... + + + Otevře konfigurační dialog pro přiřazení klávesy k akci. + + + + + + + Nastavení + Nastavit &knutclient; + + + Otevře hlavni konfigurační dialog + + + + + + Nastavení + Použít popis + + + Zapne/Vypne používání bublinové nápovědi (ToolTip) při + zobrazení UPS proměnných a příkazů. + + + + + + + + + + + +Icona v panelu KDE + + + +Menu icony v KDE panelu + + + + + + + + + + + + + +Menu + + + + + UPS + + Slouží pro výběr UPS-ky + + + + + + + Zobrazení Ups proměnných a příkazů + + Vypíše Ups proměnné pro zvolenou +UPS-ku + + + + + Spuštění okamžitých příkazů + + Provede na UPS daný okamžitý +příkaz + + + + + Nastavení UPS RW proměnných + + + Provede změnu UPS RW proměnné + + + + + Obnovit Spojeni + + + Obnoví spojení s UPS serverem (upsd) + + + + + Nastavení + Nastavit &knutclient; + + + Aktivuje konfigurační dialog + + + + + + O aplikaci &knutclient; + + + Zobrazí informace o aplikaci &knutclient; + + + + + Minimalizovat + + + Zavře hlavní okno + + + + + Konec + + Ukončí činnost programu + + + + + + + + + +Zobrazení proměnných + +Toto okno zobrazý seznam všech proměnných a okamžitých příkazů, které existují pro zvolenou UPS-ku. + + +Okno proměnných a okamžitých příkazů + + + + + + + + + + + + Okamžité příkazy + + Okamžité příkazy jsou vykonávány přímo na na UPS-ce, NUT server + předává požadavek na příkaz příslušnému ovladači (driveru) a ten + pak příkaz vyvolá na UPS-ce. Okno pro ovládaní Vám nabízí ty + příkazy, které příslušný ovladač (driver) podporuje. + + + + + OK + + Tlačítko OK provede vybraný příkaz. + + + + Zrušit + + Tlačítko zrušit zavře okno. + + + + Příkaz + + Zde je možno vybrat příkaz který je pak následně vykonán + + + + + + + + Uživatelsky měnitelné (RW) proměnné + Uživatelsky měnitelné (RW) proměnné jsou skupinou + proměnných které muže měnit přímo uživatel, většina z nich je + přímo ekvivalentní nastavení příslušné UPS-ky. Uživatelsky + měnitelné proměnné jsou dvojího typu znakové (CHAR) a výčtové (ENUM). + Znakové proměnné jsou prostý řetězec znaků o definované maximální + délce. Výčtové proměnné je seznam povolených hodnot na které muže + být proměnná nastavená. + + + Uživatelsky měnitelné proměnná není změněna na serveru NUT-u + (upsd) ale sever pouze dá příslušnému ovladači (driveru) příkaz ke změně, + ten ihned provede změnu nastavení UPS-ky. Tato činnost není okamžitá a + může trvat i několik sekund. + + + + + OK + + Tlačítkem OK je změna proměnné provedena. + + + + Zrušit + + Tlačítkem Zrušit je okno zavřeno. + + + + Implicitní + + Tlačítkem Implicitní mužeme obnovit současnou hodnotu proměnné. + + + + Proměnná + + Zde je možno vybrat proměnnou která bude změněna + + + + Hodnota + + Zde je možno u znakové proměnné zadat, nebo u + výčtové proměnné vybrat její hodnotu. Nabídkové pole se automaticky mění + podle typu proměnné. + + + + + + + + + +Nastavení aplikace &knutclient; + +Okno pro nastavení má pět částí Nastavení, UPS, Panel Písma a Analog. + + + Nastavení + + Část NASTAVENÍ slouží pro nastavení počtu sloupců analogových panelů, barvy +pozadí hlavního okna, + vstupního napětí (120/230)V, frekvence vstupního napětí (50/60)Hz a povolení +použití hodnot + Xfer (LowXfer a HighXfer) + + + + &knutclient; + + + + + + + + + + + Počet sloupců + + Určuje maximální počet sloupců pro analogové panely + + + + Použít vlastní barvu pozadí + + Dovoluje zvolit vlastní barvu pozadí pro základní okno. + + + + + Barva pozadí + + Umožňuje zvolit barvu pozadí + + + + Použít dialog "Jste si jistý" + + Při aktivaci, se při ukončení programu objeví + dialog "Jste si jistý" který vyžaduje potvrzení, jinak + se program neukončí. + + + + + Použít hlavní okno když program startuje + + Nastaví zobrazení hlavního okna při startu programu. + + + + + + Zobrazit okno zpráv, když program hlásí chybu. + + Povoli zobrazení okna zpráv, kde je zobrazen popis chyby. Má význam jen, když není zakázáno dokování programu. + + + + + + + Vstupní napětí + + Umožňuje vybrat vstupní napětí 230/120V. Položka + nemá význam pokud je zároveň zvolena + položka Použít High-Low XFER. + + + + Vstupní frekvence + + Umožňuje vybrat vstupní frekvenci + 50/60Hz. Položka nemá význam pokud je zároveň zvolena + položka Použít High-Low + XFER. + + + + Použít High-Low XFER + + Nastaví vstupní napětí a vstupní frekvenci na + základě hodnot v proměnných NUT-u LOWXFER a + HIGHXFER. Tyto proměnné udávají rozpětí hodnot vstupního + napětí, které muže UPS-ka ještě bezpečně zpracovat. Na + základě těchto hodnot &knutclient; nastaví vstupní + napětí a vstupní frekvenci pro panely které je + používají. Například vstupní napětí, vstupní frekvence + apod. + + + + + + + + UPS + + Část UPS slouží pro nastavení seznamu UPS-ek a jejich + parametrů. Levá část obsahuje seznam UPS-ek. Pravá část tlačítka pro + přidávání, změnu parametrů a smazání záznamu o UPS-kách. + + + + &knutclient; + + + + + + + + + + + Přidat + + Přidá do seznamu další UPS-ku a nastaví její parametry. + + + + + Úpravy + + Změní parametry vybrané UPS-ky + + + + Smazat + Smaže UPS-ku v seznamu + + + + + + Nastavení parametrů + + Toto okno slouží k nastavení parametrů UPS-ky. + + + + + + + + + + + + + + Název + + Určuje jméno UPS-ky pro program &knutclient; + + + + Adresa UPS + + Určuje adresu počítače ke kterému je UPS připojena. + Tedy adresu UPS v síti. + Příklad : ns.alo.cz, localhost, 192.168.1.12. + + + + Jméno UPS + + Určuje jméno UPS tak jak je definuje NUT. + Pokud není ups definováno, je automaticky použita první ups v seznamu + systému NUT daného pc. To platí jen za předpokladu že minimalní + verze upsd je 1.3. Blíže v dokumentaci k systému NUT. + Příklad : victron, myups, apc700 + + + + Zpoždění (ms) + + Určuje interval mezi dvěma přenosy dat (čteni dat) ze + systému NUT. + + + + Port + + + Nastaví port na který se &knutclient; připojí. + + + + + Uživatelské jméno + + Určuje uživatelské jméno (USERNAME) které + &knutclient; použije při prokázaní totožnosti uživatele + serveru to jest, programu upsd + + + + Heslo + + Určuje heslo (PASSWORD) pro pro prokázaní + totožnosti uživatele. + + + + Store NUT password in configuration file. + + + Při zvolení této volby bude heslo uloženo do + konfiguračního souboru. V konfiguračním souboru je + heslo uloženo nezašifrovaně. Pokud nebude tato volba + zvolena bude heslo po ukončení programu zapomenuto. + + + + + UPS Proměnné + + Umožňuje vybrat proměnné které budou zobrazeny + na analogových panelech v pravé části hlavního + okna. + + + + + Parametry Uživatelské jméno a Heslo mají význam jen + pri použití okamžitých příkazů a změnách RW proměnných, při + sledování stavu UPS-ky není uživatelské jméno a heslo + potřebné. Heslo (PASSWORD) a uživatelské jméno (USERNAME) + mají své ekvivalenty v systému NUT v souboru upsd.users. + + + + + + + + Panel + + Část PANEL slouží pro určení které informační části hlavního panelu budou +zobrazené + + + + + &knutclient; + + + + + + + + + + + + + Přetížení + + + Povoluje/zakazuje zobrazení přetížení. + + + + + + Baterie je vybitá + + + Povoluje/zakazuje zobrazení vybití baterie. + + + + + + + Vyměnit baterie + + + Povoluje/zakazuje zobrazení nutnosti výměny baterie. + + + + + + Kalibrace UPS + + + Povoluje/zakazuje zobrazení kalibrace UPS. + + + + + + Výrobce + Model + + + Povoluje/zakazuje zobrazení výrobce a modelu UPS-ky. + + + + + + Výrobce + + + Povoluje/zakazuje zobrazení výrobce UPS-ky. + + + + + + Model + + + Povoluje/zakazuje zobrazení modelu UPS-ky. + + + + + + Sériové č. + + + Povoluje/zakazuje zobrazení sériového čísla UPS-ky. + + + + + + Verze Firmvare + + + Povoluje/zakazuje zobrazení verze firmware UPS-ky. + + + + + + Runtime + + + Povoluje/zakazuje zobrazení doby po kterou je UPS-ka schopna po výpadku + napájení dodávat el. proud. + + + + + + Použít vlastní barvu pozadí + + Dovoluje zvolit vlastní barvu pozadí pro hlavní panel. + + + + + Barva pozadí + + Umožňuje zvolit barvu pozadí pro hlavní panel. + + + + + + + + + + Písma + + Část PÍSMA slouží pro výběr používaných písmen. + + + + &knutclient; + + + + + + + + + + + + Použít vlastní písma + + + Povoluje/zakazuje možnost vybrat vlastní písma pro Hlavni panel a Analogové +panely. + + + + + Hlavní panel / Analogové panely + + Určuje pro který panel se bude vybírat písmo. + + + + Požadované písmo + + Vybírá písma pro zadaný typ panelu. Má význam + jen tehdy pokud je vybrána položka Použít + vlastní písmo. + + + + + + + + + Analog + + Část Analog slouží pro nastavení barev na analogových panelech. + + + + &knutclient; + + + + + + + + + + + + + Použít vlastní barvu pozadí + + Dovoluje zvolit vlastní barvu pozadí pro analogový panel. + + + + + Barva pozadí + + Umožňuje zvolit barvu pozadí pro analogový panel. + + + + + + Použít vlastní barvy + + Dovoluje zvolit vlastní barvy pro následující části analogového panelu. + + + + + + Barva ručičky + + + Umožňuje zvolit barvu ručičky pro analogový panel. Standardní barva + je černá. + + + + + + + Barva OK rozsahu + + + Umožňuje zvolit barvu podbarvení stupnice pro rozsah správných (OK) + hodnot. Standardní barva je zelená. + + + + + Barva rozsahu varování + + + Umožňuje zvolit barvu podbarvení stupnice pro rozsah varovaní. + Standardní barva je žlutá. + + + + + + + Barva rozsahu chyby + + + Umožňuje zvolit barvu podbarvení stupnice pro rozsah chyby. + Standardní barva je červená. + + + + + + Barva stupnice + + + Umožňuje zvolit barvu stupnice pro analogový panel. + Standardní barva je černá. + + + + + + Barva písma + + + Umožňuje zvolit barvu písma pro analogový panel. + Standardní barva je černá. + + + + + + + Vylepšení zpracování ručičky + + + Umožňuje vybrat grafický způsob zpracování ručičky. + + + + + + + + + + + + Dokovaní + + Část DOCK slouží pro nastavení parametrů "dokovaní" programu. + + + + &knutclient; + + + + + + + + + + Typ zobrazení v doku. (Dokem je míněn panel KDE.) + + + + + + + + Obrázkové + + + Nastavuje obrazkový typ icony. + + + + + + + Obrázkové + + + Nastavuje souhrny typ icony, pouze pro specialisty. + + + + + + + + + Prvky ToolTipu. (ToolTipem je míněna "bublinova" napověda.) + + + + + + Výrobce + + + Povoluje/zakazuje zobrazení výrobce UPS-ky. + + + + + + Model + + + Povoluje/zakazuje zobrazení modelu UPS-ky. + + + + + + Sériové č. + + + Povoluje/zakazuje zobrazení sériového čísla UPS-ky. + + + + + + Verze Firmvare + + + Povoluje/zakazuje zobrazení verze firmware UPS-ky. + + + + + + Runtime + + + Povoluje/zakazuje zobrazení doby po kterou je UPS-ka schopna po výpadku + napájení dodávat el. proud. + + + + + + Kapacita baterie + + + Povoluje/zakazuje zobrazení kapacity baterie. + + + + + + + Zatížení UPS + + + Povoluje/zakazuje zobrazení zatížení UPS. + + + + + + + Použít vlastní barvu pozadí + + Dovoluje zvolit vlastní barvu pozadí pro iconu v KDE panelu, když typ zobrazení icony v panelu je obrázkový. + + + + + Barva pozadí + + Umožnuje zvolit barvu pozadí. + + + + + + + + + + + + + +Otázky a odpovědi + +&reporting.bugs; +&updating.documentation; + + + + +&knutclient; nepracuje ale program upsc ano. Co mam dělat ? + + + Zkontrolujte nastaveni čísla portu. Od ver. 0.5 (NUT) je změněno číslo +portu 3493. +Klikněte na odkaz pro další +údaje. + + + + + + + + +Credits and License + +&knutclient; + + +Program copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008 Daniel Prynych Daniel@prynych.cz + + +Documentation copyright 2003, 2004, 2005, 2006, 2007, 2008 Daniel Prynych +Daniel@prynych.cz + + +Translations done by: + + +Daniel Prynych Daniel@prynych.cz Čeština + + + + +&underFDL; +&underGPL; + + + + +Instalace + +Jak získat &knutclient; + +&knutclient; není částí KDE projektu +http://www.kde.org. +&knutclient; může být nalezen na +ftp://ftp.buzuluk.cz/pub/alo/knutclient/ + + + + +Požadavky + + +Pro úspěšné použití &knutclient; potřebujete KDE 3.x.x + + + +Seznam změn můžete najít na +http://www.knut.noveradsl.cz/knutclient/. + + + + +Překlad a instalace + + +Pro překlad a instalaci &knutclient; napište následující příkazy v základním adresáři +Vaší &knutclient; aplikace. + + +% ./configure +% make +% make install + + + + +Od doby kdy KDE aplikace používají autoconf a automake, +nemůžete mít žádné problémy při překladu. Jestliže přesto vzniknou +nějaké problémy hlaste je prosím do KDE konference. + + + +&documentation.index; +
+ diff --git a/doc/cs/knutclient-cs.png b/doc/cs/knutclient-cs.png new file mode 100755 index 0000000..cb36d29 Binary files /dev/null and b/doc/cs/knutclient-cs.png differ diff --git a/doc/cs/ksetting-cs.png b/doc/cs/ksetting-cs.png new file mode 100644 index 0000000..ae4e047 Binary files /dev/null and b/doc/cs/ksetting-cs.png differ diff --git a/doc/cs/mkicker-cs.png b/doc/cs/mkicker-cs.png new file mode 100644 index 0000000..8c7f0c1 Binary files /dev/null and b/doc/cs/mkicker-cs.png differ diff --git a/doc/cs/msetting-cs.png b/doc/cs/msetting-cs.png new file mode 100755 index 0000000..6d41e04 Binary files /dev/null and b/doc/cs/msetting-cs.png differ diff --git a/doc/cs/new-cs.png b/doc/cs/new-cs.png new file mode 100755 index 0000000..3324d17 Binary files /dev/null and b/doc/cs/new-cs.png differ diff --git a/doc/cs/psetting-cs.png b/doc/cs/psetting-cs.png new file mode 100755 index 0000000..55ff9ce Binary files /dev/null and b/doc/cs/psetting-cs.png differ diff --git a/doc/cs/tkicker-cs.png b/doc/cs/tkicker-cs.png new file mode 100644 index 0000000..e662839 Binary files /dev/null and b/doc/cs/tkicker-cs.png differ diff --git a/doc/cs/usetting-cs.png b/doc/cs/usetting-cs.png new file mode 100755 index 0000000..c53b8dc Binary files /dev/null and b/doc/cs/usetting-cs.png differ diff --git a/doc/cs/variables-cs.png b/doc/cs/variables-cs.png new file mode 100644 index 0000000..da3a274 Binary files /dev/null and b/doc/cs/variables-cs.png differ -- cgit v1.2.1