update aw pages before 2.4.0 release

This commit is contained in:
arcan1s 2015-08-09 03:47:52 +03:00
parent 48bad5e153
commit 1c2d65d5f6
5 changed files with 259 additions and 11 deletions

View File

@ -10,4 +10,4 @@
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
})();
</script>
<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript" title="Disqus page">comments powered by Disqus.</a></noscript>
<noscript>Please enable JavaScript to view the <a href="https://disqus.com/?ref_noscript" title="Disqus page">comments powered by Disqus.</a></noscript>

View File

@ -75,6 +75,12 @@ description: The paper deals with settings of a custom scripts and graphical bar
<td>width, pixels</td>
<td>100</td>
</tr>
<tr>
<th>X-AW-Number</th>
<td>yes</td>
<td>unique number which will be associated with the bar. The property has been introduced to provide compatibility with others items. Should be the same as number in Name is</td>
<td>number from Name</td>
</tr>
</table>
<h2><a href="#quotes" class="anchor" id="quotes"><span class="octicon octicon-link"></span></a>Quotes</h2>
@ -156,7 +162,7 @@ description: The paper deals with settings of a custom scripts and graphical bar
<tr>
<th>X-AW-Prefix</th>
<td>no</td>
<td>prefix to executable file. Usually it's not required, but in other you may want to specify interpretor for example.</td>
<td>prefix to executable file. Usually it's not required, but in other you may want to specify interpretor for example</td>
<td></td>
</tr>
<tr>
@ -250,3 +256,63 @@ description: The paper deals with settings of a custom scripts and graphical bar
<td>random number which is less than 1000</td>
</tr>
</table>
<h2><a href="#weather" class="anchor" id="weather"><span class="octicon octicon-link"></span></a>Weather</h2>
<p>Weathers are stored in the two directories: <code>/usr/share/awesomewidgets/weather/</code> and <code>$HOME/.local/share/awesomewidgets/weather/</code> (path may be differ in depend from your distro). Settings in the home directory have a higher priority that global ones. The weather uses data and API from <a href="http://openweathermap.org/" title="OpenWeatherMap site">OpenWeatherMap</a>. Configuration files have the following fields:</p>
<table>
<tr>
<th>Field</th>
<th>Required</th>
<th>Value</th>
<th>Default</th>
</tr>
<tr>
<th>Name</th>
<td>yes</td>
<td>weather name</td>
<td>none</td>
</tr>
<tr>
<th>Comment</th>
<td>no</td>
<td>comment</td>
<td>empty</td>
</tr>
<tr>
<th>X-AW-City</th>
<td>yes</td>
<td>City</td>
<td>London</td>
</tr>
<tr>
<th>X-AW-Country</th>
<td>yes</td>
<td>Two-letter country code</td>
<td>uk</td>
</tr>
<tr>
<th>X-AW-TS</th>
<td>yes</td>
<td>Time to which weather should be. <code>0</code> is a current weather, <code>1</code> - weather 3 hours later, etc</td>
<td>0</td>
</tr>
<tr>
<th>X-AW-Active</th>
<td>no</td>
<td>whether or not the monitor is active</td>
<td>true</td>
</tr>
<tr>
<th>X-AW-Interval</th>
<td>no</td>
<td>update interval in standard widget intervals</td>
<td>1</td>
</tr>
<tr>
<th>X-AW-Number</th>
<td>да</td>
<td>unique number which will be associated with the upgrade weather</td>
<td>random number which is less than 1000</td>
</tr>
</table>

View File

