update aw pages

This commit is contained in:
arcan1s
2015-08-24 00:42:10 +03:00
parent 2cd047fabb
commit f1ebde2403
6 changed files with 237 additions and 61 deletions

View File

@ -20,8 +20,9 @@ links:
- Страница DataEngine на <a href="http://kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773" title="kde-look">kde-look.org</a>
- Пакет в <a href="https://aur.archlinux.org/packages/kdeplasma-applets-awesome-widgets" title="AUR">AUR</a>
- Пакет для <a href="http://software.opensuse.org/package/plasma5-awesome-widgets" title="openSUSE">openSUSE</a> (спасибо Kott)
- Пакеты для <a href="https://github.com/arcan1s/awesome-widgets/releases" title="Ubuntu">Ubuntu</a>
- <a href="/ru/2014/09/04/migration-to-v2/" title="Миграция">Миграция на версию 2.0</a>
- <a href="/ru/2014/12/19/aw-v21-bells-and-whistles/" title="Скрипты и бары">Скрипты и бары</a>
- <a href="/ru/2014/12/19/aw-v21-bells-and-whistles/" title="Расширения">Расширения</a>
---
<!-- info block -->
<h2><a href="#information" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
@ -62,16 +63,15 @@ make
sudo make install
{% endhighlight %}
<b>ВНИМАНИЕ:</b> С Plasma 5 также может потребоваться флаг <code>-DKDE_INSTALL_USE_QT_SYS_PATHS=ON</code>
<b>ВНИМАНИЕ:</b> С Plasma 5, вероятно, потребуется флаг <code>-DKDE_INSTALL_USE_QT_SYS_PATHS=ON</code>
</li>
</ul>
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
<p>Все было протестировано на последних версиях зависимостей.</p>
<ul>
<li>kdebase-workspace (<i>если используется KDE4</i>) <b>или</b> plasma-framework (<i>если используется KF5</i>)</li>
<li>lm_sensors (<i>только сборка для KDE4</i>)</li>
<li>automoc4 (<i>если используется KDE4</i>) <b>или</b> extra-cmake-modules (<i>если используется KF5</i>) <i>(make)</i></li>
<li>plasma-framework</li>
<li>extra-cmake-modules <i>(make)</i></li>
<li>cmake <i>(make)</i></li>
<li>hddtemp <b>или</b> smartmontools <i>(опционально, для контроля за температурой HDD)</i></li>
<li>один из поддерживаемых музыкальных плееров <i>(опционально, для контроля за музыкальным плеером)</i></li>
@ -85,8 +85,6 @@ sudo make install
<h3><a href="#tips" class="anchor" id="tips"><span class="octicon octicon-link"></span></a>Tips & tricks</h3>
<p>Вы можете использовать различные цвета в полях. Просто вставьте нужный текст в html код. Смотри <a href="https://github.com/arcan1s/awesome-widgets/issues/9" title="GitHub">вопрос</a> для более подробной информации.</p>
<p><i><font color="#FF0000">KDE4</font></i> Нумерация элементов в полях температура, использование HDD, скорость HDD, температура HDD ссылается на порядок элементов во второй вкладке (<i>Расширенные настройки</i>). Вы должны сначала выделить требуемые элементы в нужном listWidget. И первый выделенный элемент в listWdiget будет связан c <code>$tag0</code>. Смотри <a href="https://github.com/arcan1s/awesome-widgets/issues/17" title="GitHub">вопрос</a> для более подробной информации.</p>
<!-- end of howto block -->
<!-- config block -->
@ -319,22 +317,54 @@ sudo make install
<td>Температура HDD с номером N, <code>----</code>. Пример <code>$hddtemp0</code>. <code>hddtemp</code> должен быть установлен.</td>
</tr>
<tr>
<th rowspan="5">Сеть</th>
<th rowspan="13">Сеть</th>
<td><code>$down</code></td>
<td>Скорость загрузки активного устройства, KB/s или MB/s, <code>----</code>.</td>
</tr>
<tr>
<td><code>$downkb</code></td>
<td>Скорость загрузки активного устройства, KB/s, <code>----</code>.</td>
</tr>
<tr>
<td><code>$downunits</code></td>
<td>Единицы скорости загрузки активного устройства, <code>----</code>.</td>
</tr>
<tr>
<td><code>$downN</code></td>
<td>Скорость загрузки устройства N, KB/s или MB/s, <code>----</code>.</td>
</tr>
<tr>
<td><code>$downkbN</code></td>
<td>Скорость загрузки устройства N, KB/s, <code>----</code>.</td>
</tr>
<tr>
<td><code>$downunitsN</code></td>
<td>Единицы cкорости загрузки устройства N, <code>----</code>.</td>
</tr>
<tr>
<td><code>$up</code></td>
<td>Скорость отдачи активного устройства, KB/s или MB/s, <code>----</code>.</td>
</tr>
<tr>
<td><code>$upkb</code></td>
<td>Скорость отдачи активного устройства, KB/s, <code>----</code>.</td>
</tr>
<tr>
<td><code>$upunits</code></td>
<td>Единицы скорости отдачи активного устройства, <code>----</code>.</td>
</tr>
<tr>
<td><code>$upN</code></td>
<td>Скорость отдачи устройства N, KB/s или MB/s, <code>----</code>.</td>
</tr>
<tr>
<td><code>$upkbN</code></td>
<td>Скорость отдачи устройства N, KB/s, <code>----</code>.</td>
</tr>
<tr>
<td><code>$upunitsN</code></td>
<td>Единицы скорости отдачи устройства N, <code>----</code>.</td>
</tr>
<tr>
<td><code>$netdev</code></td>
<td>Текущее устройство.</td>
@ -469,10 +499,54 @@ sudo make install
</tr>
</table>
<h4><a href="#advanced" class="anchor" id="advanced"><span class="octicon octicon-link"></span></a>Расширенные настройки</h4>
<p><b>Включить фон:</b> Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный.</p>
<h4><a href="#lambda" class="anchor" id="lambda"><span class="octicon octicon-link"></span></a>Лябмда функции</h4>
<p>Начиная с версии 2.4.1 основной виджет поддерживает лямбда выражения, которые рассчитываются в рантайме. Они объявляются использованием конструкции <code>$&#123;&#123; &#125;&#125;</code>, например:</p>
<p><b>Включить всплывающие сообщения:</b> Нажмите на чекбокс, если вы не хотите всплывающих сообщений на системные события.</p>
{% highlight javascript %}
{% raw %}${{{% endraw %}
function three()
{
return 1 + 2;
}
three()
{% raw %}}}{% endraw %}
{% endhighlight %}
<p>Функции внутри будут интерпретированы, как JavaScript, любая переменная из основного набора поддерживается, например:</p>
{% highlight javascript %}
{% raw %}${{{% endraw %}
function colorCpu()
{
if ($cpu > 90.0)
return "<span style=\"color:#ff0000;\">$cpu</span>"
else
return "$cpu"
}
colorCpu()
{% raw %}}}{% endraw %}
{% endhighlight %}
<p>покажет значение <code>$cpu</code> красным, если оно больше 90.0, иначе - покажет цветом по-умолчанию. Также поддерживаются произвольные вычисления, например:</p>
{% highlight javascript %}
{% raw %}${{{% endraw %}
$down - $up
{% raw %}}}{% endraw %}
{% endhighlight %}
<p>покажет разность между скоростями загрузки и отдачи. Таким образом, лямбда выражения могут быть использованы, например, чтобы показывать произвольное значение, которое будет рассчитано в рантайме, или, чтобы показать различную информацию, в зависимости от некоторых условий. Однако, пожалуйста, учитывайте, что подобные вычисления в рантайме могут увеличить нагрузку на CPU.</p>
<h4><a href="#advanced" class="anchor" id="advanced"><span class="octicon octicon-link"></span></a>Расширенные настройки</h4>
<p><b>Высота виджета:</b> Отключит автоматическое определение высоты виджета и установит ее в данное значение. По умолчанию <code>0</code> (автоматически).</p>
<p><b>Ширина виджета:</b> Отключит автоматическое определение ширины виджета и установит ее в данное значение. По умолчанию <code>0</code> (автоматически).</p>
<p><b>Заменить символ перевода строки:</b> Заменить <code>\n</code> на <code><br></code>. По умолчанию <code>false</code>.</p>
<p><b>Включить фон:</b> Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный. По умолчанию <code>true</code>.</p>
<p><b>Включить всплывающие сообщения:</b> Нажмите на чекбокс, если вы не хотите всплывающих сообщений на системные события. По умолчанию <code>true</code>.</p>
<p><b>Свой формат времени:</b></p>
<table>
@ -524,6 +598,14 @@ sudo make install
<td><code>$h</code></td>
<td>Часы без нуля.</td>
</tr>
<tr>
<td><code>$HH</code></td>
<td>Часы в 24-часовом формате.</td>
</tr>
<tr>
<td><code>$H</code></td>
<td>Часы в 24-часовом формате без нуля.</td>
</tr>
<tr>
<td><code>$mm</code></td>
<td>Минуты.</td>
@ -540,6 +622,18 @@ sudo make install
<td><code>$s</code></td>
<td>Секунды без нуля.</td>
</tr>
<tr>
<td><code>$t</code></td>
<td>Временная зона.</td>
</tr>
<tr>
<td><code>$a</code>/<code>$ap</code></td>
<td>am или pm.</td>
</tr>
<tr>
<td><code>$A</code>/<code>$AP</code></td>
<td>AM или PM.</td>
</tr>
</table>
<p><b>Свой формат времени работы:</b></p>
@ -566,27 +660,19 @@ sudo make install
</tr>
<tr>
<td><code>$m</code></td>
<td>Минуты аптайма без 0.</td>
<td>Минуты аптайма без нуля.</td>
</tr>
</table>
<p><b>Температурные единицы:</b> Выберете единицы температуры. Доступные единицы следующие: Цельсий, Фаренгейт и Кельвин.</p>
<p><i><font color="#FF0000">KDE4</font></i> <b>Датчики температуры:</b> Список датчиков, которые будут наблюдаться в соответствующем поле (содержимое комбо-бокса заполнятся из <code>sensors</code>). Содержимое виджета редактируемо.</p>
<p><i><font color="#FF0000">KDE4</font></i> <b>Точки монтирования: </b> Список точек монтирования, которые будут наблюдаться в соответствующем поле (содержимое комбо-бокса заполнятся из <code>mount</code>). Содержимое виджета редактируемо.</p>
<p><i><font color="#FF0000">KDE4</font></i> <b>HDD (скорость):</b> Список HDD, скорость которых будет наблюдаться в соответствующем поле (содержимое комбо-бокса заполнятся из DataEngine). Содержимое виджета редактируемо.</p>
<p><i><font color="#FF0000">KDE4</font></i> <b>HDD (температура):</b> Список HDD, температура которых будет наблюдаться в соответствующем поле (содержимое комбо-бокса заполнятся из <code>find</code>). Содержимое виджета редактируемо.</p>
<p><i><font color="#FF0000">KDE4</font></i> <b>Сетевой интерфейс:</b> Использовать указанный интерфейс, как активный. Эта опция отключит автоматический выбор сетевого интерфейса.</p>
<p><b>AC online тег:</b> Строка, которая будет показана, когда AC онлайн. По умолчанию <code>(*)</code>.</p>
<p><b>AC offline тег:</b> Строка, которая будет показана, когда AC оффлайн. По умолчанию <code>( )</code>.</p>
<p><b>Проверять обновления:</b> Проверять или нет обновления при запуске. По умолчанию <code>проверять</code>.</p>
<p><b>Проверять обновления:</b> Проверять или нет обновления при запуске. По умолчанию <code>true</code>.</p>
<p><b>Переводить строки:</b> Переводить или нет строковые теги. По умолчанию <code>true</code>.</p>
<h4><a href="#tooltips" class="anchor" id="tooltips"><span class="octicon octicon-link"></span></a>Тултипы</h4>
<p>Начиная с версии 1.7.0, поля CPU, частота CPU, память, swap, сеть и батарея поддерживают графический тултип (всплывающая подсказка). Чтобы включить их, просто сделайте требуемые чекбоксы полностью чекнутыми. Число хранимых значений может быть установлено во вкладке. Цвета графиков настраиваются тоже.</p>
@ -612,15 +698,19 @@ sudo make install
<p>Начиная с версии 1.11.0 виджеты предоставляют минималистичную панель для мониторинга за рабочими столами, написанный на <code>C++</code>. И да, он выглядит, как аналогичная панель в Awesome.</p>
<h4><a href="#dpconf" class="anchor" id="dpconf"><span class="octicon octicon-link"></span></a>Настройка Desktop panel</h4>
<p><b>Включить фон:</b> Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный.</p>
<p><b>Высота виджета:</b> Отключит автоматическое определение высоты виджета и установит ее в данное значение. По умолчанию <code>0</code> (автоматически).</p>
<p><b>Вертикальная разметка:</b> Использовать вертикальную разметку вместо горизонтальной.</p>
<p><b>Ширина виджета:</b> Отключит автоматическое определение ширины виджета и установит ее в данное значение. По умолчанию <code>0</code> (автоматически).</p>
<p><b>Включить тултип:</b> Включать или нет графическое превью выбранного рабочего стола. Вы также должны указать тип превью, по умолчанию <code>Окна</code>.</p>
<p><b>Ширина тултипа:</b> Ширина тултипа в пикселях. По умолчанию <code>200px</code>.</p>
<p><b>Цвет границ окна:</b> Цвет рамок окон в тултипе "Контуры". По умолчанию <code>#ffffff</code>.</p>
<p><b>Цвет тултипа:</b> Цвет, который будет использован в некоторых типах тултипа. По умолчанию <code>#ffffff</code>.</p>
<p><b>Включить фон:</b> Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный. По умолчанию <code>true</code>.</p>
<p><b>Вертикальная разметка:</b> Использовать вертикальную разметку вместо горизонтальной. По умолчанию <code>false</code>.</p>
<p><b>Метка</b> Введите символ (или строку), которая будет показана, если данный рабочий стол сейчас активен.</p>
@ -643,8 +733,6 @@ sudo make install
<td>Общее число рабочих столов.</td>
</tr>
</table>
<p><i><font color="#FF0000">KDE4</font> (смотри <a href="http://mail.kde.org/pipermail/plasma-devel/2015-February/039027.html" title="Mailing list">здесь</a>)</i> <b>Скрытие панелей:</b> Выберите панели, которые будут скрыты при нажатии на горячую клавишу.</p>
<!-- end of config block -->
<!-- gui block -->