arcanis.me/ru/_posts/2014-12-19-aw-v21-bells-and-whistles.md
2016-04-11 03:23:32 +03:00

9.4 KiB
Raw Blame History

category type hastr layout tags title short
ru paper true paper awesome-widgets, pytextmonitor Awesome Widgets - свистелки и перделки aw-v21-bells-and-whistles

Данная статья посвящена обсуждению настройки своих скриптов и графических баров в новой версии Awesome Widgets (2.1).

Введение

Для начала, я настоятельно рекомендую для после обновления не открывая настроек виджета скопировать в безопасное место файл $HOME/.kde4/share/config/extsysmon.conf, так как старые настройки кастомных скриптов теперь несовместимы. Вообще, следует заметить, что все фичи можно настраивать и из графического интерфейса, однако я опишу, как это делается простым редактированием desktop файлов.

Общее

Все элементы хранятся в двух директориях: /usr/share/awesomewidgets/%TYPE%/ и $HOME/.local/share/awesomewidgets/%TYPE%/ (пути могут немного отличаться в зависимости от используемого дистрибутива). Настройки в домашней директории перезаписывают глобальные настройки.

Бары

Директория называется desktops, файлы настроек имеют следующие поля:

Поле Обязательное Значение По-умолчанию
Name да имя бара none
Comment нет комментарий empty
X-AW-Custom да содержит ли значение произвольную формулу или нет false
X-AW-Value да значение бара. Доступны теги cpu*, gpu, mem, swap, hdd*, bat. В случае X-AW-Custom=true использует синтаксис аналогичный []лямбда функциям](/ru/projects/awesome-widgets/#lambda) cpu
X-AW-Max нет максимально возможное значение 100.0
X-AW-Min нет минимально возможное значение 0.0
X-AW-Count нет число точек, используется при X-AW-Type=Graph 100
X-AW-ActiveColor да заполнение активной части в формате R,G,B,A или полный путь к изображению 0,0,0,130
X-AW-InactiveColor да заполнение неактивной части в формате R,G,B,A или полный путь к изображению 255,255,255,130
X-AW-Type да тип бара. Поддерживаемые типы Horizontal, Vertical, Circle, Graph Horizontal
X-AW-Direction да направление заполнения. Доступны варианты LeftToRight, RightToLeft LeftToRight
X-AW-Height да высота в пикселях 100
X-AW-Width да ширина в пикселях 100
X-AW-Number да уникальный номер, который будет ассоциирован с данным баром случайное число меньше 1000

Котировки

Для получения данных используется API Yahoo! Finance. Директория называется quotes, файлы настроек имеют следующие поля:

Поле Обязательное Значение По-умолчанию
Name да имя котировок none
Comment нет комментарий empty
X-AW-Ticker да тикер из системы Yahoo! Finance EURUSD=X
X-AW-Active нет активны или нет данные котировки true
X-AW-Interval да интервал запуска котировок в стандартных интервалах обновления виджета 1
X-AW-Number да уникальный номер, который будет ассоциирован с данными котировками случайное число меньше 1000

Скрипты

Директория называется scripts, файлы настроек имеют следующие поля:

Поле Обязательное Значение По-умолчанию
Name да имя скрипта none
Comment нет комментарий empty
Exec да путь к исполняемому файлу /usr/bin/true
X-AW-Prefix нет префикс к исполняемому файлу. Обычно не требуется, однако в отдельных случаях может потребоваться явно указать путь, например, к используемому интерпретатору
X-AW-Active нет активен или нет данный скрипт true
X-AW-Redirect нет перенаправление потоков сообщений. Доступны варианты stderr2stdout, nothing, stdout2stderr, swap. stderr доступен, если запустить в режиме отладки nothing
X-AW-Interval да интервал запуска скрипта в стандартных интервалах обновления виджета 1
X-AW-Number да уникальный номер, который будет ассоциирован с данным скриптом случайное число меньше 1000
X-AW-Filters нет фильтры из awesomewidgets-extscripts-filters.json разделенные запятой

Обновления

Директория называется upgrade, файлы настроек имеют следующие поля:

Поле Обязательное Значение По-умолчанию
Name да имя скрипта обновлений none
Comment нет комментарий empty
Exec да путь к исполняемому файлу /usr/bin/true
X-AW-Filter нет регулярное выражение, которое будет применено к выдаче команды. Если не пустое, параметр X-AW-Null будет проигнорирован
X-AW-Active нет активен или нет данный скрипт обновления true
X-AW-Null нет число строк stdout, которые будут пропущены при подсчете 0
X-AW-Interval да интервал запуска скрипта в стандартных интервалах обновления виджета 1
X-AW-Number да уникальный номер, который будет ассоциирован с данным скриптом случайное число меньше 1000

Погода

Для показа погоды используются данные и API [Yahoo! Weather] (//weather.yahoo.com/ "Сайт Yahoo! Weather"). Директория называется weather, файлы настроек имеют следующие поля:

Поле Обязательное Значение По-умолчанию
Name да имя погоды none
Comment нет комментарий empty
X-AW-City да город London
X-AW-Country да двухбуквенное обозначения страны uk
X-AW-Image нет использовать изображения в качестве иконки погоды или текст uk
X-AW-TS да на какое время прогноз (целое число). 0 - текущая погода, 1 - погода через 3 часа и т.д. 0
X-AW-Active нет активен или нет данный монитор погоды true
X-AW-Interval да интервал запуска монитора в стандартных интервалах обновления виджета 1
X-AW-Number да уникальный номер, который будет ассоциирован с данным монитором случайное число меньше 1000