From e04430e36c670ecd5a8e2578d5bf56e04a4a3340 Mon Sep 17 00:00:00 2001 From: arcan1s Date: Sat, 24 May 2014 17:09:08 +0400 Subject: [PATCH] added Ukrainian readme --- AUTHORS | 1 + CHANGELOG | 2 + CHANGELOG-RU | 2 + sources/ptm/po/{ua.po => uk.po} | 0 sources/readme/uk.md | 232 ++++++++++++++++++++++++++++++++ 5 files changed, 237 insertions(+) rename sources/ptm/po/{ua.po => uk.po} (100%) create mode 100644 sources/readme/uk.md diff --git a/AUTHORS b/AUTHORS index 4792656..ccb9b86 100644 --- a/AUTHORS +++ b/AUTHORS @@ -5,3 +5,4 @@ Translators: @Mermouy (French translation) Ernesto Avilés Vzqz (Spanish translation) @underr (Brazillian Portuguese translation) +Виктор Слободян (Ukrainian translation) diff --git a/CHANGELOG b/CHANGELOG index 82b11bb..5a740e5 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -1,7 +1,9 @@ Ver.1.9.1: ++ added ability for force update text + added support of hddtemp cmd + added support of clementine + added Brazillian Portuguese translation (@underr) ++ added Ukrainian translation (Виктор Слободян) * edited readme call Ver.1.9.0: diff --git a/CHANGELOG-RU b/CHANGELOG-RU index 6eb34aa..3bbc413 100644 --- a/CHANGELOG-RU +++ b/CHANGELOG-RU @@ -1,7 +1,9 @@ Вер.1.9.1: ++ добавлена возможность форсированного обновления + добавлена поддержка команды hddtemp + добавлена поддержка clementine + добавлен перевод Brazillian Portuguese (@underr) ++ добавлена украинская локализация (Виктор Слободян) * исправлен вызов readme под четырехсимвольное обозначение Вер.1.9.0: diff --git a/sources/ptm/po/ua.po b/sources/ptm/po/uk.po similarity index 100% rename from sources/ptm/po/ua.po rename to sources/ptm/po/uk.po diff --git a/sources/readme/uk.md b/sources/readme/uk.md new file mode 100644 index 0000000..143466b --- /dev/null +++ b/sources/readme/uk.md @@ -0,0 +1,232 @@ +pytextmonitor +============= + +Информация +---------- +PyTextMonitor - мінімалістичний плазмоїд, що написаний на Python2. Він виглядає, як віджети в Awesome WM. + +**УВАГА** [ПОТРІБНІ ПЕРЕКЛАДАЧІ!](https://github.com/arcan1s/pytextmonitor/issues/14) + +Налаштування +------------ +Для редагування зовнішного вигляду, відкрийте вікно налаштувань та встановіть потрібний формат в поля: +* тег `$time` - час у стандартному форматі. Наприклад, *fri Nov 6 04:48:01 2013* +* тег `$isotime` - час в ISO форматі +* тег `$shorttime` - час в короткому форматі +* тег `$longtime` - час в довгому форматі +* тег `$custom` - свій формат часу +* тег `$uptime` - час роботи, *---d--h--m* +* тег `$custom` - свій формат аптайму +* тег `$cpu` - загальне завантаження CPU, *%* +* тег `$cpuN` - завантаження CPU для ядра N, *%* +* тег `$cpucl` - середня частота CPU, *MHz* +* тег `$cpuclN` - частота CPU для ядра N, *MHz* +* тег `$tempN` - температура для пристрою N. Наприклад, `$temp0` +* тег `$gpu` - використання GPU, *%*. `aticonfig` або `nvidia-smi` мають бути встановлені +* тег `$gputemp` - температура GPU. `aticonfig` або `nvidia-smi` мають бути встановлені +* тег `$mem` - використання RAM, *%* +* тег `$memmb` - використання RAM, *MB* +* тег `$memgb` - використанняRAM, *GB* +* тег `$swap` - swap, *%* +* тег `$swapmb` - swap, *MB* +* тег `$swapgb` - swap, *GB* +* тег `$hddN` - використання точки монтування N, *%*. Наприклад, `$hdd0` +* тег `$hddmbN` - використання точки монтування N, *KB/s*. Наприклад, `$hddmb0` +* тег `$hddgbN` - використання точки монтування N, *KB/s*. Наприклад, `$hddgb0` +* тег `$hddrN` - швидкість запису на диск N, *KB/s*. Наприклад, `$hddr0` +* тег `$hddwN` - швидкість читання з диска N, *KB/s*. Наприклад, `$hddw0` +* тег `$hddtempN` - температура HDD N. Наприклад, `$hddtemp0` +* тег `$down` - швидкість завантаження, *KB/s* +* тег `$up` - швидкість віддачі, *KB/s* +* тег `$netdev` - поточний мережний інтерфейс +* тег `$bat` - заряд батареї, *%* +* тег `$ac` - статус адаптера живлення. Повертає `(*)`, якщо AC підключений або `( )`, якщо ні +* тег `$album` - альбом. Один з підтримуваних плеєрів повинен бути встановлений +* тег `$artist` - виконавець. Один з підтримуваних плеєрів повинен бути встановлений +* тег `$progress` - прогрес. Один з підтримуваних плеєрів повинен бути встановлений +* тег `$time` - тривалість. Один з підтримуваних плеєрів повинен бути встановлений +* тег `$title` - назва. Один з підтримуваних плеєрів повинен бути встановлений +* тег `$pscount` - кількість запущених процесів +* тег `$pstotal` - загальна кількість процесів +* тег `$ps` - перелік процесів +* тег `$pkgcountN` - кількість пакетів, що можуть бути оновлені, для команди N. Наприклад, `$pkgcount0` +* тег `$customN` - повертає результат своеї команди N. Наприклад, `$custom0` + +Порядок полів зміниться, якщо ви зміните позицію слайдерів. HTML теги в полях працюють коректно. + +**ЗАУВАЖЕННЯ** ви не зможете встановити тег `$cpu`, наприклад, в полі swap. **`$cpu` буде працювати тільки в полі CPU**. + +Розширені налаштування +---------------------- +**Свіой формат часу** + +* тег `$dddd` - день тижня у довгому форматі +* тег `$ddd` - день тижня у короткому форматі +* тег `$dd` - день +* тег `$d` - день без нуля +* тег `$MMMM` - місяць у довгому форматі +* тег `$MMM` - місяць у короткому форматі +* тег `$MM` - місяць +* тег `$M` - місяця без нуля +* тег `$yyyy` - рік +* тег `$yy` - рік у короткому форматіе +* тег `$hh` - години +* тег `$h` - години без нуля +* тег `$mm` - хвилини +* тег `$m` - хвилини без нуля +* тег `$ss` - секунди +* тег `$s` - секунди без нуля + +**Свій формат аптайму** + +* тег `$dd` - дні аптайму +* тег `$d` - дні аптайму без нуля +* тег `$hh` - години аптайму +* тег `$h` - години аптайму без нуля +* тег `$mm` - хвилини аптайму +* тег `$m` - хвилини аптайму без нуля + + +**Одиниці виміру температури** + +Оберіть одиниці виміру температур. Доступні такі одиниці: Цельсій, Фаренгейт та Кельвін. + +**Датчики температури** + +Перелік датчиків, що будуть спостерігатись в полі temo (вміст комбо боксу береться із `sensors`). Віджет можна редагувати, клавіша delete видаляє поточний рядок. + +**Точки монтування** + +Перелік точок монтування, які будуть спостерігатися в полі hdd (вміст комбо боксу береться із `mount`). Віджет можна редагувати, клавіша delete видаляє поточний рядок. + +**HDD (швидкість)** + +Перелік HDD, які будуть спостерігатися в полі hddspeed (вміст комбо боксу береться із DataEngine). Віджет можна редагувати, клавіша delete видаляє поточний рядок. + +**HDD (температура)** + +Перелік HDD, які будуть спостерігатися в полі hddtemp (вміст комбо боксу береться iз `find`). Віджет можна редагувати, клавіша delete видаляє поточний рядок. + +**Директорія з мережевими інтерфейсами** + +Шлях до директорії, яка містить інформацію про мережеві інтерфейси. За замовчуванням `/sys/class/net`. Потрібно для визначення мережевого пристрою. + +**Мережевий пристрій** + +Використовувати вказаний інтерфейс, як активний. Вміст комбо боксу береться із **директорії з мережевими інтерфейсами**. Ця опція вимкне авто визначення інтерфейсу. + +**Пристрій батареї** + +Файл з інформацією про батарею. Даний файл (`/sys/class/power_supply/BAT0/capacity` за замовчуванням) повинен містити тільки заряд батареї в процентах. + +**AC online тег** + +Рядок, що буде показаний, коли AC онлайн. + +**AC offline тег** + +Рядок, що буде показаний, коли AC оффлайн. + +**Пристрій AC** + +Файл з інформациею про адаптер живлення. Даний файл (`/sys/class/power_supply/AC/online` за замовчуванням) повинен містити `1`, якщо адаптер підключений. + +**Музичний плеєр** + +Оберіть один з підтримуваних музичних плеєрів. + +Налаштування тултіпу +-------------------- +Починаючи з версії 1.7.0 поля CPU, частота CPU, пам’ять, swap та мережа підтримують графічний тултіп. Щоб їх ввімкнути, просто зробіть необхідні чекбокси повністю чекнутими. Кількість зберігаємих значень може бути виставлена в даній вкладці. Кольори графікіф також налаштовуються. + +Налаштування DataEngine +----------------------- +**Своя команда** + +*ЗАУВАЖЕННЯ* Може призвести до зависання комп’ютера. + +Команда, що буде запущена для відповідного поля. + +**Пристрій GPU** + +Оберіть один з підтримуваних пристроїв GPU. `auto` ввімкне автоматичне визначення. За замовчуванням `auto`. + +**HDD** + +Оберіть один з HDD для контролю його температури. `all` ввімкне контроль для всих доступних пристроїв. За замовчуванням `all`. + +**Команда hddtemp** + +Оберіть команду, яка буде запущена для hddtemp DataEngine. За замовчуванням `sudo hddtemp`. + +**Адреса MPD** + +Адреса MPD серверу. За замовчуванням `localhost`. + +**Порт MPD** + +Порт MPD серверу. За замовчуванням `6600`. + +**Package manager** + +Перелік команд, які будуть запущені. кількість пустих рядків - кількість непотрібних для підрахунку рядків. Стандартні налаштування: +* *Arch*: `PKGCMD=pacman -Qu`, `PKGNULL=0` +* *Debian*: `PKGCMD=apt-show-versions -u -b`, `PKGNULL=0` +* *Ubuntu*: `PKGCMD=aptitude search '~U'`, `PKGNULL=0` +* *Fedora*: `PKGCMD=yum list updates`, `PKGNULL=3` +* *FreeBSD*: `PKGCMD=pkg_version -I -l '<'`, `PKGNULL=0` +* *Mandriva*: `PKGCMD=urpmq --auto-select`, `PKGNULL=0` + +Налаштування DataEngine +----------------------- +Ви можете відредагувати налаштування DataEngine вручну. Відкрийте файл `/usr/share/config/extsysmon.conf` або `$HOME/.kde4/share/config/extsysmon.conf`, в залежності від типу установки. Розкоментуйте потрібні рядки та відредагуйте їх. + +Інструкція +========== + +Залежності +---------- +* kdebase-workspace +* kdebindings-python2 +* lm_sensors (*для визначення датчиків температури*) +* sysstat (*для сповіщень*) + +Опціональні залежності +---------------------- +* проприєтарний відеодрайвер +* hddtemp (переконайтесь, що може бути запущений з `sudo` без пароля. Просто добавте наступний рядок в `/etc/sudoers`: `$USERNAME ALL=NOPASSWD: /usr/bin/hddtemp`) +* музичний плеєр (amarok, clementine, mpd или qmmp) + +Залежності збирання +------------------- +* automoc4 +* cmake +* kdebase-runtime + +Установка +--------- +* скачати вихідний архів +* встановити + + mkdir build && cd build + cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`kde4-config --localprefix` ../ + make && make install + + Для установки в `/`: + + mkdir build && cd build + cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` ../ + make && sudo make install + +Додаткова інформація +==================== + +TODO (wish list) +---------------- + +Посилання +--------- +* [Домашня сторінка](http://arcanis.name/projects/pytextmonitor/) +* Віджет на [kde-look](http://kde-look.org/content/show.php/Py+Text+Monitor?content=157124) +* DataEngine на [kde-look](http://kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773) +* Пакет для Archlinux в [AUR](https://aur.archlinux.org/packages/kdeplasma-applets-pytextmonitor/)