@ -122,7 +122,7 @@ sudo make install
</tr>
<tr>
<th>PLAYER</th>
<td>Set music player. Supported players are mpd and MPRIS/DBus supported.</td>
<td>Set music player. Supported players are mpd and MPRIS/DBus supported. <code>disable</code> will disable this monitor.</td>
</tr>
</table>
@ -163,7 +163,20 @@ sudo make install
<td>Will enable custom uptime format.</td>
</tr>
<tr>
<th rowspan="2">CPU label</th>
<th rowspan="3">Load average</th>
<td><code>$la1</code></td>
<td>Load average over 1 min, <code>-----</code>.</td>
</tr>
<tr>
<td><code>$la5</code></td>
<td>Load average over 5 min, <code>-----</code>.</td>
</tr>
<tr>
<td><code>$la15</code></td>
<td>Load average over 15 min, <code>-----</code>.</td>
</tr>
<tr>
<th rowspan="2">CPU</th>
<td><code>$cpu</code></td>
<td>Total load CPU, %, <code>-----</code>.</td>
</tr>
@ -396,17 +409,62 @@ sudo make install
<td>Total number of desktops.</td>
</tr>
<tr>
<th rowspan="3">Quotes</th>
<th rowspan="9">Quotes</th>
<td><code>$askN</code></td>
<td>Get ask for ticker N. For example <code>$ask0</code>.</td>
</tr>
<tr>
<td><code>$askchgN</code></td>
<td>Get absolute ask change for ticker N. For example <code>$askchg0</code>.</td>
</tr>
<tr>
<td><code>$percaskchgN</code></td>
<td>Get ask change for ticker N, %. For example <code>$percaskchg0</code>.</td>
</tr>
<tr>
<td><code>$bidN</code></td>
<td>Get bid for ticker N. For example <code>$bid0</code>.</td>
</tr>
<tr>
<td><code>$bidchgN</code></td>
<td>Get absolute bid change for ticker N, %. For example <code>$bidchg0</code>.</td>
</tr>
<tr>
<td><code>$percbidchgN</code></td>
<td>Get bid change for ticker N. For example <code>$percbidchg0</code>.</td>
</tr>
<tr>
<td><code>$priceN</code></td>
<td>Get average between bid and ask for ticker N. For example <code>$price0</code>.</td>
<td>Get price for ticker N. For example <code>$price0</code>.</td>
</tr>
<tr>
<td><code>$pricechgN</code></td>
<td>Get absolute price change for ticker N. For example <code>$pricechg0</code>.</td>
</tr>
<tr>
<td><code>$percaskchgN</code></td>
<td>Get price change for ticker N, %. For example <code>$percpricechg0</code>.</td>
</tr>
<tr>
<th rowspan="5">Weather</th>
<td><code>$weatherIdN</code></td>
<td>Numerical weather ID. For example <code>$weatherId0</code>.</td>
</tr>
<tr>
<td><code>$weatherN</code></td>
<td>UTF symbol for weather ID. For example <code>$weather0</code>.</td>
</tr>
<tr>
<td><code>$humidityN</code></td>
<td>Humidity, %. For example <code>$humidity0</code>.</td>
</tr>
<tr>
<td><code>$pressureN</code></td>
<td>Pressure, bars. For example <code>$pressure0</code>.</td>
</tr>
<tr>
<td><code>$temperatureN</code></td>
<td>Temperature. For example <code>$temperature0</code>.</td>
</tr>
</table>
@ -547,7 +605,7 @@ sudo make install
<p><b>MPRIS:</b> Select MPRIS player name. <code>auto</code> will enable auto selection. Default is <code>auto</code>.</p>
<p><b>Music player:</b> Select one of supported music playes for player label.</p>
<p><b>Music player:</b> Select one of supported music players for player label.</p>
<h3><a href="#desktoppanel" class="anchor" id="desktoppanel"><span class="octicon octicon-link"></span></a>Desktop Panel</h3>
<p>Since version 1.11.0 it provides a minimalistic panel for monitoring on desktops written on <code>C++</code>. And yes, it looks like the same panel in Awesome.</p>

View File

@ -75,6 +75,12 @@ description: Данная статья посвящена обсуждению
<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>
@ -250,3 +256,63 @@ description: Данная статья посвящена обсуждению
<td>случайное число меньше 1000</td>
</tr>
</table>
<h2><a href="#weather" class="anchor" id="weather"><span class="octicon octicon-link"></span></a>Погода</h2>
<p>Погода хранится в двух директориях: <code>/usr/share/awesomewidgets/weather/</code> и <code>$HOME/.local/share/awesomewidgets/weather/</code> (пути могут немного отличаться в зависимости от используемого дистрибутива). Настройки в домашней директории перезаписывают глобальные настройки. Для показа погоды используются данные и API <a href="http://openweathermap.org/" title="Сайт OpenWeatherMap">OpenWeatherMap</a>. Файлы настроек имеют следующие поля:</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-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>

