changed from md readme to html

This commit is contained in:
arcan1s 2014-05-26 12:18:39 +04:00
parent 6f4ecbd107
commit 6fd7bad8f9
12 changed files with 991 additions and 8 deletions

View File

@ -10,6 +10,7 @@ PyTextMonitor is a minimalistic Plasmoid script written on Python2. It looks lik
Configuration
-------------
For edited output you must open Settings window and setup output format in lines:
* tag `$time` - time in default format. For example, *fri Nov 6 04:48:01 2013*
* tag `$isotime` - time in iso format
* tag `$shorttime` - time in short locale format

View File

@ -1,7 +1,14 @@
#!/bin/bash
# update english readme
cp README.md sources/readme/en.md
cp README.md md_readme/en.md
# create html pages
for MARKDOWN in $(find md_readme -name '*.md'); do
FILENAME=$(basename -- "${MARKDOWN}")
FILENAME="${FILENAME%.*}"
markdown "${MARKDOWN}" > "sources/readme/${FILENAME}.html"
done
exit 1
SRCDIR="sources"
VERSION=$(grep -m1 PROJECT_VERSION_MAJOR sources/CMakeLists.txt | awk '{print $3}' | cut -c 1).\

View File

@ -10,6 +10,7 @@ PyTextMonitor is a minimalistic Plasmoid script written on Python2. It looks lik
Configuration
-------------
For edited output you must open Settings window and setup output format in lines:
* tag `$time` - time in default format. For example, *fri Nov 6 04:48:01 2013*
* tag `$isotime` - time in iso format
* tag `$shorttime` - time in short locale format

View File

@ -9,6 +9,7 @@ PyTextMonitor es un plasmoide minimalista escrito en Python2. Luce como los comp
Configuración
-------------
Para editar la visualización debes abrir la ventana de Ajustes y establecer el formato de visualización en líneas:
* etiqueta `$time` - hora en formato por defecto. Por ejemplo, *vie 06 Nov 04:48:01 2013*
* etiqueta `$isotime` - hora en formato ISO

View File

@ -9,6 +9,7 @@ PyTextMonitor - минималистичный плазмоид, написан
Настройка
---------
Для редактирования внешнего вида, откройте окно настроек и установите требуемый формат в поля:
* тег `$time` - время в стандартном формате. Например, *fri Nov 6 04:48:01 2013*
* тег `$isotime` - время в ISO формате

View File

@ -9,6 +9,7 @@ PyTextMonitor - мінімалістичний плазмоїд, що напис
Налаштування
------------
Для редагування зовнішного вигляду, відкрийте вікно налаштувань та встановіть потрібний формат в поля:
* тег `$time` - час у стандартному форматі. Наприклад, *fri Nov 6 04:48:01 2013*
* тег `$isotime` - час в ISO форматі

View File

@ -143,14 +143,14 @@ class pyTextWidget(plasmascript.Applet):
else:
return
locale = str(QLocale.system().name())
if (os.path.exists(dirPath + locale + ".md")):
filePath = dirPath + locale + ".md"
if (os.path.exists(dirPath + locale + ".html")):
filePath = dirPath + locale + ".html"
else:
locale = locale.split('_')[0]
if (os.path.exists(dirPath + locale + ".md")):
filePath = dirPath + locale + ".md"
elif (os.path.exists(dirPath + "en.md")):
filePath = dirPath + "en.md"
if (os.path.exists(dirPath + locale + ".html")):
filePath = dirPath + locale + ".html"
elif (os.path.exists(dirPath + "en.html")):
filePath = dirPath + "en.html"
else:
return
os.system("kioclient exec " + str(filePath) + " &")

View File

@ -1,5 +1,5 @@
# set project name
set (SUBPROJECT pytextmonitor)
file (GLOB SUBPROJECT_MD *.md)
file (GLOB SUBPROJECT_MD *.html)
install (FILES ${SUBPROJECT_MD} DESTINATION share/${SUBPROJECT}/)

246
sources/readme/en.html Normal file
View File

