arcanis.me/ru/_posts/2014-12-19-aw-v21-bells-and-whistles.html
2015-10-12 03:13:25 +03:00

328 lines
12 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
category: ru
type: paper
hastr: true
layout: paper
tags: awesome-widgets, pytextmonitor
title: Awesome Widgets - свистелки и перделки
short: aw-v21-bells-and-whistles
description: Данная статья посвящена обсуждению настройки своих скриптов и графических баров в новой версии Awesome Widgets (2.1).
---
<h2><a href="#intro" class="anchor" id="intro"><span class="octicon octicon-link"></span></a>Введение</h2>
<p>Для начала, я настоятельно рекомендую для после обновления <b>не открывая настроек виджета</b> скопировать в безопасное место файл <code>$HOME/.kde4/share/config/extsysmon.conf</code>, так как старые настройки кастомных скриптов теперь несовместимы. Вообще, следует заметить, что все фичи можно настраивать и из графического интерфейса, однако я опишу, как это делается простым редактированием desktop файлов.</p>
<h2><a href="#general" class="anchor" id="general"><span class="octicon octicon-link"></span></a>Общее</h2>
<p>Все элементы хранятся в двух директориях: <code>/usr/share/awesomewidgets/%TYPE%/</code> и <code>$HOME/.local/share/awesomewidgets/%TYPE%/</code> (пути могут немного отличаться в зависимости от используемого дистрибутива). Настройки в домашней директории перезаписывают глобальные настройки.</p>
<h2><a href="#bars" class="anchor" id="bars"><span class="octicon octicon-link"></span></a>Бары</h2>
<p>Директория называется <code>desktops</code>, файлы настроек имеют следующие поля:</p>
<table>
<tr>
<th>Поле</th>
<th>Обязательное</th>
<th>Значение</th>
<th>По-умолчанию</th>
</tr>
<tr>
<th>Name</th>
<td>да</td>
<td>имя бара. Должно иметь вид <code>barN</code> и быть уникальным</td>
<td>none</td>
</tr>
<tr>
<th>Comment</th>
<td>нет</td>
<td>комментарий</td>
<td>empty</td>
</tr>
<tr>
<th>X-AW-Value</th>
<td>да</td>
<td>значение бара. Доступны теги <code>cpu*</code>, <code>gpu</code>, <code>mem</code>, <code>swap</code>, <code>hdd*</code>, <code>bat</code></td>
<td>cpu</td>
</tr>
<tr>
<th>X-AW-ActiveColor</th>
<td>да</td>
<td>заполнение активной части в формате <code>R,G,B,A</code></td>
<td>0,0,0,130</td>
</tr>
<tr>
<th>X-AW-InactiveColor</th>
<td>да</td>
<td>заполнение неактивной части в формате <code>R,G,B,A</code></td>
<td>255,255,255,130</td>
</tr>
<tr>
<th>X-AW-Type</th>
<td>да</td>
<td>тип бара. Поддерживаемые типы <code>Horizontal</code>, <code>Vertical</code>, <code>Circle</code>, <code>Graph</code></td>
<td>Horizontal</td>
</tr>
<tr>
<th>X-AW-Direction</th>
<td>да</td>
<td>направление заполнения. Доступны варианты <code>LeftToRight</code>, <code>RightToLeft</code></td>
<td>LeftToRight</td>
</tr>
<tr>
<th>X-AW-Height</th>
<td>да</td>
<td>высота в пикселях</td>
<td>100</td>
</tr>
<tr>
<th>X-AW-Width</th>
<td>да</td>
<td>ширина в пикселях</td>
<td>100</td>
</tr>
<tr>
<th>X-AW-Number</th>
<td>да</td>
<td>уникальный номер, который будет ассоциирован с данным баром. Введено для совместимости с другими расширениями. Должно быть такое же, как и в поле Name</td>
<td>число из Name</td>
</tr>
</table>
<h2><a href="#quotes" class="anchor" id="quotes"><span class="octicon octicon-link"></span></a>Котировки</h2>
<p>Директория называется <code>quotes</code>, файлы настроек имеют следующие поля:</p>
<table>
<tr>
<th>Поле</th>
<th>Обязательное</th>
<th>Значение</th>
<th>По-умолчанию</th>
</tr>
<tr>
<th>Name</th>
<td>да</td>
<td>имя котировок</td>
<td>none</td>
</tr>
<tr>
<th>Comment</th>
<td>нет</td>
<td>комментарий</td>
<td>empty</td>
</tr>
<tr>
<th>X-AW-Ticker</th>
<td>да</td>
<td>тикер из системы Yahoo! Finance</td>
<td>EURUSD=X</td>
</tr>
<tr>
<th>X-AW-Active</th>
<td>нет</td>
<td>активны или нет данные котировки</td>
<td>true</td>
</tr>
<tr>
<th>X-AW-Interval</th>
<td>да</td>
<td>интервал запуска котировок в стандартных интервалах обновления виджета</td>
<td>1</td>
</tr>
<tr>
<th>X-AW-Number</th>
<td>да</td>
<td>уникальный номер, который будет ассоциирован с данными котировками</td>
<td>случайное число меньше 1000</td>
</tr>
</table>
<h2><a href="#scripts" class="anchor" id="scripts"><span class="octicon octicon-link"></span></a>Скрипты</h2>
<p>Директория называется <code>scripts</code>, файлы настроек имеют следующие поля:</p>
<table>
<tr>
<th>Поле</th>
<th>Обязательное</th>
<th>Значение</th>
<th>По-умолчанию</th>
</tr>
<tr>
<th>Name</th>
<td>да</td>
<td>имя скрипта</td>
<td>none</td>
</tr>
<tr>
<th>Comment</th>
<td>нет</td>
<td>комментарий</td>
<td>empty</td>
</tr>
<tr>
<th>Exec</th>
<td>да</td>
<td>путь к исполняемому файлу</td>
<td>/usr/bin/true</td>
</tr>
<tr>
<th>X-AW-Prefix</th>
<td>нет</td>
<td>префикс к исполняемому файлу. Обычно не требуется, однако в отдельных случаях может потребоваться явно указать путь, например, к используемому интерпретатору</td>
<td></td>
</tr>
<tr>
<th>X-AW-Active</th>
<td>нет</td>
<td>активен или нет данный скрипт</td>
<td>true</td>
</tr>
<tr>
<th>X-AW-Redirect</th>
<td>нет</td>
<td>перенаправление потоков сообщений. Доступны варианты <code>stderr2stdout</code>, <code>nothing</code>, <code>stdout2stderr</code>, <code>swap</code>. stderr доступен, если запустить в режиме отладки</td>
<td>nothing</td>
</tr>
<tr>
<th>X-AW-Interval</th>
<td>да</td>
<td>интервал запуска скрипта в стандартных интервалах обновления виджета</td>
<td>1</td>
</tr>
<tr>
<th>X-AW-Number</th>
<td>да</td>
<td>уникальный номер, который будет ассоциирован с данным скриптом</td>
<td>случайное число меньше 1000</td>
</tr>
<tr>
<th>X-AW-Filters</th>
<td>нет</td>
<td>фильтры из <code>awesomewidgets-extscripts-filters.json</code> разделенные запятой</td>
<td></td>
</tr>
</table>
<h2><a href="#upgrade" class="anchor" id="upgrade"><span class="octicon octicon-link"></span></a>Обновления</h2>
<p>Директория называется <code>upgrade</code>, файлы настроек имеют следующие поля:</p>
<table>
<tr>
<th>Поле</th>
<th>Обязательное</th>
<th>Значение</th>
<th>По-умолчанию</th>
</tr>
<tr>
<th>Name</th>
<td>да</td>
<td>имя скрипта обновлений</td>
<td>none</td>
</tr>
<tr>
<th>Comment</th>
<td>нет</td>
<td>комментарий</td>
<td>empty</td>
</tr>
<tr>
<th>Exec</th>
<td>да</td>
<td>путь к исполняемому файлу</td>
<td>/usr/bin/true</td>
</tr>
<tr>
<th>X-AW-Filter</th>
<td>нет</td>
<td>регулярное выражение, которое будет применено к выдаче команды. Если не пустое, параметр <code>X-AW-Null</code> будет проигнорирован</td>
<td></td>
</tr>
<tr>
<th>X-AW-Active</th>
<td>нет</td>
<td>активен или нет данный скрипт обновления</td>
<td>true</td>
</tr>
<tr>
<th>X-AW-Null</th>
<td>нет</td>
<td>число строк stdout, которые будут пропущены при подсчете</td>
<td>0</td>
</tr>
<tr>
<th>X-AW-Interval</th>
<td>да</td>
<td>интервал запуска скрипта в стандартных интервалах обновления виджета</td>
<td>1</td>
</tr>
<tr>
<th>X-AW-Number</th>
<td>да</td>
<td>уникальный номер, который будет ассоциирован с данным скриптом</td>
<td>случайное число меньше 1000</td>
</tr>
</table>
<h2><a href="#weather" class="anchor" id="weather"><span class="octicon octicon-link"></span></a>Погода</h2>
<p>Для показа погоды используются данные и API <a href="//openweathermap.org/" title="Сайт OpenWeatherMap">OpenWeatherMap</a>. Директория называется <code>weather</code>, файлы настроек имеют следующие поля:</p>
<table>
<tr>
<th>Поле</th>
<th>Обязательное</th>
<th>Значение</th>
<th>По-умолчанию</th>
</tr>
<tr>
<th>Name</th>
<td>да</td>
<td>имя погоды</td>
<td>none</td>
</tr>
<tr>
<th>Comment</th>
<td>нет</td>
<td>комментарий</td>
<td>empty</td>
</tr>
<tr>
<th>X-AW-City</th>
<td>да</td>
<td>город</td>
<td>London</td>
</tr>
<tr>
<th>X-AW-Country</th>
<td>да</td>
<td>двухбуквенное обозначения страны</td>
<td>uk</td>
</tr>
<tr>
<th>X-AW-Image</th>
<td>нет</td>
<td>использовать изображения в качестве иконки погоды или текст</td>
<td>uk</td>
</tr>
<tr>
<th>X-AW-TS</th>
<td>да</td>
<td>на какое время прогноз (целое число). <code>0</code> - текущая погода, <code>1</code> - погода через 3 часа и т.д.</td>
<td>0</td>
</tr>
<tr>
<th>X-AW-Active</th>
<td>нет</td>
<td>активен или нет данный монитор погоды</td>
<td>true</td>
</tr>
<tr>
<th>X-AW-Interval</th>
<td>да</td>
<td>интервал запуска монитора в стандартных интервалах обновления виджета</td>
<td>1</td>
</tr>
<tr>
<th>X-AW-Number</th>
<td>да</td>
<td>уникальный номер, который будет ассоциирован с данным монитором</td>
<td>случайное число меньше 1000</td>
</tr>
</table>