View File

@ -123,7 +123,7 @@ sudo make install
</tr>
<tr>
<th>PLAYER</th>
<td>Устанавливает музыкальный плеер. Поддерживаемые плееры: mpd и с поддержкой MPRIS/DBus.</td>
<td>Устанавливает музыкальный плеер. Поддерживаемые плееры: mpd и с поддержкой MPRIS/DBus. <code>disable</code> отключит данный монитор.</td>
</tr>
</table>
@ -163,6 +163,19 @@ sudo make install
<td><code>$cuptime</code></td>
<td>Cпециальный формат аптайма.</td>
</tr>
<tr>
<th rowspan="3">Средняя загрузка</th>
<td><code>$la1</code></td>
<td>Средняя загрузка за 1 минуту, <code>-----</code>.</td>
</tr>
<tr>
<td><code>$la5</code></td>
<td>Средняя загрузка за 5 минут, <code>-----</code>.</td>
</tr>
<tr>
<td><code>$la15</code></td>
<td>Средняя загрузка за 15 минут, <code>-----</code>.</td>
</tr>
<tr>
<th rowspan="2">CPU</th>
<td><code>$cpu</code></td>
@ -397,17 +410,62 @@ sudo make install
<td>Общее число рабочих столов.</td>
</tr>
<tr>
<th rowspan="3">Котировки</th>
<th rowspan="9">Котировки</th>
<td><code>$askN</code></td>
<td>Получить аск по тикеру N. Например, <code>$ask0</code>.</td>
</tr>
<tr>
<td><code>$askchgN</code></td>
<td>Абсолютное изменение аск по тикеру N. Например, <code>$askchg0</code>.</td>
</tr>
<tr>
<td><code>$percaskchgN</code></td>
<td>Изменение аск по тикеру N, %. Например, <code>$percaskchg0</code>.</td>
</tr>
<tr>
<td><code>$bidN</code></td>
<td>Получить бид по тикеру N. Например, <code>$bid0</code>.</td>
</tr>
<tr>
<td><code>$bidchgN</code></td>
<td>Абсолютное изменение бид по тикеру N. Например, <code>$bidchg0</code>.</td>
</tr>
<tr>
<td><code>$percbidchgN</code></td>
<td>Изменение бид по тикеру N, %. Например, <code>$percbidchg0</code>.</td>
</tr>
<tr>
<td><code>$priceN</code></td>
<td>Получить среднее между бидом и аском по тикеру N. Например, <code>$price0</code>.</td>
<td>Получить цену по тикеру N. Например, <code>$price0</code>.</td>
</tr>
<tr>
<td><code>$pricechgN</code></td>
<td>Абсолютное изменение цены по тикеру N. Например, <code>$pricechg0</code>.</td>
</tr>
<tr>
<td><code>$percpricechgN</code></td>
<td>Изменение цены по тикеру N, %. Например, <code>$percpricechg0</code>.</td>
</tr>
<tr>
<th rowspan="5">Погода</th>
<td><code>$weatherIdN</code></td>
<td>Численное ID погоды. Например <code>$weatherId0</code>.</td>
</tr>
<tr>
<td><code>$weatherN</code></td>
<td>UTF символ для соответствующего ID. Например <code>$weather0</code>.</td>
</tr>
<tr>
<td><code>$humidityN</code></td>
<td>Влажность, %. Например <code>$humidity0</code>.</td>
</tr>
<tr>
<td><code>$pressureN</code></td>
<td>Давление, бар. Например <code>$pressure0</code>.</td>
</tr>
<tr>
<td><code>$temperatureN</code></td>
<td>Температура. Humidity <code>$temperature0</code>.</td>
</tr>
</table>