@ -0,0 +1,246 @@
<h1>pytextmonitor</h1>
<h2>Information</h2>
<p>PyTextMonitor is a minimalistic Plasmoid script written on Python2. It looks like widgets in awesome-wm.</p>
<p><strong>NOTE</strong> <a href="https://github.com/arcan1s/pytextmonitor/issues/14">LOOKING FOR TRANSLATORS!</a></p>
<h2>Configuration</h2>
<p>For edited output you must open Settings window and setup output format in lines:</p>
<ul>
<li>tag <code>$time</code> - time in default format. For example, <em>fri Nov 6 04:48:01 2013</em></li>
<li>tag <code>$isotime</code> - time in iso format</li>
<li>tag <code>$shorttime</code> - time in short locale format</li>
<li>tag <code>$longtime</code> - time in long locale format</li>
<li>tag <code>$custom</code> - custom time format</li>
<li>tag <code>$uptime</code> - uptime, <em>---d--h--m</em></li>
<li>tag <code>$custom</code> - custom uptime format</li>
<li>tag <code>$cpu</code> - total load cpu, <em>%</em></li>
<li>tag <code>$cpuN</code> - load CPU for core N, <em>%</em></li>
<li>tag <code>$cpucl</code> - average cpu clock, <em>MHz</em></li>
<li>tag <code>$cpuclN</code> - cpu clock for core N, <em>MHz</em></li>
<li>tag <code>$tempN</code> - temperature for device N. For example, <code>$temp0</code></li>
<li>tag <code>$gpu</code> - GPU usage, <em>%</em>. <code>aticonfig</code> or <code>nvidia-smi</code> must be installed</li>
<li>tag <code>$gputemp</code> - GPU temperature. <code>aticonfig</code> or <code>nvidia-smi</code> must be installed</li>
<li>tag <code>$mem</code> - usage memory, <em>%</em></li>
<li>tag <code>$memmb</code> - usage memory, <em>MB</em></li>
<li>tag <code>$memgb</code> - usage memory, <em>GB</em></li>
<li>tag <code>$swap</code> - swap, <em>%</em></li>
<li>tag <code>$swapmb</code> - swap, <em>MB</em></li>
<li>tag <code>$swapgb</code> - swap, <em>GB</em></li>
<li>tag <code>$hddN</code> - usage for mount point N, <em>%</em>. For example, <code>$hdd0</code></li>
<li>tag <code>$hddmbN</code> - usage for mount point N, <em>MB</em>. For example, <code>$hddmb0</code></li>
<li>tag <code>$hddgbN</code> - usage for mount point N, <em>GB</em>. For example, <code>$hddgb0</code></li>
<li>tag <code>$hddrN</code> - read speed of disk N, <em>KB/s</em>. For example, <code>$hddr0</code></li>
<li>tag <code>$hddwN</code> - write speed of disk N, <em>KB/s</em>. For example, <code>$hddw0</code></li>
<li>tag <code>$hddtempN</code> - temperature for HDD N. For example, <code>$hddtemp0</code></li>
<li>tag <code>$down</code> - download speed, <em>KB/s</em></li>
<li>tag <code>$up</code> - upload speed, <em>KB/s</em></li>
<li>tag <code>$netdev</code> - current network device</li>
<li>tag <code>$bat</code> - battery charge, <em>%</em></li>
<li>tag <code>$ac</code> - status AC device. Return (*) if AC device is online or <em>( )</em> if offline</li>
<li>tag <code>$album</code> - current song album. One of supported music players must be installed</li>
<li>tag <code>$artist</code> - current song artist. One of supported music players must be installed</li>
<li>tag <code>$progress</code> - current song progress. One of supported music players must be installed</li>
<li>tag <code>$time</code> - current song duration. One of supported music players must be installed</li>
<li>tag <code>$title</code> - current song title. One of supported music players must be installed</li>
<li>tag <code>$pscount</code> - number of running processes</li>
<li>tag <code>$pstotal</code> - total number of processes</li>
<li>tag <code>$ps</code> - list of running processes</li>
<li>tag <code>$pkgcountN</code> - number of packages, which available to upgrade for command N. For example, <code>$pkgcount0</code></li>
<li>tag <code>$customN</code> - returns output for custom command N. For example, <code>$custom0</code></li>
</ul>
<p>Label order will changed if you change slider position. HTML tags in label work normally.</p>
<p><strong>NOTE</strong> you don't may set to show <code>$cpu</code> tag in swap label for example. <strong><code>$cpu</code> will work only in cpu label</strong>.</p>
<h2>Advanced settings</h2>
<p><strong>Custom time</strong></p>
<ul>
<li>tag <code>$dddd</code> - weekday in long format</li>
<li>tag <code>$ddd</code> - weekday in short format</li>
<li>tag <code>$dd</code> - day</li>
<li>tag <code>$d</code> - day without zero</li>
<li>tag <code>$MMMM</code> - month in long format</li>
<li>tag <code>$MMM</code> - month in short format</li>
<li>tag <code>$MM</code> - month</li>
<li>tag <code>$M</code> - month without zero</li>
<li>tag <code>$yyyy</code> - year</li>
<li>tag <code>$yy</code> - year in short format</li>
<li>tag <code>$hh</code> - hours</li>
<li>tag <code>$h</code> - hours without zero</li>
<li>tag <code>$mm</code> - minutes</li>
<li>tag <code>$m</code> - minutes without zero</li>
<li>tag <code>$ss</code> - seconds</li>
<li>tag <code>$s</code> - seconds without zero</li>
</ul>
<p><strong>Custom uptime</strong></p>
<ul>
<li>tag <code>$dd</code> - uptime days</li>
<li>tag <code>$d</code> - uptime days without zero</li>
<li>tag <code>$hh</code> - uptime hours</li>
<li>tag <code>$h</code> - uptime hours without zero</li>
<li>tag <code>$mm</code> - uptime minutes</li>
<li>tag <code>$m</code> - uptime minutes without zero</li>
</ul>
<p><strong>Temperature units</strong></p>
<p>Select units for temperature. Available units are Celsius, Farenheit and Kelvin.</p>
<p><strong>Temperature devices</strong></p>
<p>List of devices, which will be observed in temp label (combo box items come from <code>sensors</code>). List widget is editable, delete key will remove current item.</p>
<p><strong>Mount points</strong></p>
<p>List of mount points, which will be observed in hdd label (combo box items come from <code>mount</code>). List widget is editable, delete key will remove current item.</p>
<p><strong>HDD (speed)</strong></p>
<p>List of hard disk devices, which will be observed in hddspeed label (combo box items come from DataEngine). List widget is editable, delete key will remove current item.</p>
<p><strong>HDD (temperature)</strong></p>
<p>List of hard disk devices, which will be observed in hddtemp label (combo box items come from <code>find</code>). List widget is editable, delete key will remove current item.</p>
<p><strong>Network directory</strong></p>
<p>Path to directory, which contains network devices information. Default is <code>/sys/class/net</code>. Required for auto select network device.</p>
<p><strong>Network device</strong></p>
<p>Use specified device as active. Combo box items come from <strong>network directory</strong>. Will disable auto select network device.</p>
<p><strong>Battery device</strong></p>
<p>File with battery information. File (<code>/sys/class/power_supply/BAT0/capacity</code> by default) should contain only battery charge in percent.</p>
<p><strong>AC online tag</strong></p>
<p>Line which will be shown when AC is online.</p>
<p><strong>AC offline tag</strong></p>
<p>Line which will be shown when AC is offline.</p>
<p><strong>AC device</strong></p>
<p>File with AC information. File (<code>/sys/class/power_supply/AC/online</code> by default) must contain <code>1</code> if AC is online.</p>
<p><strong>Music player</strong></p>
<p>Select one of supported music playes for player label.</p>
<h2>Tooltip settings</h2>
<p>Since version 1.7.0 CPU, CPU clock, memory, swap and network labels support graphical tooltip. To enable them just make the needed checkboxes a fully checked. The number of stored values can be set in the tab. Colors of graphs are configurable too.</p>
<h2>DataEngine settings</h2>
<p><strong>Custom command</strong></p>
<p><em>NOTE</em> This can cause the computer freeze.</p>
<p>Commands, which will be run for custom label.</p>
<p><strong>GPU device</strong></p>
<p>Select one of supported GPU devices. <code>auto</code> will enable auto selection. Default is <code>auto</code>.</p>
<p><strong>HDD</strong></p>
<p>Select one of HDDs for HDD temperature monitor. <code>all</code> will enable monitor for all devices. Default is <code>all</code>.</p>
<p><strong>hddtemp cmd</strong></p>
<p>Type a command which will be run for hddtemp DataEngine. Default is <code>sudo hddtemp</code>.</p>
<p><strong>MPD address</strong></p>
<p>Address of MPD server. Default is <code>localhost</code>.</p>
<p><strong>MPD port</strong></p>
<p>Port of MPD server. Default is <code>6600</code>.</p>
<p><strong>Package manager</strong></p>
<p>List of commands, which will be run. Number of null lines is a number of unneeded lines. Defaults:
* <em>Arch</em>: <code>PKGCMD=pacman -Qu</code>, <code>PKGNULL=0</code>
* <em>Debian</em>: <code>PKGCMD=apt-show-versions -u -b</code>, <code>PKGNULL=0</code>
* <em>Ubuntu</em>: <code>PKGCMD=aptitude search '~U'</code>, <code>PKGNULL=0</code>
* <em>Fedora</em>: <code>PKGCMD=yum list updates</code>, <code>PKGNULL=3</code>
* <em>FreeBSD</em>: <code>PKGCMD=pkg_version -I -l '&lt;'</code>, <code>PKGNULL=0</code>
* <em>Mandriva</em>: <code>PKGCMD=urpmq --auto-select</code>, <code>PKGNULL=0</code></p>
<h2>DataEngine configuration</h2>
<p>You may edit DataEngine configuration. It is <code>/usr/share/config/extsysmon.conf</code> or <code>$HOME/share/config/extsysmon.conf</code> depending on the type of installation. Uncomment needed line and edit it.</p>
<h1>Instruction</h1>
<h2>Dependencies</h2>
<ul>
<li>kdebase-workspace</li>
<li>kdebindings-python2</li>
<li>lm_sensors (<em>for definition temperature device</em>)</li>
<li>sysstat (<em>for notification</em>)</li>
</ul>
<h2>Optional dependencies</h2>
<ul>
<li>proprietary video driver</li>
<li>hddtemp (make sure that it may be run with <code>sudo</code> without password. Just add following line to <code>/etc/sudoers</code>: <code>$USERNAME ALL=NOPASSWD: /usr/bin/hddtemp</code>)</li>
<li>music player (amarok, clementine, mpd or qmmp)</li>
</ul>
<h2>Make dependencies</h2>
<ul>
<li>automoc4</li>
<li>cmake</li>
<li>kdebase-runtime</li>
</ul>
<h2>Installation</h2>
<ul>
<li>download sources</li>
<li><p>install</p>
<pre><code>mkdir build &amp;&amp; cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`kde4-config --localprefix` ../
make &amp;&amp; make install
</code></pre>
<p>Also you may install it to <code>/</code>:</p>
<pre><code>mkdir build &amp;&amp; cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` ../
make &amp;&amp; sudo make install
</code></pre></li>
</ul>
<h1>Additional information</h1>
<h2>TODO (wish list)</h2>
<h2>Links</h2>
<ul>
<li><a href="http://arcanis.name/projects/pytextmonitor/">Homepage</a></li>
<li>Plasmoid on <a href="http://kde-look.org/content/show.php/Py+Text+Monitor?content=157124">kde-look</a></li>
<li>DataEngine on <a href="http://kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773">kde-look</a></li>
<li>Archlinux <a href="https://aur.archlinux.org/packages/kdeplasma-applets-pytextmonitor/">AUR</a> package</li>
</ul>

239
sources/readme/es.html Normal file
View File

@ -0,0 +1,239 @@
<h1>pytextmonitor</h1>
<h2>Información</h2>
<p>PyTextMonitor es un plasmoide minimalista escrito en Python2. Luce como los componentes visuales de awesome-wm.</p>
<p><strong>NOTA</strong> <a href="https://github.com/arcan1s/pytextmonitor/issues/14">¡Se buscan traductores!</a></p>
<h2>Configuración</h2>
<p>Para editar la visualización debes abrir la ventana de Ajustes y establecer el formato de visualización en líneas:
* etiqueta <code>$time</code> - hora en formato por defecto. Por ejemplo, <em>vie 06 Nov 04:48:01 2013</em>
* etiqueta <code>$isotime</code> - hora en formato ISO
* etiqueta <code>$shorttime</code> - hora en formato local corto
* etiqueta <code>$longtime</code> - hora en formato local largo
* etiqueta <code>$custom</code> - formato de hora personalizado
* etiqueta <code>$uptime</code> - tiempo de actividad del sistema, <em>---d--h--m</em>
* etiqueta <code>$custom</code> - formato personalizado del tiempo de actividad del sistema
* etiqueta <code>$cpu</code> - carga total de la CPU, <em>%</em>
* etiqueta <code>$cpuN</code> - carga de la CPU para el núcleo N, <em>%</em>
* etiqueta <code>$cpucl</code> - frecuencia promedio de la CPU, <em>MHz</em>
* etiqueta <code>$cpuclN</code> - frecuencia de la CPU para el núcleo N, <em>MHz</em>
* etiqueta <code>$tempN</code> - temperatura para el dispositivo N. Por ejemplo, <code>$temp0</code>
* etiqueta <code>$gpu</code> - uso de la GPU, <em>%</em>. Debe estar instalado <code>aticonfig</code> o <code>nvidia-smi</code>
* etiqueta <code>$gputemp</code> - temperatura de la GPU. Debe estar instalado <code>aticonfig</code> o <code>nvidia-smi</code>
* etiqueta <code>$mem</code> - uso de la memori, <em>%</em>
* etiqueta <code>$memmb</code> - uso de la memoria, <em>MB</em>
* etiqueta <code>$memgb</code> - uso de la memoria, <em>GB</em>
* etiqueta <code>$swap</code> - swap, <em>%</em>
* etiqueta <code>$swapmb</code> - swap, <em>MB</em>
* etiqueta <code>$swapgb</code> - swap, <em>GB</em>
* etiqueta <code>$hddN</code> - uso para el punto de montaje N, <em>%</em>. Por ejemplo, <code>$hdd0</code>
* etiqueta <code>$hddmbN</code> - uso para el punto de montaje N, <em>MB</em>. Por ejemplo, <code>$hddmb0</code>
* etiqueta <code>$hddgbN</code> - uso para el punto de montaje N, <em>GB</em>. Por ejemplo, <code>$hddgb0</code>
* etiqueta <code>$hddrN</code> - leer la velocidad del disco N, <em>KB/s</em>. Por ejemplo, <code>$hddr0</code>
* etiqueta <code>$hddwN</code> - velocidad de escritura del disco N, <em>KB/s</em>. Por ejemplo: <code>$hddw0</code>
* etiqueta <code>$hddtempN</code> - temperatura para el disco duro N. Por ejemplo, <code>$hddtemp0</code>
* etiqueta <code>$down</code> - velocidad de recepción, <em>KB/s</em>
* etiqueta <code>$up</code> - velocidad de envío, <em>KB/s</em>
* etiqueta <code>$netdev</code> - dispositivo de red actual
* etiqueta <code>$bat</code> - carga de la batería, <em>%</em>
* etiqueta <code>$ac</code> - estado del dispositivo de alimentación. Devuelve (*) si la alimentación está conectada o <em>( )</em> si no lo está
* etiqueta <code>$album</code> - álbum de la canción actual. Debe estar instalado uno de los reproductores soportados
* etiqueta <code>$artist</code> - artista de la canción actual. Debe estar instalado uno de los reproductores soportados
* etiqueta <code>$progress</code> - progreso de la canción actual. Debe estar instalado uno de los reproductores soportados
* etiqueta <code>$time</code> - duración de la canción actual. Debe estar instalado uno de los reproductores soportados
* etiqueta <code>$title</code> - título de la canción actual. Debe estar instalado uno de los reproductores soportados
* etiqueta <code>$pscount</code> - cantidad de procesos en ejecución
* etiqueta <code>$pstotal</code> - total de procesos en ejecución
* etiqueta <code>$ps</code> - listado de procesos en ejecución
* etiqueta <code>$pkgcountN</code> - cantidad de paquetes con actualizaciones disponibles para el comando N. Por ejemplo, <code>$pkgcount0</code>
* etiqueta <code>$customN</code> - obtener la salida de ejecución del comando personalizado N (a partir de 0). Por ejemplo, <code>$custom0</code></p>
<p>El orden de las etiquetas será cambiado si cambias la posición del deslizador. Es posible usar código HTML para las etiquetas.</p>
<p><strong>NOTA</strong> no puedes establecer la etiqueta <code>$cpu</code> para que se muestre en la información de la swap, por citar un ejemplo. <strong><code>$cpu</code> solo funcionará en la etiqueta de la CPU</strong>.</p>
<h2>Ajustes avanzados</h2>
<p><strong>Hora personalizada</strong></p>
<ul>
<li>etiqueta <code>$dddd</code> - día de la semana en foramto largo</li>
<li>etiqueta <code>$ddd</code> - día de la semana en formato corto</li>
<li>etiqueta <code>$dd</code> - día</li>
<li>etiqueta <code>$d</code> - día sin ceros</li>
<li>etiqueta <code>$MMMM</code> - mes en formato largo</li>
<li>etiqueta <code>$MMM</code> - mes en formato corto</li>
<li>etiqueta <code>$MM</code> - mes</li>
<li>etiqueta <code>$M</code> - mes sin ceros</li>
<li>etiqueta <code>$yyyy</code> - año</li>
<li>etiqueta <code>$yy</code> - año en formato corto</li>
<li>etiqueta <code>$hh</code> - horas</li>
<li>etiqueta <code>$h</code> - horas sin ceros</li>
<li>etiqueta <code>$mm</code> - minutos</li>
<li>etiqueta <code>$m</code> - minutos sin ceros</li>
<li>etiqueta <code>$ss</code> - segundos</li>
<li>etiqueta <code>$s</code> - segundos sin ceros</li>
</ul>
<p><strong>Tiempo de ejecución del sistema personalizado</strong></p>
<ul>
<li>etiqueta <code>$dd</code> - días</li>
<li>etiqueta <code>$d</code> - días sin ceros</li>
<li>etiqueta <code>$hh</code> - horas</li>
<li>etiqueta <code>$h</code> - horas sin ceros</li>
<li>etiqueta <code>$mm</code> - minutos</li>
<li>etiqueta <code>$m</code> - minutos sin ceros</li>
</ul>
<p><strong>Unidades de temperatura</strong></p>
<p>Elija las unidades de temperatura. Las unidades disponibles son: Celsius, Farenheit y Kelvin.</p>
<p><strong>Dispositivos de temperatura</strong></p>
<p>El listado de dispositivos, será observado en la etiqueta de temperatura (los elementos de la lista desplegable provienen de <code>sensors</code>). El listado es editable, la tecla Suprimir borrará el elemento activo.</p>
<p><strong>Puntos de montaje</strong></p>
<p>El listado de puntos de montaje, será observado en la etiqueta de disco duro (los elementos de la lista desplegable provienen de <code>mount</code>). El listado es editable, la tecla Suprimir borrará el elemento activo.</p>
<p><strong>Disco duro (velocidad)</strong></p>
<p>Listado de dispositivos de disco duro, será observado en la etiqueta hddspeed (los elementos de la lista desplegable provienen de DataEngine).</p>
<p><strong>Disco duro (temperatura)</strong></p>
<p>El listado de dispositivos de disco duro, será observado desde la etiqueta disco duro (los elementos de la lista desplegable provienen de <code>find</code>). El listado es editable, la tecla Suprimir borrará el elemento activo.</p>
<p><strong>Directorio de red</strong></p>
<p>Ruta hacia el directorio que contiene información de los dispositivos de red. Por defecto es <code>/sys/class/net</code>. Se requiere para la selección automática del dispositivo de red.</p>
<p><strong>Dispositivo de red</strong></p>
<p>Usar el dispositivo especificado como activo. Los elementos de la lista desplegable provienen del <strong>directorio de red</strong>. Esto inhabilitará la selección automática del dispositivo de red.</p>
<p><strong>Dispositivo de batería</strong></p>
<p>El archivo que contiene información de la batería. El archivo (<code>/sys/class/power_supply/BAT0/capacity</code> por defecto) solo debería contener la carga de la batería en por ciento.</p>
<p><strong>Etiqueta alimentación conectada</strong></p>
<p>Línea que será mostrada cuando la alimentación esté conectada.</p>
<p><strong>Etiqueta alimentación conectada</strong></p>
<p>Línea que será mostrada cuando la alimentación esté desconectada.</p>
<p><strong>Dispositivo de alimentación</strong></p>
<p>El archivo con información de la alimentación. El archivo (<code>/sys/class/power_supply/AC/online</code> por defecto) debe contener <code>1</code> si la alimentación está conectada.</p>
<p><strong>Reproductor de música</strong></p>
<p>Seleccionar uno de los reproductores de música soportados para la etiqueta del reproductor.</p>
<h2>Ajustes de las ventanas emergentes</h2>
<p>Desde la versión 1.7.0 las etiquetas CPU, frecuencia de la CPU, memoria, swap y red soportan ventanas emergentes. Para habilitarlas es necesario tener marcadas las casillas de verificación pertinentes. El número de valores almacenados puede ser establecido en la pestaña. También es posible configurar los colores de los gráficos.</p>
<h2>Ajustes de DataEngine</h2>
<p><strong>Comando personalizado</strong></p>
<p><em>NOTA</em> Esto puede causar congelamiento de la computadora.</p>
<p>Listado de los comandos que serán ejecutados para etiquetas personalizadas.</p>
<p><strong>Dispositivo GPU</strong></p>
<p>Elegir uno de los dispositivos GPU soportados. <code>auto</code> habilitará la selección automática. El valor por defecto es <code>auto</code>.</p>
<p><strong>Disco duro</strong></p>
<p>Elegir uno de los discos duros para el monitor de temperatura del disco. <code>all</code> habilitará el monitor para todos los dispositivos. El valor por defecto es <code>all</code>.</p>
<p><strong>Dirección MPD</strong></p>
<p>Dirección del servidor MPD. El valor por defecto es <code>localhost</code>.</p>
<p><strong>Puerto MPD</strong></p>
<p>Puerto del servidor MPD. El valor por defecto es <code>6600</code>.</p>
<p><strong>Gestor de paquetes</strong></p>
<p>Listado de comandos que serán ejecutados. La cantidad de líneas nulas es el número de líneas innecesarias. Predeterminados:
* <em>Arch</em>: <code>PKGCMD=pacman -Qu</code>, <code>PKGNULL=0</code>
* <em>Debian</em>: <code>PKGCMD=apt-show-versions -u -b</code>, <code>PKGNULL=0</code>
* <em>Ubuntu</em>: <code>PKGCMD=aptitude search '~U'</code>, <code>PKGNULL=0</code>
* <em>Fedora</em>: <code>PKGCMD=yum list updates</code>, <code>PKGNULL=3</code>
* <em>FreeBSD</em>: <code>PKGCMD=pkg_version -I -l '&lt;'</code>, <code>PKGNULL=0</code>
* <em>Mandriva</em>: <code>PKGCMD=urpmq --auto-select</code>, <code>PKGNULL=0</code></p>
<h2>Configuración de DataEngine</h2>
<p>Se puede editar la configuración de DataEngine. Se encuentra en <code>/usr/share/config/extsysmon.conf</code> o <code>$HOME/share/config/extsysmon.conf</code> en dependencia del tipo de instalación. Quitar el comentario de la línea requerida y editarlo.</p>
<h1>Instrucción</h1>
<h2>Dependencias</h2>
<ul>
<li>kdebase-workspace</li>
<li>kdebindings-python2</li>
<li>lm_sensors (<em>para definir el dispositivo de temperatura</em>)</li>
<li>sysstat (<em>para las notificaciones</em>)</li>
</ul>
<h2>Dependencias opcionales</h2>
<ul>
<li>controlador propietario de video</li>
<li>hddtemp (asegúrate de que puede ser ejecutado con <code>sudo</code> y sin contraseña. Solo hay que agregar la siguiente línea al archivo <code>/etc/sudoers</code>: <code>$USERNAME ALL=NOPASSWD: /usr/bin/hddtemp</code>)</li>
<li>reproductor de música (amarok, clementine, mpd or qmmp)</li>
</ul>
<h2>Dependencias de construcción</h2>
<ul>
<li>automoc4</li>
<li>cmake</li>
<li>kdebase-runtime</li>
</ul>
<h2>Instalación</h2>
<ul>
<li>descargar fuentes</li>
<li><p>instalar</p>
<pre><code>mkdir build &amp;&amp; cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`kde4-config --localprefix` ../
make &amp;&amp; make install
</code></pre>
<p>También es posible instalarlo en <code>/</code>:</p>
<pre><code>mkdir build &amp;&amp; cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` ../
make &amp;&amp; sudo make install
</code></pre></li>
</ul>
<h1>Información adicional</h1>
<h2>TODO (funcionalidades solicitadas)</h2>
<h2>Enlaces</h2>
<ul>
<li><a href="http://arcanis.name/projects/pytextmonitor/">Sitio oficial</a></li>
<li>Plasmoide en <a href="http://kde-look.org/content/show.php/Py+Text+Monitor?content=157124">kde-look</a></li>
<li>DataEngine en <a href="http://kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773">kde-look</a></li>
<li>Archlinux <a href="https://aur.archlinux.org/packages/kdeplasma-applets-pytextmonitor/">AUR</a> package</li>
</ul>

