more pretty md files

This commit is contained in:
2016-02-02 00:55:13 +07:00
parent c0ad1a6912
commit 518956bdff
39 changed files with 1550 additions and 484 deletions

View File

@ -28,11 +28,16 @@ links:
---
<!-- info block -->
Набор минималистичных легко настраиваемых пламоидов, написанных на `C++/Qt`. Они выглядят, как виджеты в [Awesome WM](//awesome.naquadah.org/ "Домашняя страница Awesome"). Также пакет предоставляет дополнительный системный [DataEngine](//techbase.kde.org/Development/Tutorials/Plasma/DataEngines "Мануал для разработчиков").
Набор минималистичных легко настраиваемых пламоидов, написанных на `C++/Qt`. Они
выглядят, как виджеты в [Awesome WM](//awesome.naquadah.org/ "Домашняя страница
Awesome"). Также пакет предоставляет дополнительный системный [DataEngine]
(//techbase.kde.org/Development/Tutorials/Plasma/DataEngines "Мануал для
разработчиков").
<!--more-->
**ВНИМАНИЕ:** [НУЖНЫ ПЕРЕВОДЧИКИ!](//github.com/arcan1s/awesome-widgets/issues/14 "Тикет")
**ВНИМАНИЕ:** [НУЖНЫ ПЕРЕВОДЧИКИ!](//github.com/arcan1s/awesome-widgets/issues/14
"Тикет")
**Совместим с Plasma 5!**
@ -47,7 +52,8 @@ links:
### <a href="#changelog" class="anchor" id="changelog"><span class="octicon octicon-link"></span></a>Список изменений
[CHANGELOG-RU](//github.com/arcan1s/awesome-widgets/blob/master/CHANGELOG-RU "GitHub")
[CHANGELOG-RU](//github.com/arcan1s/awesome-widgets/blob/master/CHANGELOG-RU
"GitHub")
<!-- end of info block -->
@ -56,7 +62,8 @@ links:
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция
* Скачайте [архив](//github.com/arcan1s/awesome-widgets/releases "GitHub") с актуальной версией исходных файлов.
* Скачайте [архив](//github.com/arcan1s/awesome-widgets/releases "GitHub") с
актуальной версией исходных файлов.
* Извлеките из него файлы и установите:
```bash
@ -67,7 +74,8 @@ links:
sudo make install
```
**ВНИМАНИЕ:** Для Plasma 5, вероятно, потребуется флаг `-DKDE_INSTALL_USE_QT_SYS_PATHS=ON`
**ВНИМАНИЕ:** Для Plasma 5, вероятно, потребуется флаг
`-DKDE_INSTALL_USE_QT_SYS_PATHS=ON`
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости
@ -77,7 +85,8 @@ links:
* cmake *(make)*
* extra-cmake-modules *(make)*
* hddtemp **или** smartmontools *(опционально, для контроля за температурой HDD)*
* один из поддерживаемых музыкальных плееров *(опционально, для контроля за музыкальным плеером)*
* один из поддерживаемых музыкальных плееров *(опционально, для контроля за
музыкальным плеером)*
* проприетарный видеодрайвер *(опционально, для контроля за GPU)*
<!-- end of install block -->
@ -89,7 +98,9 @@ links:
### <a href="#tips" class="anchor" id="tips"><span class="octicon octicon-link"></span></a>Tips & tricks
Вы можете использовать несколько цветов в тексте. Просто вставьте нужный текст в html код. Смотри [вопрос](//github.com/arcan1s/awesome-widgets/issues/9 "GitHub") для более подробной информации.
Вы можете использовать несколько цветов в тексте. Просто вставьте нужный текст в
html код. Смотри [вопрос](//github.com/arcan1s/awesome-widgets/issues/9 "GitHub")
для более подробной информации.
<!-- end of howto block -->
@ -98,7 +109,10 @@ links:
### <a href="#deconf" class="anchor" id="deconf"><span class="octicon octicon-link"></span></a>Настройка DataEngine
Вы можете отредактировать настройки DataEngine, которые хранятся в `/etc/xdg/plasma-dataengine-extsysmon.conf` и `$HOME/.config/plasma-dataengine-extsysmon.conf`. Раскомментируйте необходимые строчки и отредактируйте их.
Вы можете отредактировать настройки DataEngine, которые хранятся в
`/etc/xdg/plasma-dataengine-extsysmon.conf` и
`$HOME/.config/plasma-dataengine-extsysmon.conf`. Раскомментируйте необходимые
строчки и отредактируйте их.
### <a href="#deoptions" class="anchor" id="deoptions"><span class="octicon octicon-link"></span></a>Опции DataEngine
@ -115,7 +129,8 @@ links:
### <a href="#widconf" class="anchor" id="widconf"><span class="octicon octicon-link"></span></a>Настройка виджета
Для настройки внешнего вида Вы должны открыть окно настроек и установить требуемый формат текста. HTML теги обрабатываются корректно.
Для настройки внешнего вида Вы должны открыть окно настроек и установить
требуемый формат текста. HTML теги обрабатываются корректно.
Доступные флаги приведены в таблице ниже.
@ -218,7 +233,9 @@ links:
### <a href="#lambda" class="anchor" id="lambda"><span class="octicon octicon-link"></span></a>Лямбда функции
Начиная с версии 3.0.0 основной виджет поддерживает лямбда выражения, которые рассчитываются в рантайме. Они объявляются использованием конструкции `${% raw %}${{{% endraw %} {% raw %}}}{% endraw %}`:
Начиная с версии 3.0.0 основной виджет поддерживает лямбда выражения, которые
рассчитываются в рантайме. Они объявляются использованием конструкции
`${% raw %}${{{% endraw %} {% raw %}}}{% endraw %}`:
```javascript
{% raw %}${{{% endraw %}
@ -230,7 +247,8 @@ three()
{% raw %}}}{% endraw %}
```
Функции внутри будут интерпретированы, как JavaScript, любая переменная из основного набора поддерживается. Так, функция:
Функции внутри будут интерпретированы, как JavaScript, любая переменная из
основного набора поддерживается. Так, функция:
```javascript
{% raw %}${{{% endraw %}
@ -245,7 +263,8 @@ colorCpu()
{% raw %}}}{% endraw %}
```
покажет значение `$cpu` красным, если оно больше 90.0, иначе - покажет цветом по-умолчанию. Также поддерживаются произвольные вычисления:
покажет значение `$cpu` красным, если оно больше 90.0, иначе - покажет цветом
по-умолчанию. Также поддерживаются произвольные вычисления:
```javascript
{% raw %}${{{% endraw %}
@ -253,7 +272,10 @@ $down - $up
{% raw %}}}{% endraw %}
```
покажет разность между скоростями загрузки и отдачи. Другая особенность, предоставляемая лямбда выражениями - тег `$this`, который вернет последнее значение данной лямбда функции. Ниже чуть более сложный пример, который покажет бегущую строку "Артист - Название" с длиной меньшей либо равной 10 символам:
покажет разность между скоростями загрузки и отдачи. Другая особенность,
предоставляемая лямбда выражениями - тег `$this`, который вернет последнее
значение данной лямбда функции. Ниже чуть более сложный пример, который покажет
бегущую строку "Артист - Название" с длиной меньшей либо равной 10 символам:
```javascript
{% raw %}${{{% endraw %}
@ -269,31 +291,43 @@ runningLine()
{% raw %}}}{% endraw %}
```
Таким образом, лямбда выражения могут быть использованы, например, чтобы показывать произвольное значение, которое будет рассчитано в рантайме, или, чтобы показать различную информацию, в зависимости от некоторых условий. Однако, пожалуйста, учитывайте, что подобные вычисления в рантайме могут увеличить нагрузку на CPU.
Таким образом, лямбда выражения могут быть использованы, например, чтобы
показывать произвольное значение, которое будет рассчитано в рантайме, или,
чтобы показать различную информацию, в зависимости от некоторых условий. Однако,
пожалуйста, учитывайте, что подобные вычисления в рантайме могут увеличить
нагрузку на CPU.
### <a href="#advanced" class="anchor" id="advanced"><span class="octicon octicon-link"></span></a>Расширенные настройки
**Включить фон:** Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный. По умолчанию `true`.
**Включить фон:** Снимите галочку, чтобы отключить стандартный фон виджета и
установить прозрачный. По умолчанию `true`.
**Переводить строки:** Переводить или нет строковые теги. По умолчанию `true`.
**Заменить символ перевода строки:** Заменить `\n` на `&#60;br&#62;`. По умолчанию `false`.
**Заменить символ перевода строки:** Заменить `\n` на `&#60;br&#62;`. По
умолчанию `false`.
**Перенос слов:** Включить перенос слов. По умолчанию `false`.
**Включить всплывающие сообщения:** Снимите галочку, если вы не хотите всплывающих сообщений на системные события. По умолчанию `true`.
**Включить всплывающие сообщения:** Снимите галочку, если вы не хотите
всплывающих сообщений на системные события. По умолчанию `true`.
**Проверять обновления:** Проверять или нет обновления при запуске. По умолчанию `true`.
**Проверять обновления:** Проверять или нет обновления при запуске. По умолчанию
`true`.
**Высота виджета:** Отключит автоматическое определение высоты виджета и установит ее в данное значение. По умолчанию `0` (автоматически).
**Высота виджета:** Отключит автоматическое определение высоты виджета и
установит ее в данное значение. По умолчанию `0` (автоматически).
**Ширина виджета:** Отключит автоматическое определение ширины виджета и установит ее в данное значение. По умолчанию `0` (автоматически).
**Ширина виджета:** Отключит автоматическое определение ширины виджета и
установит ее в данное значение. По умолчанию `0` (автоматически).
**Интервал обновления:** Интервал обновления виджета, мс. По умолчанию `1000`.
**Очередь сообщений:** Использовать указанное количество тредов в пуле. `0` означает идеальное количество тредов. По умолчанию `0`.
**Очередь сообщений:** Использовать указанное количество тредов в пуле. `0`
означает идеальное количество тредов. По умолчанию `0`.
**Температурные единицы:** Выберете единицы температуры. Доступные единицы следующие: Цельсий, Фаренгейт и Кельвин.
**Температурные единицы:** Выберете единицы температуры. Доступные единицы
следующие: Цельсий, Фаренгейт и Кельвин.
**Свой формат времени:**
@ -332,29 +366,42 @@ runningLine()
| `$mm` | Минуты аптайма. |
| `$m` | Минуты аптайма без нуля. |
**AC online тег:** Строка, которая будет показана, когда AC онлайн. По умолчанию `(*)`.
**AC online тег:** Строка, которая будет показана, когда AC онлайн. По умолчанию
`(*)`.
**AC offline тег:** Строка, которая будет показана, когда AC оффлайн. По умолчанию `( )`.
**AC offline тег:** Строка, которая будет показана, когда AC оффлайн. По
умолчанию `( )`.
### <a href="#tooltips" class="anchor" id="tooltips"><span class="octicon octicon-link"></span></a>Тултипы
Начиная с версии 1.7.0, поля CPU, частота CPU, память, swap, сеть и батарея поддерживают графический тултип (всплывающая подсказка). Чтобы включить их, просто поставьте нужные галочки. Число хранимых значений может быть установлено во вкладке. Также есть возможность настроить цвета графиков.
Начиная с версии 1.7.0, поля CPU, частота CPU, память, swap, сеть и батарея
поддерживают графический тултип (всплывающая подсказка). Чтобы включить их,
просто поставьте нужные галочки. Число хранимых значений может быть установлено
во вкладке. Также есть возможность настроить цвета графиков.
### <a href="#deguiconf" class="anchor" id="deguiconf"><span class="octicon octicon-link"></span></a>Настройка DataEngine
**Устройства ACPI:** Путь к устройствам ACPI. По умолчанию `/sys/class/power_supply/`.
**Устройство GPU:** Выберете одно из поддерживаемых устройств GPU. `auto` включит автоматическое определение устройства, `disable` отключит все мониторы GPU. По умолчанию `auto`.
**Устройство GPU:** Выберете одно из поддерживаемых устройств GPU. `auto`
включит автоматическое определение устройства, `disable` отключит все мониторы
GPU. По умолчанию `auto`.
**HDD:** Выберете один из HDD для монитора температуры HDD. `all` включит монитор для всех доступных устройств, `disable` отключит монитор температуры HDD. По умолчанию `all`.
**HDD:** Выберете один из HDD для монитора температуры HDD. `all` включит
монитор для всех доступных устройств, `disable` отключит монитор температуры HDD.
По умолчанию `all`.
**Команда hddtemp:** Введите команду, которая будет запущена для hddtemp DataEngine. По умолчанию `sudo hddtemp`.
**Команда hddtemp:** Введите команду, которая будет запущена для hddtemp
DataEngine. По умолчанию `sudo hddtemp`.
**Количество символов для плеера:** Количество символов, которые будут показываться в динамических тегах плеера.
**Количество символов для плеера:** Количество символов, которые будут
показываться в динамических тегах плеера.
**Музыкальный плеер:** Выберете один из поддерживаемых музыкальных плееров для соответствующего поля.
**Музыкальный плеер:** Выберете один из поддерживаемых музыкальных плееров для
соответствующего поля.
**MPRIS:** Выберете имя плеера MPRIS. `auto` включит автоматическое определение плеера. По умолчанию `auto`.
**MPRIS:** Выберете имя плеера MPRIS. `auto` включит автоматическое определение
плеера. По умолчанию `auto`.
**Адрес MPD:** Адрес MPD сервера. По умолчанию `localhost`.
@ -362,25 +409,32 @@ runningLine()
### <a href="#desktoppanel" class="anchor" id="desktoppanel"><span class="octicon octicon-link"></span></a>Desktop panel
Начиная с версии 1.11.0 виджеты предоставляют панель для мониторинга за рабочими столами. И да, он выглядит, как аналогичная панель в Awesome.
Начиная с версии 1.11.0 виджеты предоставляют панель для мониторинга за рабочими
столами. И да, он выглядит, как аналогичная панель в Awesome.
### <a href="#dpconf" class="anchor" id="dpconf"><span class="octicon octicon-link"></span></a>Настройка Desktop panel
**Включить фон:** Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный. По умолчанию `true`.
**Включить фон:** Снимите галочку, чтобы отключить стандартный фон виджета и
установить прозрачный. По умолчанию `true`.
**Вертикальная разметка:** Использовать вертикальную разметку вместо горизонтальной. По умолчанию `false`.
**Вертикальная разметка:** Использовать вертикальную разметку вместо
горизонтальной. По умолчанию `false`.
**Высота виджета:** Отключит автоматическое определение высоты виджета и установит ее в данное значение. По умолчанию `0` (автоматически).
**Высота виджета:** Отключит автоматическое определение высоты виджета и
установит ее в данное значение. По умолчанию `0` (автоматически).
**Ширина виджета:** Отключит автоматическое определение ширины виджета и установит ее в данное значение. По умолчанию `0` (автоматически).
**Ширина виджета:** Отключит автоматическое определение ширины виджета и
установит ее в данное значение. По умолчанию `0` (автоматически).
**Метка** Введите символ (или строку), которая будет показана, если данный рабочий стол сейчас активен.
**Метка** Введите символ (или строку), которая будет показана, если данный
рабочий стол сейчас активен.
**Тип тултипа:** Тип превью, по умолчанию `Окна`.
**Ширина тултипа:** Ширина тултипа в пикселях. По умолчанию `200px`.
**Цвет тултипа:** Цвет, который будет использован в некоторых типах тултипа. По умолчанию `#ffffff`.
**Цвет тултипа:** Цвет, который будет использован в некоторых типах тултипа.
По умолчанию `#ffffff`.
**Теги шаблона**