243
sources/readme/ru.html Normal file
View File

@ -0,0 +1,243 @@
<h1>pytextmonitor</h1>
<h2>Информация</h2>
<p>PyTextMonitor - минималистичный плазмоид, написанный на Python2. Он выглядит, как виджеты в Awesome WM.</p>
<p><strong>ВНИМАНИЕ</strong> <a href="https://github.com/arcan1s/pytextmonitor/issues/14">НУЖНЫ ПЕРЕВОДЧИКИ!</a></p>
<h2>Настройка</h2>
<p>Для редактирования внешнего вида, откройте окно настроек и установите требуемый формат в поля:
* тег <code>$time</code> - время в стандартном формате. Например, <em>fri Nov 6 04:48:01 2013</em>
* тег <code>$isotime</code> - время в ISO формате
* тег <code>$shorttime</code> - время в коротком формате
* тег <code>$longtime</code> - время в длинном формате
* тег <code>$custom</code> - свой формат времени
* тег <code>$uptime</code> - время работы, <em>---d--h--m</em>
* тег <code>$custom</code> - свой формат аптайма
* тег <code>$cpu</code> - общая загрузка CPU, <em>%</em>
* тег <code>$cpuN</code> - загрузка CPU для ядра N, <em>%</em>
* тег <code>$cpucl</code> - средняя частота CPU, <em>MHz</em>
* тег <code>$cpuclN</code> - частота CPU для ядра N, <em>MHz
* тег <code>$tempN</code> - температура для устройства N. Например, <code>$temp0</code>
* тег <code>$gpu</code> - использование GPU, *%</em>. <code>aticonfig</code> или <code>nvidia-smi</code> должны быть установлены
* тег <code>$gputemp</code> - температура GPU. <code>aticonfig</code> или <code>nvidia-smi</code> должны быть установлены
* тег <code>$mem</code> - использование RAM, <em>%</em>
* тег <code>$memmb</code> - использование RAM, <em>MB</em>
* тег <code>$memgb</code> - использование RAM, <em>GB</em>
* тег <code>$swap</code> - swap, <em>%</em>
* тег <code>$swapmb</code> - swap, <em>MB</em>
* тег <code>$swapgb</code> - swap, <em>GB</em>
* тег <code>$hddN</code> - использование точки монтирования N, <em>%</em>. Например, <code>$hdd0</code>
* тег <code>$hddmbN</code> - использование точки монтирования N, <em>KB/s</em>. Например, <code>$hddmb0</code>
* тег <code>$hddgbN</code> - использование точки монтирования N, <em>KB/s</em>. Например, <code>$hddgb0</code>
* тег <code>$hddrN</code> - скорость записи на диск N, <em>KB/s</em>. Например, <code>$hddr0</code>
* тег <code>$hddwN</code> - скорость чтения с диска N, <em>KB/s</em>. Например, <code>$hddw0</code>
* тег <code>$hddtempN</code> - температура HDD N. Например, <code>$hddtemp0</code>
* тег <code>$down</code> - скорость загрузки, <em>KB/s</em>
* тег <code>$up</code> - скорость отдачи, <em>KB/s</em>
* тег <code>$netdev</code> - текущий сетевой интерфейс
* тег <code>$bat</code> - заряд батареи, <em>%</em>
* тег <code>$ac</code> - статус адаптора питания. Возвращает (*), если AC подключен или <em>( )</em>, если нет
* тег <code>$album</code> - альбом. Один из поддерживаемых плееров должен быть установлен
* тег <code>$artist</code> - исполнитель. Один из поддерживаемых плееров должен быть установлен
* тег <code>$progress</code> - прогресс. Один из поддерживаемых плееров должен быть установлен
* тег <code>$time</code> - длительность. Один из поддерживаемых плееров должен быть установлен
* тег <code>$title</code> - название. Один из поддерживаемых плееров должен быть установлен
* тег <code>$pscount</code> - число запущенных процессов
* тег <code>$pstotal</code> - общее число процессов
* тег <code>$ps</code> - список процессов
* тег <code>$pkgcountN</code> - число пакетов, которые могут быть обновлены, для команды N. Например, <code>$pkgcount0</code>
* тег <code>$customN</code> - возвращает результат своей команды N. Например, <code>$custom0</code></p>
<p>Порядок полей изменится, если вы измените позицию слайдеров. HTML теги в полях работают корректно.</p>
<p><strong>ЗАМЕЧАНИЕ</strong> вы не можете установить тег <code>$cpu</code>, например, в поле swap. <strong><code>$cpu</code> будет работать только в поле CPU</strong>.</p>
<h2>Расширенные настройки</h2>
<p><strong>Свой формат времени</strong></p>
<ul>
<li>тег <code>$dddd</code> - день недели в длинном формате</li>
<li>тег <code>$ddd</code> - день недели в коротком формате</li>
<li>тег <code>$dd</code> - день</li>
<li>тег <code>$d</code> - день без нуля</li>
<li>тег <code>$MMMM</code> - месяц в длинном формате</li>
<li>тег <code>$MMM</code> - месяц в коротком формате</li>
<li>тег <code>$MM</code> - месяц</li>
<li>тег <code>$M</code> - месяц без нуля</li>
<li>тег <code>$yyyy</code> - год</li>
<li>тег <code>$yy</code> - год в коротком формате</li>
<li>тег <code>$hh</code> - часы</li>
<li>тег <code>$h</code> - часы без нуля</li>
<li>тег <code>$mm</code> - минуты</li>
<li>тег <code>$m</code> - минуты без нуля</li>
<li>тег <code>$ss</code> - секунды</li>
<li>тег <code>$s</code> - секунды без нуля</li>
</ul>
<p><strong>Свой формат аптайма</strong></p>
<ul>
<li>тег <code>$dd</code> - дни аптайма</li>
<li>тег <code>$d</code> - дни аптайма без нуля</li>
<li>тег <code>$hh</code> - часы аптайма</li>
<li>тег <code>$h</code> - часы аптайма без нуля</li>
<li>тег <code>$mm</code> - минуты аптайма</li>
<li>тег <code>$m</code> - минуты аптайма без нуля</li>
</ul>
<p><strong>Температурные единицы</strong></p>
<p>Выберете единицы температуры. Доступные единицы следующие: Цельсий, Фаренгейт и Кельвин.</p>
<p><strong>Датчики температуры</strong></p>
<p>Список датчиков, которые будут наблюдаться в поле temo (содержимое комбо бокса берется из <code>sensors</code>). Виджет редактируем, клавиша delete удалит текущую строку.</p>
<p><strong>Точки монтирования</strong></p>
<p>Список точек монтирования, которые будут наблюдаться в поле hdd (содержимое комбо бокса берется из <code>mount</code>). Виджет редактируем, клавиша delete удалит текущую строку.</p>
<p><strong>HDD (скорость)</strong></p>
<p>Список HDD, которые будут наблюдаться в поле hddspeed (содержимое комбо бокса берется из DataEngine). Виджет редактируем, клавиша delete удалит текущую строку.</p>
<p><strong>HDD (температура)</strong></p>
<p>Список HDD, которые будут наблюдаться в поле hddtemp (содержимое комбо бокса берется из <code>find</code>). Виджет редактируем, клавиша delete удалит текущую строку.</p>
<p><strong>Директория с сетевыми интерфейсами</strong></p>
<p>Путь к директории, которая содержит информацию о сетевых интерфейсах. По умолчанию <code>/sys/class/net</code>. Требуется для определения сетевого устройства.</p>
<p><strong>Сетевое устройство</strong></p>
<p>Использовать указанный интерфейс, как активный. Содержимое комбо бокса берется из <strong>директории с сетевыми интерфейсами</strong>. Эта опция отключит авто определение интерфейса.</p>
<p><strong>Устройство батареи</strong></p>
<p>Файл с информацией о батарее. Данный файл (<code>/sys/class/power_supply/BAT0/capacity</code> по умолчанию) должен содержать только заряд батареи в процентах.</p>
<p><strong>AC online тег</strong></p>
<p>Строка, которая будет показана, когда AC онлайн.</p>
<p><strong>AC offline тег</strong></p>
<p>Строка, которая будет показана, когда AC оффлайн.</p>
<p><strong>Устройство AC</strong></p>
<p>Файл с информацией об адапторе питания. Данный файл (<code>/sys/class/power_supply/AC/online</code> по умолчанию) должен содержать <code>1</code>, если адаптор подключен.</p>
<p><strong>Музыкальные плеер</strong></p>
<p>Выберете один из поддерживаемых музыкальных плееров.</p>
<h2>Настройки тултипа</h2>
<p>Начиная с версии 1.7.0 поля CPU, частота CPU, память, swap и сеть поддерживают графический тултип. Чтобы включить их, просто сделайте требуемые чекбоксы полностью чекнутыми. Число хранимых значений может быть выставленно в данной вкладке. Цвета графиков также настраиваются.</p>
<h2>Настройки DataEngine</h2>
<p><strong>Своя команда</strong></p>
<p><em>ЗАМЕЧАНИЕ</em> Может вызвать зависание компьютера.</p>
<p>Команды, которые будет запущена для соответствующего поля.</p>
<p><strong>Устройство GPU</strong></p>
<p>Выберете одно из поддерживаемых устройств GPU. <code>auto</code> включит автоматическое определение. По умолчанию <code>auto</code>.</p>
<p><strong>HDD</strong></p>
<p>Выберете один из HDD для монитора его температуры. <code>all</code> включит монитор для всех доступных устройств. По умолчанию <code>all</code>.</p>
<p><strong>Команда hddtemp</strong></p>
<p>Введите команду, которая будет запущена для hddtemp DataEngine. По умолчанию <code>sudo hddtemp</code>.</p>
<p><strong>Адрес MPD</strong></p>
<p>Адрес MPD сервера. По умолчанию <code>localhost</code>.</p>
<p><strong>Порт MPD</strong></p>
<p>Порт MPD сервера. По умолчанию <code>6600</code>.</p>
<p><strong>Package manager</strong></p>
<p>Список команд, которые будут запущены. Число пустых строк - число ненужных для подсчета строк. Стандартные настройки:
* <em>Arch</em>: <code>PKGCMD=pacman -Qu</code>, <code>PKGNULL=0</code>
* <em>Debian</em>: <code>PKGCMD=apt-show-versions -u -b</code>, <code>PKGNULL=0</code>
* <em>Ubuntu</em>: <code>PKGCMD=aptitude search '~U'</code>, <code>PKGNULL=0</code>
* <em>Fedora</em>: <code>PKGCMD=yum list updates</code>, <code>PKGNULL=3</code>
* <em>FreeBSD</em>: <code>PKGCMD=pkg_version -I -l '&lt;'</code>, <code>PKGNULL=0</code>
* <em>Mandriva</em>: <code>PKGCMD=urpmq --auto-select</code>, <code>PKGNULL=0</code></p>
<h2>Настройка DataEngine</h2>
<p>Вы можете отредактировать настройки DataEngine вручную. Откройте файл <code>/usr/share/config/extsysmon.conf</code> или <code>$HOME/.kde4/share/config/extsysmon.conf</code>, в зависимости от типа установки. Раскомментируйте требуемые строки и отредактируйте их.</p>
<h1>Инструкция</h1>
<h2>Зависимости</h2>
<ul>
<li>kdebase-workspace</li>
<li>kdebindings-python2</li>
<li>lm_sensors (<em>для определения датчиков температуры</em>)</li>
<li>sysstat (<em>для уведомлений</em>)</li>
</ul>
<h2>Опциональные зависимости</h2>
<ul>
<li>проприетарный видеодрайвер</li>
<li>hddtemp (убедитесь, что может быть запущен с <code>sudo</code> без пароля. Просто добавьте следующую строку в <code>/etc/sudoers</code>: <code>$USERNAME ALL=NOPASSWD: /usr/bin/hddtemp</code>)</li>
<li>музыкальный плеер (amarok, clementine, mpd или qmmp)</li>
</ul>
<h2>Зависимости сборки</h2>
<ul>
<li>automoc4</li>
<li>cmake</li>
<li>kdebase-runtime</li>
</ul>
<h2>Установка</h2>
<ul>
<li>скачать исходный архив</li>
<li><p>установить</p>
<pre><code>mkdir build &amp;&amp; cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`kde4-config --localprefix` ../
make &amp;&amp; make install
</code></pre>
<p>Для установки в <code>/</code>:</p>
<pre><code>mkdir build &amp;&amp; cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` ../
make &amp;&amp; sudo make install
</code></pre></li>
</ul>
<h1>Дополнительная информация</h1>
<h2>TODO (wish list)</h2>
<h2>Ссылки</h2>
<ul>
<li><a href="http://arcanis.name/projects/pytextmonitor/">Домашняя страница</a></li>
<li>Виджет на <a href="http://kde-look.org/content/show.php/Py+Text+Monitor?content=157124">kde-look</a></li>
<li>DataEngine на <a href="http://kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773">kde-look</a></li>
<li>Пакет для Archlinux в <a href="https://aur.archlinux.org/packages/kdeplasma-applets-pytextmonitor/">AUR</a></li>
</ul>

243
sources/readme/uk.html Normal file
View File

@ -0,0 +1,243 @@
<h1>pytextmonitor</h1>
<h2>Информация</h2>
<p>PyTextMonitor - мінімалістичний плазмоїд, що написаний на Python2. Він виглядає, як віджети в Awesome WM.</p>
<p><strong>УВАГА</strong> <a href="https://github.com/arcan1s/pytextmonitor/issues/14">ПОТРІБНІ ПЕРЕКЛАДАЧІ!</a></p>
<h2>Налаштування</h2>
<p>Для редагування зовнішного вигляду, відкрийте вікно налаштувань та встановіть потрібний формат в поля:
* тег <code>$time</code> - час у стандартному форматі. Наприклад, <em>fri Nov 6 04:48:01 2013</em>
* тег <code>$isotime</code> - час в ISO форматі
* тег <code>$shorttime</code> - час в короткому форматі
* тег <code>$longtime</code> - час в довгому форматі
* тег <code>$custom</code> - свій формат часу
* тег <code>$uptime</code> - час роботи, <em>---d--h--m</em>
* тег <code>$custom</code> - свій формат аптайму
* тег <code>$cpu</code> - загальне завантаження CPU, <em>%</em>
* тег <code>$cpuN</code> - завантаження CPU для ядра N, <em>%</em>
* тег <code>$cpucl</code> - середня частота CPU, <em>MHz</em>
* тег <code>$cpuclN</code> - частота CPU для ядра N, <em>MHz</em>
* тег <code>$tempN</code> - температура для пристрою N. Наприклад, <code>$temp0</code>
* тег <code>$gpu</code> - використання GPU, <em>%</em>. <code>aticonfig</code> або <code>nvidia-smi</code> мають бути встановлені
* тег <code>$gputemp</code> - температура GPU. <code>aticonfig</code> або <code>nvidia-smi</code> мають бути встановлені
* тег <code>$mem</code> - використання RAM, <em>%</em>
* тег <code>$memmb</code> - використання RAM, <em>MB</em>
* тег <code>$memgb</code> - використанняRAM, <em>GB</em>
* тег <code>$swap</code> - swap, <em>%</em>
* тег <code>$swapmb</code> - swap, <em>MB</em>
* тег <code>$swapgb</code> - swap, <em>GB</em>
* тег <code>$hddN</code> - використання точки монтування N, <em>%</em>. Наприклад, <code>$hdd0</code>
* тег <code>$hddmbN</code> - використання точки монтування N, <em>KB/s</em>. Наприклад, <code>$hddmb0</code>
* тег <code>$hddgbN</code> - використання точки монтування N, <em>KB/s</em>. Наприклад, <code>$hddgb0</code>
* тег <code>$hddrN</code> - швидкість запису на диск N, <em>KB/s</em>. Наприклад, <code>$hddr0</code>
* тег <code>$hddwN</code> - швидкість читання з диска N, <em>KB/s</em>. Наприклад, <code>$hddw0</code>
* тег <code>$hddtempN</code> - температура HDD N. Наприклад, <code>$hddtemp0</code>
* тег <code>$down</code> - швидкість завантаження, <em>KB/s</em>
* тег <code>$up</code> - швидкість віддачі, <em>KB/s</em>
* тег <code>$netdev</code> - поточний мережний інтерфейс
* тег <code>$bat</code> - заряд батареї, <em>%</em>
* тег <code>$ac</code> - статус адаптера живлення. Повертає <code>(*)</code>, якщо AC підключений або <code>( )</code>, якщо ні
* тег <code>$album</code> - альбом. Один з підтримуваних плеєрів повинен бути встановлений
* тег <code>$artist</code> - виконавець. Один з підтримуваних плеєрів повинен бути встановлений
* тег <code>$progress</code> - прогрес. Один з підтримуваних плеєрів повинен бути встановлений
* тег <code>$time</code> - тривалість. Один з підтримуваних плеєрів повинен бути встановлений
* тег <code>$title</code> - назва. Один з підтримуваних плеєрів повинен бути встановлений
* тег <code>$pscount</code> - кількість запущених процесів
* тег <code>$pstotal</code> - загальна кількість процесів
* тег <code>$ps</code> - перелік процесів
* тег <code>$pkgcountN</code> - кількість пакетів, що можуть бути оновлені, для команди N. Наприклад, <code>$pkgcount0</code>
* тег <code>$customN</code> - повертає результат своеї команди N. Наприклад, <code>$custom0</code></p>
<p>Порядок полів зміниться, якщо ви зміните позицію слайдерів. HTML теги в полях працюють коректно.</p>
<p><strong>ЗАУВАЖЕННЯ</strong> ви не зможете встановити тег <code>$cpu</code>, наприклад, в полі swap. <strong><code>$cpu</code> буде працювати тільки в полі CPU</strong>.</p>
<h2>Розширені налаштування</h2>
<p><strong>Свіой формат часу</strong></p>
<ul>
<li>тег <code>$dddd</code> - день тижня у довгому форматі</li>
<li>тег <code>$ddd</code> - день тижня у короткому форматі</li>
<li>тег <code>$dd</code> - день</li>
<li>тег <code>$d</code> - день без нуля</li>
<li>тег <code>$MMMM</code> - місяць у довгому форматі</li>
<li>тег <code>$MMM</code> - місяць у короткому форматі</li>
<li>тег <code>$MM</code> - місяць</li>
<li>тег <code>$M</code> - місяця без нуля</li>
<li>тег <code>$yyyy</code> - рік</li>
<li>тег <code>$yy</code> - рік у короткому форматіе</li>
<li>тег <code>$hh</code> - години</li>
<li>тег <code>$h</code> - години без нуля</li>
<li>тег <code>$mm</code> - хвилини</li>
<li>тег <code>$m</code> - хвилини без нуля</li>
<li>тег <code>$ss</code> - секунди</li>
<li>тег <code>$s</code> - секунди без нуля</li>
</ul>
<p><strong>Свій формат аптайму</strong></p>
<ul>
<li>тег <code>$dd</code> - дні аптайму</li>
<li>тег <code>$d</code> - дні аптайму без нуля</li>
<li>тег <code>$hh</code> - години аптайму</li>
<li>тег <code>$h</code> - години аптайму без нуля</li>
<li>тег <code>$mm</code> - хвилини аптайму</li>
<li>тег <code>$m</code> - хвилини аптайму без нуля</li>
</ul>
<p><strong>Одиниці виміру температури</strong></p>
<p>Оберіть одиниці виміру температур. Доступні такі одиниці: Цельсій, Фаренгейт та Кельвін.</p>
<p><strong>Датчики температури</strong></p>
<p>Перелік датчиків, що будуть спостерігатись в полі temo (вміст комбо боксу береться із <code>sensors</code>). Віджет можна редагувати, клавіша delete видаляє поточний рядок.</p>
<p><strong>Точки монтування</strong></p>
<p>Перелік точок монтування, які будуть спостерігатися в полі hdd (вміст комбо боксу береться із <code>mount</code>). Віджет можна редагувати, клавіша delete видаляє поточний рядок.</p>
<p><strong>HDD (швидкість)</strong></p>
<p>Перелік HDD, які будуть спостерігатися в полі hddspeed (вміст комбо боксу береться із DataEngine). Віджет можна редагувати, клавіша delete видаляє поточний рядок.</p>
<p><strong>HDD (температура)</strong></p>
<p>Перелік HDD, які будуть спостерігатися в полі hddtemp (вміст комбо боксу береться iз <code>find</code>). Віджет можна редагувати, клавіша delete видаляє поточний рядок.</p>
<p><strong>Директорія з мережевими інтерфейсами</strong></p>
<p>Шлях до директорії, яка містить інформацію про мережеві інтерфейси. За замовчуванням <code>/sys/class/net</code>. Потрібно для визначення мережевого пристрою.</p>
<p><strong>Мережевий пристрій</strong></p>
<p>Використовувати вказаний інтерфейс, як активний. Вміст комбо боксу береться із <strong>директорії з мережевими інтерфейсами</strong>. Ця опція вимкне авто визначення інтерфейсу.</p>
<p><strong>Пристрій батареї</strong></p>
<p>Файл з інформацією про батарею. Даний файл (<code>/sys/class/power_supply/BAT0/capacity</code> за замовчуванням) повинен містити тільки заряд батареї в процентах.</p>
<p><strong>AC online тег</strong></p>
<p>Рядок, що буде показаний, коли AC онлайн.</p>
<p><strong>AC offline тег</strong></p>
<p>Рядок, що буде показаний, коли AC оффлайн.</p>
<p><strong>Пристрій AC</strong></p>
<p>Файл з інформациею про адаптер живлення. Даний файл (<code>/sys/class/power_supply/AC/online</code> за замовчуванням) повинен містити <code>1</code>, якщо адаптер підключений.</p>
<p><strong>Музичний плеєр</strong></p>
<p>Оберіть один з підтримуваних музичних плеєрів.</p>
<h2>Налаштування тултіпу</h2>
<p>Починаючи з версії 1.7.0 поля CPU, частота CPU, пам’ять, swap та мережа підтримують графічний тултіп. Щоб їх ввімкнути, просто зробіть необхідні чекбокси повністю чекнутими. Кількість зберігаємих значень може бути виставлена в даній вкладці. Кольори графікіф також налаштовуються.</p>
<h2>Налаштування DataEngine</h2>
<p><strong>Своя команда</strong></p>
<p><em>ЗАУВАЖЕННЯ</em> Може призвести до зависання комп’ютера.</p>
<p>Команда, що буде запущена для відповідного поля.</p>
<p><strong>Пристрій GPU</strong></p>
<p>Оберіть один з підтримуваних пристроїв GPU. <code>auto</code> ввімкне автоматичне визначення. За замовчуванням <code>auto</code>.</p>
<p><strong>HDD</strong></p>
<p>Оберіть один з HDD для контролю його температури. <code>all</code> ввімкне контроль для всих доступних пристроїв. За замовчуванням <code>all</code>.</p>
<p><strong>Команда hddtemp</strong></p>
<p>Оберіть команду, яка буде запущена для hddtemp DataEngine. За замовчуванням <code>sudo hddtemp</code>.</p>
<p><strong>Адреса MPD</strong></p>
<p>Адреса MPD серверу. За замовчуванням <code>localhost</code>.</p>
<p><strong>Порт MPD</strong></p>
<p>Порт MPD серверу. За замовчуванням <code>6600</code>.</p>
<p><strong>Package manager</strong></p>
<p>Перелік команд, які будуть запущені. кількість пустих рядків - кількість непотрібних для підрахунку рядків. Стандартні налаштування:
* <em>Arch</em>: <code>PKGCMD=pacman -Qu</code>, <code>PKGNULL=0</code>
* <em>Debian</em>: <code>PKGCMD=apt-show-versions -u -b</code>, <code>PKGNULL=0</code>
* <em>Ubuntu</em>: <code>PKGCMD=aptitude search '~U'</code>, <code>PKGNULL=0</code>
* <em>Fedora</em>: <code>PKGCMD=yum list updates</code>, <code>PKGNULL=3</code>
* <em>FreeBSD</em>: <code>PKGCMD=pkg_version -I -l '&lt;'</code>, <code>PKGNULL=0</code>
* <em>Mandriva</em>: <code>PKGCMD=urpmq --auto-select</code>, <code>PKGNULL=0</code></p>
<h2>Налаштування DataEngine</h2>
<p>Ви можете відредагувати налаштування DataEngine вручну. Відкрийте файл <code>/usr/share/config/extsysmon.conf</code> або <code>$HOME/.kde4/share/config/extsysmon.conf</code>, в залежності від типу установки. Розкоментуйте потрібні рядки та відредагуйте їх.</p>
<h1>Інструкція</h1>
<h2>Залежності</h2>
<ul>
<li>kdebase-workspace</li>
<li>kdebindings-python2</li>
<li>lm_sensors (<em>для визначення датчиків температури</em>)</li>
<li>sysstat (<em>для сповіщень</em>)</li>
</ul>
<h2>Опціональні залежності</h2>
<ul>
<li>проприєтарний відеодрайвер</li>
<li>hddtemp (переконайтесь, що може бути запущений з <code>sudo</code> без пароля. Просто добавте наступний рядок в <code>/etc/sudoers</code>: <code>$USERNAME ALL=NOPASSWD: /usr/bin/hddtemp</code>)</li>
<li>музичний плеєр (amarok, clementine, mpd или qmmp)</li>
</ul>
<h2>Залежності збирання</h2>
<ul>
<li>automoc4</li>
<li>cmake</li>
<li>kdebase-runtime</li>
</ul>
<h2>Установка</h2>
<ul>
<li>скачати вихідний архів</li>
<li><p>встановити</p>
<pre><code>mkdir build &amp;&amp; cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`kde4-config --localprefix` ../
make &amp;&amp; make install
</code></pre>
<p>Для установки в <code>/</code>:</p>
<pre><code>mkdir build &amp;&amp; cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` ../
make &amp;&amp; sudo make install
</code></pre></li>
</ul>
<h1>Додаткова інформація</h1>
<h2>TODO (wish list)</h2>
<h2>Посилання</h2>
<ul>
<li><a href="http://arcanis.name/projects/pytextmonitor/">Домашня сторінка</a></li>
<li>Віджет на <a href="http://kde-look.org/content/show.php/Py+Text+Monitor?content=157124">kde-look</a></li>
<li>DataEngine на <a href="http://kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773">kde-look</a></li>
<li>Пакет для Archlinux в <a href="https://aur.archlinux.org/packages/kdeplasma-applets-pytextmonitor/">AUR</a></li>
</ul>