mirror of
https://github.com/arcan1s/arcanis.me.git
synced 2025-04-24 15:27:17 +00:00
rewrite project pages to md
This commit is contained in:
arcan1s
parent
4c9ff17bf0
commit
2ab2093829
@ -1,914 +0,0 @@
|
|||||||
---
|
|
||||||
hastr: true
|
|
||||||
layout: project
|
|
||||||
title: Awesome Widgets
|
|
||||||
short: awesome-widgets
|
|
||||||
tags: python, kde, qt, linux, system, awesome
|
|
||||||
hasgui: true
|
|
||||||
hasdocs: false
|
|
||||||
developers:
|
|
||||||
- Evgeniy Alekseev
|
|
||||||
- Ernesto Avilés Vzqz (Spanish translation)
|
|
||||||
- Mermouy (French translation)
|
|
||||||
- underr (Brazillian Portuguese translation)
|
|
||||||
- Виктор Слободян (Ukrainian translation)
|
|
||||||
- Lemueler (Chinese translation)
|
|
||||||
- Heimen Stoffels (Dutch translation)
|
|
||||||
license: GPLv3
|
|
||||||
links:
|
|
||||||
- Plasmoid page on <a href="//kde-look.org/content/show.php/Awesome+Widgets?content=157124" title="kde-look">kde-look.org</a>
|
|
||||||
- DataEngine page on <a href="//kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773" title="kde-look">kde-look.org</a>
|
|
||||||
- Archlinux <a href="//aur.archlinux.org/packages/kdeplasma-applets-awesome-widgets" title="AUR">AUR package</a>
|
|
||||||
- <a href="//software.opensuse.org/package/plasma5-awesome-widgets" title="openSUSE">openSUSE package</a> (thanks to Kott)
|
|
||||||
- <a href="//github.com/arcan1s/awesome-widgets/releases" title="Ubuntu">Ubuntu package</a>
|
|
||||||
- <a href="/en/2014/09/04/migration-to-v2/" title="Migration">Migration to version 2.0</a>
|
|
||||||
- <a href="/en/2014/12/19/aw-v21-bells-and-whistles/" title="ExtItems">Extensions</a>
|
|
||||||
---
|
|
||||||
<!-- info block -->
|
|
||||||
<h2><a href="#information" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information</h2>
|
|
||||||
<p>A collection of minimalistic easily configurable Plasmoids written on <code>C++/Qt</code>. They look like widgets in <a href="//awesome.naquadah.org/" title="Awesome Homepage">Awesome WM</a>. Also this packages has an additional system <a href="//techbase.kde.org/Development/Tutorials/Plasma/DataEngines" title="Developers tutorial">DataEngine</a>.</p>
|
|
||||||
|
|
||||||
<p><b>NOTE:</b> <a href="//github.com/arcan1s/awesome-widgets/issues/14" title="Ticket">LOOKING FOR TRANSLATORS!</a></p>
|
|
||||||
<p><b>PLASMA 5 COMPATIBLE!</b></p>
|
|
||||||
|
|
||||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors</h3>
|
|
||||||
<ul>
|
|
||||||
{% for devel in page.developers %}
|
|
||||||
<li>{{ devel }}</li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License</h3>
|
|
||||||
<ul>
|
|
||||||
<li>{{ page.license }}</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#changelog" class="anchor" id="changelog"><span class="octicon octicon-link"></span></a>Changelog</h3>
|
|
||||||
<p><a href="//github.com/arcan1s/awesome-widgets/blob/master/CHANGELOG" title="GitHub">CHANGELOG</a></p>
|
|
||||||
<!-- end of info block -->
|
|
||||||
|
|
||||||
<!-- install block -->
|
|
||||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation</h2>
|
|
||||||
|
|
||||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction</h3>
|
|
||||||
<ul>
|
|
||||||
<li>Download an <a href="//github.com/arcan1s/awesome-widgets/releases" title="GitHub">archive</a> with latest version of source files.</li>
|
|
||||||
<li>Extract it and install:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cd /where/is/applet/
|
|
||||||
mkdir build && cd build
|
|
||||||
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr ../
|
|
||||||
make
|
|
||||||
sudo make install
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<b>NOTE:</b> on Plasma 5 it very likely requires <code>-DKDE_INSTALL_USE_QT_SYS_PATHS=ON</code> flag
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies</h3>
|
|
||||||
<p>I want note that all were tested on latest version of dependencies.</p>
|
|
||||||
<ul>
|
|
||||||
<li>plasma-framework</li>
|
|
||||||
<li>cmake <i>(make)</i></li>
|
|
||||||
<li>extra-cmake-modules <i>(make)</i></li>
|
|
||||||
<li>hddtemp <b>or</b> smartmontools <i>(optional, for HDD temperature monitor)</i></li>
|
|
||||||
<li>one of supported music player <i>(optional, for music player monitor)</i></li>
|
|
||||||
<li>proprietary video driver <i>(optional, for GPU monitor)</i></li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of install block -->
|
|
||||||
|
|
||||||
<!-- howto block -->
|
|
||||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use</h2>
|
|
||||||
<p>Open your Plasma widgets and select <code>Awesome Widget</code>.</p>
|
|
||||||
|
|
||||||
<h3><a href="#tips" class="anchor" id="tips"><span class="octicon octicon-link"></span></a>Tips & tricks</h3>
|
|
||||||
<p>You may use different colours inside. Just put label text into html code. See <a href="//github.com/arcan1s/awesome-widgets/issues/9" title="GitHub">issue</a> for more details.</p>
|
|
||||||
<!-- end of howto block -->
|
|
||||||
|
|
||||||
<!-- config block -->
|
|
||||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Configuration</h2>
|
|
||||||
|
|
||||||
<h3><a href="#deconf" class="anchor" id="deconf"><span class="octicon octicon-link"></span></a>DataEngine configuration</h3>
|
|
||||||
<p>You may edit DataEngine configuration. It is <code>/etc/xdg/plasma-dataengine-extsysmon.conf</code> and <code>$HOME/.config/plasma-dataengine-extsysmon.conf</code>. Uncomment needed line and edit it.</p>
|
|
||||||
|
|
||||||
<h4><a href="#deoptions" class="anchor" id="deoptions"><span class="octicon octicon-link"></span></a>DataEngine options</h4>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<th>ACPIPATH</th>
|
|
||||||
<td>Path to ACPI devices. Default is <code>/sys/class/power_supply/</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>GPUDEV</th>
|
|
||||||
<td>Set GPU device. May be <code>nvidia</code> (for nVidia), <code>ati</code> (for ATI Radeon), <code>disable</code> or <code>auto</code>. Default is <code>auto</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>HDDDEV</th>
|
|
||||||
<td>Set block device for <code>hddtemp</code> comma separated or use <code>all</code>. <code>disable</code> will disable HDD temperature monitor. Default is <code>all</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>HDDTEMPCMD</th>
|
|
||||||
<td>A command which will be run for hddtemp DataEngine. Default is <code>sudo hddtemp</code>. Supported applications are <code>hddtemp</code> and <code>smartmontools</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>MPDADDRESS</th>
|
|
||||||
<td>MPD host address. Default is <code>localhost</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>MPDPORT</th>
|
|
||||||
<td>MPD host port. Default is <code>6600</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>PLAYER</th>
|
|
||||||
<td>Set music player. Supported players are mpd and MPRIS/DBus supported. <code>disable</code> will disable this monitor.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>PLAYERSYMBOLS</th>
|
|
||||||
<td>Select symbols count for dynamic player tags. Default is <code>10</code>.</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
<h3><a href="#widconf" class="anchor" id="widconf"><span class="octicon octicon-link"></span></a>Widget configuration</h3>
|
|
||||||
<p>For edited output you must open Settings window and setup output format. HTML tags work normally.</p>
|
|
||||||
|
|
||||||
<p>Available flags are in the table below.<br>
|
|
||||||
<b>NOTE</b> The numbering of all arrays in variables starts at 0.</p>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<th>Type</th>
|
|
||||||
<th>Tag</th>
|
|
||||||
<th>Description</th>
|
|
||||||
<th>Since</th>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="5">Time</th>
|
|
||||||
<td><code>$time</code></td>
|
|
||||||
<td>Time in default format. For example, <code>fri Nov 6 04:48:01 2013</code>.</td>
|
|
||||||
<td>1.5.1</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$isotime</code></td>
|
|
||||||
<td>Time in ISO format.</td>
|
|
||||||
<td>1.5.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$shorttime</code></td>
|
|
||||||
<td>Time in short locale format.</td>
|
|
||||||
<td>1.5.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$longtime</code></td>
|
|
||||||
<td>Time in long locale format.</td>
|
|
||||||
<td>1.5.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$ctime</code></td>
|
|
||||||
<td>Will enable custom time format.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="2">Uptime</th>
|
|
||||||
<td><code>$uptime</code></td>
|
|
||||||
<td>System uptime, <code>---d--h--m</code>.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$cuptime</code></td>
|
|
||||||
<td>Will enable custom uptime format.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="3">Load average</th>
|
|
||||||
<td><code>$la1</code></td>
|
|
||||||
<td>Load average over 1 min, <code>-----</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$la5</code></td>
|
|
||||||
<td>Load average over 5 min, <code>-----</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$la15</code></td>
|
|
||||||
<td>Load average over 15 min, <code>-----</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="2">CPU</th>
|
|
||||||
<td><code>$cpu</code></td>
|
|
||||||
<td>Total load CPU, %, <code>-----</code>.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$cpuN</code></td>
|
|
||||||
<td>Load CPU for core N, %, <code>-----</code>.</td>
|
|
||||||
<td>1.7.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="2">CPU clock</th>
|
|
||||||
<td><code>$cpucl</code></td>
|
|
||||||
<td>Average CPU clock, MHz, <code>----</code>.</td>
|
|
||||||
<td>1.1.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$cpuclN</code></td>
|
|
||||||
<td>CPU clock for core N, MHz, <code>----</code>.</td>
|
|
||||||
<td>1.7.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="1">Temperature</th>
|
|
||||||
<td><code>$tempN</code></td>
|
|
||||||
<td>Temperature for device N, <code>----</code>. For example, <code>$temp0</code>.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="1">GPU</th>
|
|
||||||
<td><code>$gpu</code></td>
|
|
||||||
<td>GPU usage, %, <code>-----</code>. <code>aticonfig</code> or <code>nvidia-smi</code> must be installed.</td>
|
|
||||||
<td>1.3.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="1">GPU temperature</th>
|
|
||||||
<td><code>$gputemp</code></td>
|
|
||||||
<td>GPU temperature, <code>----</code>. <code>aticonfig</code> or <code>nvidia-smi</code> must be installed.</td>
|
|
||||||
<td>1.3.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="9">Memory</th>
|
|
||||||
<td><code>$mem</code></td>
|
|
||||||
<td>Memory usage, %, <code>-----</code>.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memmb</code></td>
|
|
||||||
<td>Memory usage, MB, <code>-----</code>.</td>
|
|
||||||
<td>1.1.1</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memgb</code></td>
|
|
||||||
<td>Memory usage, GB, <code>----</code>.</td>
|
|
||||||
<td>1.7.3</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memfreemb</code></td>
|
|
||||||
<td>Free memory, MB, <code>-----</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memfreegb</code></td>
|
|
||||||
<td>Free memory, GB, <code>----</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memtotmb</code></td>
|
|
||||||
<td>RAM, MB, <code>-----</code>.</td>
|
|
||||||
<td>1.10.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memtotgb</code></td>
|
|
||||||
<td>RAM, GB, <code>----</code>.</td>
|
|
||||||
<td>1.10.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memusedmb</code></td>
|
|
||||||
<td>Used and cached memory, MB, <code>-----</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memusedgb</code></td>
|
|
||||||
<td>Used and cached memory, GB, <code>----</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="7">Swap</th>
|
|
||||||
<td><code>$swap</code></td>
|
|
||||||
<td>Swap usage, %, <code>-----</code>.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$swapmb</code></td>
|
|
||||||
<td>Swap usage, MB, <code>-----</code>.</td>
|
|
||||||
<td>1.1.1</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$swapgb</code></td>
|
|
||||||
<td>Swap usage, GB, <code>----</code>.</td>
|
|
||||||
<td>1.7.3</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$swapfreemb</code></td>
|
|
||||||
<td>Free swap, MB, <code>-----</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$swapfreegb</code></td>
|
|
||||||
<td>Free swap, GB, <code>----</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$swaptotmb</code></td>
|
|
||||||
<td>Swap, MB, <code>-----</code>.</td>
|
|
||||||
<td>1.10.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$swaptotgb</code></td>
|
|
||||||
<td>Swap, GB, <code>----</code>.</td>
|
|
||||||
<td>1.10.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="7">HDD usage</th>
|
|
||||||
<td><code>$hddN</code></td>
|
|
||||||
<td>Usage for mount point N, %, <code>-----</code>. For example <code>$hdd0</code>.</td>
|
|
||||||
<td>1.3.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddmbN</code></td>
|
|
||||||
<td>Usage for mount point N, MB, <code>-----</code>. For example <code>$hddmb0</code>.</td>
|
|
||||||
<td>1.8.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddgbN</code></td>
|
|
||||||
<td>Usage for mount point N, GB, <code>-----</code>. For example <code>$hddgb0</code>.</td>
|
|
||||||
<td>1.8.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddfreembN</code></td>
|
|
||||||
<td>Free space for mount point N, MB, <code>-----</code>. For example <code>$hddfreemb0</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddfreegbN</code></td>
|
|
||||||
<td>Free space for mount point N, GB, <code>-----</code>. For example <code>$hddfreegb0</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddtotmbN</code></td>
|
|
||||||
<td>Total size of mount point N, MB, <code>-----</code>. For example <code>$hddtotmb0</code>.</td>
|
|
||||||
<td>1.10.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddtotgbN</code></td>
|
|
||||||
<td>Total size of mount point N, GB, <code>-----</code>. For example <code>$hddtotgb0</code>.</td>
|
|
||||||
<td>1.10.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="2">HDD speed</th>
|
|
||||||
<td><code>$hddrN</code></td>
|
|
||||||
<td>Read speed of disk N, KB/s, <code>-----</code>. For example <code>$hddr0</code>.</td>
|
|
||||||
<td>1.9.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddwN</code></td>
|
|
||||||
<td>Write speed of disk N, KB/s, <code>-----</code>. For example <code>$hddw0</code>.</td>
|
|
||||||
<td>1.9.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="1">HDD temperature</th>
|
|
||||||
<td><code>$hddtempN</code></td>
|
|
||||||
<td>Temperature for HDD N, <code>----</code>. For example <code>$hddtemp0</code>. <code>hddtemp</code> or <code>smartmontools</code> must be installed.</td>
|
|
||||||
<td>1.7.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="13">Network</th>
|
|
||||||
<td><code>$down</code></td>
|
|
||||||
<td>Download speed for active device, KB/s or MB/s, <code>----</code>.</td>
|
|
||||||
<td>1.7.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$downkb</code></td>
|
|
||||||
<td>Download speed for active device, KB/s, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$downunits</code></td>
|
|
||||||
<td>Download speed units for active device, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$downN</code></td>
|
|
||||||
<td>Download speed for device N, KB/s or MB/s, <code>----</code>.</td>
|
|
||||||
<td>2.2.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$downkbN</code></td>
|
|
||||||
<td>Download speed for device N, KB/s, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$downunitsN</code></td>
|
|
||||||
<td>Download speed units for device N, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$up</code></td>
|
|
||||||
<td>Upload speed for active device, KB/s or MB/s, <code>----</code>.</td>
|
|
||||||
<td>1.7.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$upkb</code></td>
|
|
||||||
<td>Upload speed for active device, KB/s, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$upunits</code></td>
|
|
||||||
<td>Upload speed units for active device, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$upN</code></td>
|
|
||||||
<td>Upload speed for device N, KB/s or MB/s, <code>----</code>.</td>
|
|
||||||
<td>2.2.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$upkbN</code></td>
|
|
||||||
<td>Upload speed for device N, KB/s, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$upunitsN</code></td>
|
|
||||||
<td>Upload speed units for device N, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$netdev</code></td>
|
|
||||||
<td>Current network device.</td>
|
|
||||||
<td>1.1.1</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="3">Battery</th>
|
|
||||||
<td><code>$bat</code></td>
|
|
||||||
<td>Average battery charge, %, <code>---</code>.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$batN</code></td>
|
|
||||||
<td>Battery N charge, %, <code>---</code>.</td>
|
|
||||||
<td>2.0.3</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$ac</code></td>
|
|
||||||
<td>Status of AC device. Returns <code>(*)</code> if AC device is online or <code>( )</code> if offline.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="11">Music player</th>
|
|
||||||
<td><code>$album</code></td>
|
|
||||||
<td>Current song album. One of supported music players must be installed.</td>
|
|
||||||
<td>1.5.3</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$dalbum</code></td>
|
|
||||||
<td>Current song album with fixed symbols count shown as a running line.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$salbum</code></td>
|
|
||||||
<td>Current song album with fixed symbols count shown with three dots at the end.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$artist</code></td>
|
|
||||||
<td>Current song artist. One of supported music players must be installed.</td>
|
|
||||||
<td>1.5.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$dartist</code></td>
|
|
||||||
<td>Current song artist with fixed symbols count shown as a running line.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$sartist</code></td>
|
|
||||||
<td>Current song artist with fixed symbols count shown with three dots at the end.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$duration</code></td>
|
|
||||||
<td>Current song duration. One of supported music players must be installed.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$progress</code></td>
|
|
||||||
<td>Current song progress. One of supported music players must be installed.</td>
|
|
||||||
<td>1.5.3</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$title</code></td>
|
|
||||||
<td>Current song title. One of supported music players must be installed.</td>
|
|
||||||
<td>1.5.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$dtitle</code></td>
|
|
||||||
<td>Current song title with fixed symbols count shown as a running line.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$stitle</code></td>
|
|
||||||
<td>Current song title with fixed symbols count shown with three dots at the end.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="3">Process</th>
|
|
||||||
<td><code>$ps</code></td>
|
|
||||||
<td>List of running processes comma separated.</td>
|
|
||||||
<td>1.8.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$pscount</code></td>
|
|
||||||
<td>Number of running processes.</td>
|
|
||||||
<td>1.8.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$pstotal</code></td>
|
|
||||||
<td>Total number of processes.</td>
|
|
||||||
<td>1.8.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="1">Package manager</th>
|
|
||||||
<td><code>$pkgcountN</code></td>
|
|
||||||
<td>Number of packages, which available to upgrade for command N.</td>
|
|
||||||
<td>1.8.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="1">Custom</th>
|
|
||||||
<td><code>$customN</code></td>
|
|
||||||
<td>Get output from custom command N. For example <code>$custom0</code>.</td>
|
|
||||||
<td>1.9.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="3">Desktop</th>
|
|
||||||
<td><code>$desktop</code></td>
|
|
||||||
<td>Name of the current desktop.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$ndesktop</code></td>
|
|
||||||
<td>Number of the current desktop.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$tdesktops</code></td>
|
|
||||||
<td>Total number of desktops.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="9">Quotes</th>
|
|
||||||
<td><code>$askN</code></td>
|
|
||||||
<td>Get ask for ticker N. For example <code>$ask0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$askchgN</code></td>
|
|
||||||
<td>Get absolute ask change for ticker N. For example <code>$askchg0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$percaskchgN</code></td>
|
|
||||||
<td>Get ask change for ticker N, %. For example <code>$percaskchg0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$bidN</code></td>
|
|
||||||
<td>Get bid for ticker N. For example <code>$bid0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$bidchgN</code></td>
|
|
||||||
<td>Get absolute bid change for ticker N, %. For example <code>$bidchg0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$percbidchgN</code></td>
|
|
||||||
<td>Get bid change for ticker N. For example <code>$percbidchg0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$priceN</code></td>
|
|
||||||
<td>Get price for ticker N. For example <code>$price0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$pricechgN</code></td>
|
|
||||||
<td>Get absolute price change for ticker N. For example <code>$pricechg0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$percaskchgN</code></td>
|
|
||||||
<td>Get price change for ticker N, %. For example <code>$percpricechg0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="5">Weather</th>
|
|
||||||
<td><code>$weatherIdN</code></td>
|
|
||||||
<td>Numerical weather ID. For example <code>$weatherId0</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$weatherN</code></td>
|
|
||||||
<td>Weather status. For example <code>$weather0</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$humidityN</code></td>
|
|
||||||
<td>Humidity, %. For example <code>$humidity0</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$pressureN</code></td>
|
|
||||||
<td>Pressure, bars. For example <code>$pressure0</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$temperatureN</code></td>
|
|
||||||
<td>Temperature. For example <code>$temperature0</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
<h4><a href="#lambda" class="anchor" id="lambda"><span class="octicon octicon-link"></span></a>Lambda functions</h4>
|
|
||||||
<p>Since version 3.0.0 the main widgets supports lambda functions, which are calculated at runtime. It may be declared by using <code>${{ }}</code> construction:</p>
|
|
||||||
|
|
||||||
{% highlight javascript %}
|
|
||||||
{% raw %}${{{% endraw %}
|
|
||||||
function three()
|
|
||||||
{
|
|
||||||
return 1+2;
|
|
||||||
}
|
|
||||||
three()
|
|
||||||
{% raw %}}}{% endraw %}
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>A functions inside will be interpret as JavaScript ones, any variables from main body is supported, thus the following function:</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>will show <code>$cpu</code> value in red if it is more than 90.0, otherwise it will be shown in default colour. Any calculations are also supported:</p>
|
|
||||||
|
|
||||||
{% highlight javascript %}
|
|
||||||
{% raw %}${{{% endraw %}
|
|
||||||
$down - $up
|
|
||||||
{% raw %}}}{% endraw %}
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>will show difference between download and upload speed. Another feature provided by lambda functions is <code>$this</code> value which returns the last value of the lambda function. Here is a little more complicated example which will show running line "Artist - Title" with length less or equal than 20 symbols:</p>
|
|
||||||
|
|
||||||
{% highlight javascript %}
|
|
||||||
{% raw %}${{{% endraw %}
|
|
||||||
function runningLine() {
|
|
||||||
var current = "$artist - $title";
|
|
||||||
var index = current.indexOf("$this");
|
|
||||||
if (("$this" == "") || ((index + 20 + 1) > current.length))
|
|
||||||
return current.substring(0, 20);
|
|
||||||
else
|
|
||||||
return current.substring(index + 1, index + 20 + 1);
|
|
||||||
}
|
|
||||||
runningLine()
|
|
||||||
{% raw %}}}{% endraw %}
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>Thus this feature may be used for example to show any custom values which will be calculated in runtime and to show different information depending on some conditions. But please keep in mind that such runtime calculation may increase CPU load.</p>
|
|
||||||
|
|
||||||
<h4><a href="#advanced" class="anchor" id="advanced"><span class="octicon octicon-link"></span></a>Advanced settings</h4>
|
|
||||||
<p><b>Enable background:</b> Uncheck to disable default background and set transparent one. Default is <code>true</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Translate strings:</b> Translate strings tags. Default is <code>true</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Wrap new lines:</b> Replace <code>\n</code> to <code><br></code>. Default is <code>false</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Word wrap:</b> Enable word wrap. Default is <code>false</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Enable popup:</b> Uncheck box if you do not want popup messages on system events. Default is <code>true</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Check updates:</b> Check updates on load. Default is <code>true</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Widget height:</b> Disable automatic widget height definition and set it to this value. Default is <code>0</code> (auto).</p>
|
|
||||||
|
|
||||||
<p><b>Widget width:</b> Disable automatic widget width definition and set it to this value. Default is <code>0</code> (auto).</p>
|
|
||||||
|
|
||||||
<p><b>Update interval:</b> Widget update interval. Default is <code>1000</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Queue limit:</b> Use thread pool with this maximum thread counts. <code>0</code> means CPU ideal thread count. Default is <code>0</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Temperature units:</b> Select units for temperature. Available units are Celsius, Farenheit, Kelvin, Reaumur, cm^-1, kJ/mol, kcal/mol.</p>
|
|
||||||
|
|
||||||
<p><b>Custom time format:</b></p>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<td><code>$dddd</code></td>
|
|
||||||
<td>Weekday in long format.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$ddd</code></td>
|
|
||||||
<td>Weekday in short format.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$dd</code></td>
|
|
||||||
<td>Day.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$d</code></td>
|
|
||||||
<td>Day without zero.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$MMMM</code></td>
|
|
||||||
<td>Month in long format.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$MMM</code></td>
|
|
||||||
<td>Month in short format.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$MM</code></td>
|
|
||||||
<td>Month.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$M</code></td>
|
|
||||||
<td>Month without zero.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$yyyy</code></td>
|
|
||||||
<td>Year.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$yy</code></td>
|
|
||||||
<td>Year in short format.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hh</code></td>
|
|
||||||
<td>Hours.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$h</code></td>
|
|
||||||
<td>Hours without zero.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$HH</code></td>
|
|
||||||
<td>Hours in 24-hours format.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$H</code></td>
|
|
||||||
<td>Hours in 24-hours format without zero.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$mm</code></td>
|
|
||||||
<td>Minutes.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$m</code></td>
|
|
||||||
<td>Minutes without zero.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$ss</code></td>
|
|
||||||
<td>Seconds.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$s</code></td>
|
|
||||||
<td>Seconds without zero.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$t</code></td>
|
|
||||||
<td>Timezone name.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$a</code>/<code>$ap</code></td>
|
|
||||||
<td>am or pm.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$A</code>/<code>$AP</code></td>
|
|
||||||
<td>AM or PM.</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
<p><b>Custom uptime format:</b></p>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<td><code>$dd</code></td>
|
|
||||||
<td>Uptime days.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$d</code></td>
|
|
||||||
<td>Uptime days without zero.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hh</code></td>
|
|
||||||
<td>Uptime hours.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$h</code></td>
|
|
||||||
<td>Uptime hours without zero.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$mm</code></td>
|
|
||||||
<td>Uptime minutes.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$m</code></td>
|
|
||||||
<td>Uptime minutes without zero.</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
<p><b>AC online tag:</b> Line which will be shown when AC is online. Default is <code>(*)</code>.</p>
|
|
||||||
|
|
||||||
<p><b>AC offline tag:</b> Line which will be shown when AC is offline. Default is <code>( )</code>.</p>
|
|
||||||
|
|
||||||
<h4><a href="#tooltips" class="anchor" id="tooltips"><span class="octicon octicon-link"></span></a>Tooltips</h4>
|
|
||||||
<p>Since version 1.7.0 CPU, CPU clock, memory, swap, network and battery support graphical tooltip. To enable them just select required fields. The number of stored values can be set in the tab. Colours of the graphs are configurable too.</p>
|
|
||||||
|
|
||||||
<h4><a href="#deguiconf" class="anchor" id="deguiconf"><span class="octicon octicon-link"></span></a>DataEngine settings</h4>
|
|
||||||
<p><b>ACPI path:</b> Path to ACPI devices. The file <code>/sys/class/power_supply/</code>.</p>
|
|
||||||
|
|
||||||
<p><b>GPU device:</b> Select one of supported GPU devices. <code>auto</code> will enable auto selection, <code>disable</code> will disable all GPU monitors. Default is <code>auto</code>.</p>
|
|
||||||
|
|
||||||
<p><b>HDD:</b> Select one of HDDs for HDD temperature monitor. <code>all</code> will enable monitor for all devices, <code>disable</code> will disable HDD temperature monitor. Default is <code>all</code>.</p>
|
|
||||||
|
|
||||||
<p><b>hddtemp cmd:</b> Type a command which will be run for hddtemp DataEngine. Default is <code>sudo smartctl -a</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Player symbol count:</b> Symbol count for dynamic player tags.</p>
|
|
||||||
|
|
||||||
<p><b>Music player:</b> Select one of supported music players for player label.</p>
|
|
||||||
|
|
||||||
<p><b>MPRIS:</b> Select MPRIS player name. <code>auto</code> will enable auto selection. Default is <code>auto</code>.</p>
|
|
||||||
|
|
||||||
<p><b>MPD address:</b> Address of MPD server. Default is <code>localhost</code>.</p>
|
|
||||||
|
|
||||||
<p><b>MPD port:</b> Port of MPD server. Default is <code>6600</code>.</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. And yes, it looks like the same panel in Awesome.</p>
|
|
||||||
|
|
||||||
<h4><a href="#dpconf" class="anchor" id="dpconf"><span class="octicon octicon-link"></span></a>Desktop panel configuration</h4>
|
|
||||||
<p><b>Enable background: </b> Uncheck to disable default background and set transparent one. Default is <code>true</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Vertical layout:</b> Use vertical layout instead of horizontal one. Default is <code>false</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Widget height:</b> Disable automatic widget height definition and set it to this value. Default is <code>0</code> (auto).</p>
|
|
||||||
|
|
||||||
<p><b>Widget width:</b> Disable automatic widget width definition and set it to this value. Default is <code>0</code> (auto).</p>
|
|
||||||
|
|
||||||
<p><b>Mark:</b> Type symbol (or string) which will be shown if this desktop is active now.</p>
|
|
||||||
|
|
||||||
<p><b>Tooltip type:</b> Select tooltip type. Default is <code>windows</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Tooltip width:</b> Using tooltip width in px. Default is <code>200px</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Color of tooltip:</b> Colour which is used in some tooltip types. Default is <code>#ffffff</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Pattern tags</b></p>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<td><code>$mark</code></td>
|
|
||||||
<td>Show mark if this desktop is active. Shows spaces in other way.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$name</code></td>
|
|
||||||
<td>Name of the desktop.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$number</code></td>
|
|
||||||
<td>Number of the desktop.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$total</code></td>
|
|
||||||
<td>Total number of desktops.</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
<!-- end of config block -->
|
|
||||||
|
|
||||||
<!-- gui block -->
|
|
||||||
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Graphical user interface</h2>
|
|
||||||
|
|
||||||
<h2><a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Screenshots</h2>
|
|
||||||
<div class="thumbnails">
|
|
||||||
{% assign scrdesc = "Widget (clickable)" %}
|
|
||||||
{% assign scrname = "awesomewidgets_widget" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Configuration window" %}
|
|
||||||
{% assign scrname = "awesomewidgets_config_01" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Configuration window" %}
|
|
||||||
{% assign scrname = "awesomewidgets_config_02" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Configuration window" %}
|
|
||||||
{% assign scrname = "awesomewidgets_config_03" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Configuration window" %}
|
|
||||||
{% assign scrname = "awesomewidgets_config_04" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Configuration window" %}
|
|
||||||
{% assign scrname = "awesomewidgets_config_05" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Tooltips" %}
|
|
||||||
{% assign scrname = "awesomewidgets_tooltips" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
</div>
|
|
||||||
418
projects/awesome-widgets.md
Normal file
418
projects/awesome-widgets.md
Normal file
@ -0,0 +1,418 @@
|
|||||||
|
---
|
||||||
|
hastr: true
|
||||||
|
layout: project
|
||||||
|
title: Awesome Widgets
|
||||||
|
short: awesome-widgets
|
||||||
|
tags: python, kde, qt, linux, system, awesome
|
||||||
|
hasgui: true
|
||||||
|
hasdocs: false
|
||||||
|
developers:
|
||||||
|
- Evgeniy Alekseev
|
||||||
|
- Ernesto Avilés Vzqz (Spanish translation)
|
||||||
|
- Mermouy (French translation)
|
||||||
|
- underr (Brazillian Portuguese translation)
|
||||||
|
- Виктор Слободян (Ukrainian translation)
|
||||||
|
- Lemueler (Chinese translation)
|
||||||
|
- Heimen Stoffels (Dutch translation)
|
||||||
|
license: GPLv3
|
||||||
|
links:
|
||||||
|
- Plasmoid page on <a href="//kde-look.org/content/show.php/Awesome+Widgets?content=157124" title="kde-look">kde-look.org</a>
|
||||||
|
- DataEngine page on <a href="//kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773" title="kde-look">kde-look.org</a>
|
||||||
|
- Archlinux <a href="//aur.archlinux.org/packages/kdeplasma-applets-awesome-widgets" title="AUR">AUR package</a>
|
||||||
|
- <a href="//software.opensuse.org/package/plasma5-awesome-widgets" title="openSUSE">openSUSE package</a> (thanks to Kott)
|
||||||
|
- <a href="//github.com/arcan1s/awesome-widgets/releases" title="Ubuntu">Ubuntu package</a>
|
||||||
|
- <a href="/en/2014/09/04/migration-to-v2/" title="Migration">Migration to version 2.0</a>
|
||||||
|
- <a href="/en/2014/12/19/aw-v21-bells-and-whistles/" title="ExtItems">Extensions</a>
|
||||||
|
---
|
||||||
|
<!-- info block -->
|
||||||
|
## <a href="#information" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information
|
||||||
|
|
||||||
|
A collection of minimalistic easily configurable Plasmoids written on `C++/Qt`. They look like widgets in [Awesome WM](//awesome.naquadah.org/ "Awesome Homepage"). Also this packages has an additional system [DataEngine](//techbase.kde.org/Development/Tutorials/Plasma/DataEngines "Developers tutorial").
|
||||||
|
|
||||||
|
**NOTE:** [LOOKING FOR TRANSLATORS!](//github.com/arcan1s/awesome-widgets/issues/14 "Ticket")
|
||||||
|
|
||||||
|
**PLASMA 5 COMPATIBLE!**
|
||||||
|
|
||||||
|
### <a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors
|
||||||
|
|
||||||
|
{% for devel in page.developers %}
|
||||||
|
* {{ devel }}{% endfor %}
|
||||||
|
|
||||||
|
### <a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License
|
||||||
|
|
||||||
|
* {{ page.license }}
|
||||||
|
|
||||||
|
### <a href="#changelog" class="anchor" id="changelog"><span class="octicon octicon-link"></span></a>Changelog
|
||||||
|
|
||||||
|
[CHANGELOG](//github.com/arcan1s/awesome-widgets/blob/master/CHANGELOG "GitHub")
|
||||||
|
|
||||||
|
<!-- end of info block -->
|
||||||
|
|
||||||
|
<!-- install block -->
|
||||||
|
## <a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation
|
||||||
|
|
||||||
|
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction
|
||||||
|
|
||||||
|
* Download an [archive](//github.com/arcan1s/awesome-widgets/releases "GitHub") with latest version of source files.
|
||||||
|
* Extract it and install:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /where/is/applet/
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr ../
|
||||||
|
make
|
||||||
|
sudo make install
|
||||||
|
```
|
||||||
|
|
||||||
|
**NOTE:** on Plasma 5 it very likely requires `-DKDE_INSTALL_USE_QT_SYS_PATHS=ON` flag
|
||||||
|
|
||||||
|
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies
|
||||||
|
|
||||||
|
I want note that all were tested on latest version of dependencies.
|
||||||
|
|
||||||
|
* plasma-framework
|
||||||
|
* cmake *(make)*
|
||||||
|
* extra-cmake-modules *(make)*
|
||||||
|
* hddtemp **or** smartmontools *(optional, for HDD temperature monitor)*
|
||||||
|
* one of supported music player *(optional, for music player monitor)*
|
||||||
|
* proprietary video driver *(optional, for GPU monitor)*
|
||||||
|
|
||||||
|
<!-- end of install block -->
|
||||||
|
|
||||||
|
<!-- howto block -->
|
||||||
|
## <a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use
|
||||||
|
|
||||||
|
Open your Plasma widgets and select `Awesome Widget`.
|
||||||
|
|
||||||
|
### <a href="#tips" class="anchor" id="tips"><span class="octicon octicon-link"></span></a>Tips & tricks
|
||||||
|
|
||||||
|
You may use different colours inside. Just put label text into html code. See [issue](//github.com/arcan1s/awesome-widgets/issues/9 "GitHub") for more details.
|
||||||
|
|
||||||
|
<!-- end of howto block -->
|
||||||
|
|
||||||
|
<!-- config block -->
|
||||||
|
## <a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Configuration
|
||||||
|
|
||||||
|
### <a href="#deconf" class="anchor" id="deconf"><span class="octicon octicon-link"></span></a>DataEngine configuration
|
||||||
|
|
||||||
|
You may edit DataEngine configuration. It is `/etc/xdg/plasma-dataengine-extsysmon.conf` and `$HOME/.config/plasma-dataengine-extsysmon.conf`. Uncomment needed line and edit it.
|
||||||
|
|
||||||
|
#### <a href="#deoptions" class="anchor" id="deoptions"><span class="octicon octicon-link"></span></a>DataEngine options
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|----------|-----------|
|
||||||
|
| ACPIPATH | Path to ACPI devices. Default is `/sys/class/power_supply/`. |
|
||||||
|
| GPUDEV | Set GPU device. May be `nvidia` (for nVidia), `ati` (for ATI Radeon), `disable` or `auto`. Default is `auto`. |
|
||||||
|
| HDDDEV | Set block device for `hddtemp` comma separated or use `all`. `disable` will disable HDD temperature monitor. Default is `all`. |
|
||||||
|
| HDDTEMPCMD | A command which will be run for hddtemp DataEngine. Default is `sudo hddtemp`. Supported applications are `hddtemp` and `smartmontools`. |
|
||||||
|
| MPDADDRESS | MPD host address. Default is `localhost`. |
|
||||||
|
| MPDPORT | MPD host port. Default is `6600`. |
|
||||||
|
| PLAYER | Set music player. Supported players are mpd and MPRIS/DBus supported. `disable` will disable this monitor. |
|
||||||
|
| PLAYERSYMBOLS | Select symbols count for dynamic player tags. Default is `10`. |
|
||||||
|
|
||||||
|
### <a href="#widconf" class="anchor" id="widconf"><span class="octicon octicon-link"></span></a>Widget configuration
|
||||||
|
|
||||||
|
For edited output you must open Settings window and setup output format. HTML tags work normally.
|
||||||
|
|
||||||
|
Available flags are in the table below.
|
||||||
|
|
||||||
|
**NOTE** The numbering of all arrays in variables starts at 0.
|
||||||
|
|
||||||
|
| Tag | Description | Since |
|
||||||
|
|-----|-------------|-------|
|
||||||
|
| `$time` | Time in default format. For example, `fri Nov 6 04:48:01 2013`. | 1.5.1 |
|
||||||
|
| `$isotime` | Time in ISO format. | 1.5.2 |
|
||||||
|
| `$shorttime` | Time in short locale format. | 1.5.2 |
|
||||||
|
| `$longtime` | Time in long locale format. | 1.5.2 |
|
||||||
|
| `$ctime` | Will enable custom time format. | 2.0.0 |
|
||||||
|
| `$uptime` | System uptime, `---d--h--m`. |
|
||||||
|
| `$cuptime` | Will enable custom uptime format. | 2.0.0 |
|
||||||
|
| `$la1` | Load average over 1 min, `-----`. | 2.4.0 |
|
||||||
|
| `$la5` | Load average over 5 min, `-----`. | 2.4.0 |
|
||||||
|
| `$la15` | Load average over 15 min, `-----`. | 2.4.0 |
|
||||||
|
| `$cpu` | Total load CPU, %, `-----`. |
|
||||||
|
| `$cpuN` | Load CPU for core N, %, `-----`. | 1.7.0 |
|
||||||
|
| `$cpucl` | Average CPU clock, MHz, `----`. | 1.1.2 |
|
||||||
|
| `$cpuclN` | CPU clock for core N, MHz, `----`. | 1.7.0 |
|
||||||
|
| `$tempN` | Temperature for device N, `----`. For example, `$temp0`. |
|
||||||
|
| `$gpu` | GPU usage, %, `-----`. `aticonfig` or `nvidia-smi` must be installed. | 1.3.2 |
|
||||||
|
| `$gputemp` | GPU temperature, `----`. `aticonfig` or `nvidia-smi` must be installed. | 1.3.2 |
|
||||||
|
| `$mem` | Memory usage, %, `-----`. |
|
||||||
|
| `$memmb` | Memory usage, MB, `-----`. | 1.1.1 |
|
||||||
|
| `$memgb` | Memory usage, GB, `----`. | 1.7.3 |
|
||||||
|
| `$memfreemb` | Free memory, MB, `-----`. | 2.0.0 |
|
||||||
|
| `$memfreegb` | Free memory, GB, `----`. | 2.0.0 |
|
||||||
|
| `$memtotmb` | RAM, MB, `-----`. | 1.10.0 |
|
||||||
|
| `$memtotgb` | RAM, GB, `----`. | 1.10.0 |
|
||||||
|
| `$memusedmb` | Used and cached memory, MB, `-----`. | 2.0.0 |
|
||||||
|
| `$memusedgb` | Used and cached memory, GB, `----`. | 2.0.0 |
|
||||||
|
| `$swap` | Swap usage, %, `-----`. |
|
||||||
|
| `$swapmb` | Swap usage, MB, `-----`. | 1.1.1 |
|
||||||
|
| `$swapgb` | Swap usage, GB, `----`. | 1.7.3 |
|
||||||
|
| `$swapfreemb` | Free swap, MB, `-----`. | 2.0.0 |
|
||||||
|
| `$swapfreegb` | Free swap, GB, `----`. | 2.0.0 |
|
||||||
|
| `$swaptotmb` | Swap, MB, `-----`. | 1.10.0 |
|
||||||
|
| `$swaptotgb` | Swap, GB, `----`. | 1.10.0 |
|
||||||
|
| `$hddN` | Usage for mount point N, %, `-----`. For example `$hdd0`. | 1.3.2 |
|
||||||
|
| `$hddmbN` | Usage for mount point N, MB, `-----`. For example `$hddmb0`. | 1.8.0 |
|
||||||
|
| `$hddgbN` | Usage for mount point N, GB, `-----`. For example `$hddgb0`. | 1.8.0 |
|
||||||
|
| `$hddfreembN` | Free space for mount point N, MB, `-----`. For example `$hddfreemb0`. | 2.0.0 |
|
||||||
|
| `$hddfreegbN` | Free space for mount point N, GB, `-----`. For example `$hddfreegb0`. | 2.0.0 |
|
||||||
|
| `$hddtotmbN` | Total size of mount point N, MB, `-----`. For example `$hddtotmb0`. | 1.10.0 |
|
||||||
|
| `$hddtotgbN` | Total size of mount point N, GB, `-----`. For example `$hddtotgb0`. | 1.10.0 |
|
||||||
|
| `$hddrN` | Read speed of disk N, KB/s, `-----`. For example `$hddr0`. | 1.9.0 |
|
||||||
|
| `$hddwN` | Write speed of disk N, KB/s, `-----`. For example `$hddw0`. | 1.9.0 |
|
||||||
|
| `$hddtempN` | Temperature for HDD N, `----`. For example `$hddtemp0`. `hddtemp` or `smartmontools` must be installed. | 1.7.0 |
|
||||||
|
| `$down` | Download speed for active device, KB/s or MB/s, `----`. | 1.7.0 |
|
||||||
|
| `$downkb` | Download speed for active device, KB/s, `----`. | 3.0.0 |
|
||||||
|
| `$downunits` | Download speed units for active device, `----`. | 3.0.0 |
|
||||||
|
| `$downN` | Download speed for device N, KB/s or MB/s, `----`. | 2.2.0 |
|
||||||
|
| `$downkbN` | Download speed for device N, KB/s, `----`. | 3.0.0 |
|
||||||
|
| `$downunitsN` | Download speed units for device N, `----`. | 3.0.0 |
|
||||||
|
| `$up` | Upload speed for active device, KB/s or MB/s, `----`. | 1.7.0 |
|
||||||
|
| `$upkb` | Upload speed for active device, KB/s, `----`. | 3.0.0 |
|
||||||
|
| `$upunits` | Upload speed units for active device, `----`. | 3.0.0 |
|
||||||
|
| `$upN` | Upload speed for device N, KB/s or MB/s, `----`. | 2.2.0 |
|
||||||
|
| `$upkbN` | Upload speed for device N, KB/s, `----`. | 3.0.0 |
|
||||||
|
| `$upunitsN` | Upload speed units for device N, `----`. | 3.0.0 |
|
||||||
|
| `$netdev` | Current network device. | 1.1.1 |
|
||||||
|
| `$bat` | Average battery charge, %, `---`. |
|
||||||
|
| `$batN` | Battery N charge, %, `---`. | 2.0.3 |
|
||||||
|
| `$ac` | Status of AC device. Returns `(*)` if AC device is online or `( )` if offline. |
|
||||||
|
| `$album` | Current song album. One of supported music players must be installed. | 1.5.3 |
|
||||||
|
| `$dalbum` | Current song album with fixed symbols count shown as a running line. | 3.0.0 |
|
||||||
|
| `$salbum` | Current song album with fixed symbols count shown with three dots at the end. | 3.0.0 |
|
||||||
|
| `$artist` | Current song artist. One of supported music players must be installed. | 1.5.0 |
|
||||||
|
| `$dartist` | Current song artist with fixed symbols count shown as a running line. | 3.0.0 |
|
||||||
|
| `$sartist` | Current song artist with fixed symbols count shown with three dots at the end. | 3.0.0 |
|
||||||
|
| `$duration` | Current song duration. One of supported music players must be installed. | 2.0.0 |
|
||||||
|
| `$progress` | Current song progress. One of supported music players must be installed. | 1.5.3 |
|
||||||
|
| `$title` | Current song title. One of supported music players must be installed. | 1.5.0 |
|
||||||
|
| `$dtitle` | Current song title with fixed symbols count shown as a running line. | 3.0.0 |
|
||||||
|
| `$stitle` | Current song title with fixed symbols count shown with three dots at the end. | 3.0.0 |
|
||||||
|
| `$ps` | List of running processes comma separated. | 1.8.0 |
|
||||||
|
| `$pscount` | Number of running processes. | 1.8.0 |
|
||||||
|
| `$pstotal` | Total number of processes. | 1.8.0 |
|
||||||
|
| `$pkgcountN` | Number of packages, which available to upgrade for command N. | 1.8.0 |
|
||||||
|
| `$customN` | Get output from custom command N. For example `$custom0`. | 1.9.0 |
|
||||||
|
| `$desktop` | Name of the current desktop. | 2.0.0 |
|
||||||
|
| `$ndesktop` | Number of the current desktop. | 2.0.0 |
|
||||||
|
| `$tdesktops` | Total number of desktops. | 2.0.0 |
|
||||||
|
| `$askN` | Get ask for ticker N. For example `$ask0`. | 2.2.2 |
|
||||||
|
| `$askchgN` | Get absolute ask change for ticker N. For example `$askchg0`. | 2.2.2 |
|
||||||
|
| `$percaskchgN` | Get ask change for ticker N, %. For example `$percaskchg0`. | 2.2.2 |
|
||||||
|
| `$bidN` | Get bid for ticker N. For example `$bid0`. | 2.2.2 |
|
||||||
|
| `$bidchgN` | Get absolute bid change for ticker N, %. For example `$bidchg0`. | 2.2.2 |
|
||||||
|
| `$percbidchgN` | Get bid change for ticker N. For example `$percbidchg0`. | 2.2.2 |
|
||||||
|
| `$priceN` | Get price for ticker N. For example `$price0`. | 2.2.2 |
|
||||||
|
| `$pricechgN` | Get absolute price change for ticker N. For example `$pricechg0`. | 2.2.2 |
|
||||||
|
| `$percaskchgN` | Get price change for ticker N, %. For example `$percpricechg0`. | 2.2.2 |
|
||||||
|
| `$weatherIdN` | Numerical weather ID. For example `$weatherId0`. | 2.4.0 |
|
||||||
|
| `$weatherN` | Weather status. For example `$weather0`. | 2.4.0 |
|
||||||
|
| `$humidityN` | Humidity, %. For example `$humidity0`. | 2.4.0 |
|
||||||
|
| `$pressureN` | Pressure, bars. For example `$pressure0`. | 2.4.0 |
|
||||||
|
| `$temperatureN` | Temperature. For example `$temperature0`. | 2.4.0 |
|
||||||
|
|
||||||
|
##### <a href="#lambda" class="anchor" id="lambda"><span class="octicon octicon-link"></span></a>Lambda functions
|
||||||
|
|
||||||
|
Since version 3.0.0 the main widgets supports lambda functions, which are calculated at runtime. It may be declared by using `{% raw %}${{{% endraw %} {% raw %}}}{% endraw %}` construction:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
{% raw %}${{{% endraw %}
|
||||||
|
function three()
|
||||||
|
{
|
||||||
|
return 1+2;
|
||||||
|
}
|
||||||
|
three()
|
||||||
|
{% raw %}}}{% endraw %}
|
||||||
|
```
|
||||||
|
|
||||||
|
A functions inside will be interpret as JavaScript ones, any variables from main body is supported, thus the following function:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
{% raw %}${{{% endraw %}
|
||||||
|
function colorCpu()
|
||||||
|
{
|
||||||
|
if ($cpu > 90.0)
|
||||||
|
return "<span style=\"color:#ff0000;\">$cpu</span>"
|
||||||
|
else
|
||||||
|
return "$cpu"
|
||||||
|
}
|
||||||
|
colorCpu()
|
||||||
|
{% raw %}}}{% endraw %}
|
||||||
|
```
|
||||||
|
|
||||||
|
will show `$cpu` value in red if it is more than 90.0, otherwise it will be shown in default colour. Any calculations are also supported:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
{% raw %}${{{% endraw %}
|
||||||
|
$down - $up
|
||||||
|
{% raw %}}}{% endraw %}
|
||||||
|
```
|
||||||
|
|
||||||
|
will show difference between download and upload speed. Another feature provided by lambda functions is `$this` value which returns the last value of the lambda function. Here is a little more complicated example which will show running line "Artist - Title" with length less or equal than 20 symbols:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
{% raw %}${{{% endraw %}
|
||||||
|
function runningLine() {
|
||||||
|
var current = "$artist - $title";
|
||||||
|
var index = current.indexOf("$this");
|
||||||
|
if (("$this" == "") || ((index + 20 + 1) > current.length))
|
||||||
|
return current.substring(0, 20);
|
||||||
|
else
|
||||||
|
return current.substring(index + 1, index + 20 + 1);
|
||||||
|
}
|
||||||
|
runningLine()
|
||||||
|
{% raw %}}}{% endraw %}
|
||||||
|
```
|
||||||
|
|
||||||
|
Thus this feature may be used for example to show any custom values which will be calculated in runtime and to show different information depending on some conditions. But please keep in mind that such runtime calculation may increase CPU load.
|
||||||
|
|
||||||
|
##### <a href="#advanced" class="anchor" id="advanced"><span class="octicon octicon-link"></span></a>Advanced settings
|
||||||
|
|
||||||
|
**Enable background:** Uncheck to disable default background and set transparent one. Default is `true`.
|
||||||
|
|
||||||
|
**Translate strings:** Translate strings tags. Default is `true`.
|
||||||
|
|
||||||
|
**Wrap new lines:** Replace `\n` to `<br>`. Default is `false`.
|
||||||
|
|
||||||
|
**Word wrap:** Enable word wrap. Default is `false`.
|
||||||
|
|
||||||
|
**Enable popup:** Uncheck box if you do not want popup messages on system events. Default is `true`.
|
||||||
|
|
||||||
|
**Check updates:** Check updates on load. Default is `true`.
|
||||||
|
|
||||||
|
**Widget height:** Disable automatic widget height definition and set it to this value. Default is `0` (auto).
|
||||||
|
|
||||||
|
**Widget width:** Disable automatic widget width definition and set it to this value. Default is `0` (auto).
|
||||||
|
|
||||||
|
**Update interval:** Widget update interval. Default is `1000`.
|
||||||
|
|
||||||
|
**Queue limit:** Use thread pool with this maximum thread counts. `0` means CPU ideal thread count. Default is `0`.
|
||||||
|
|
||||||
|
**Temperature units:** Select units for temperature. Available units are Celsius, Farenheit, Kelvin, Reaumur, cm^-1, kJ/mol, kcal/mol.
|
||||||
|
|
||||||
|
**Custom time format:**
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|---------|-------------------------|
|
||||||
|
| `$dddd` | Weekday in long format. |
|
||||||
|
| `$ddd` | Weekday in short format. |
|
||||||
|
| `$dd` | Day. |
|
||||||
|
| `$d` | Day without zero. |
|
||||||
|
| `$MMMM` | Month in long format. |
|
||||||
|
| `$MMM` | Month in short format. |
|
||||||
|
| `$MM` | Month. |
|
||||||
|
| `$M` | Month without zero. |
|
||||||
|
| `$yyyy` | Year. |
|
||||||
|
| `$yy` | Year in short format. |
|
||||||
|
| `$hh` | Hours. |
|
||||||
|
| `$h` | Hours without zero. |
|
||||||
|
| `$HH` | Hours in 24-hours format. |
|
||||||
|
| `$H` | Hours in 24-hours format without zero. |
|
||||||
|
| `$mm` | Minutes. |
|
||||||
|
| `$m` | Minutes without zero. |
|
||||||
|
| `$ss` | Seconds. |
|
||||||
|
| `$s` | Seconds without zero. |
|
||||||
|
| `$t` | Timezone name. |
|
||||||
|
| `$a`/`$ap` | am or pm. |
|
||||||
|
| `$A`/`$AP` | AM or PM. |
|
||||||
|
|
||||||
|
**Custom uptime format:**
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|-------|--------------|
|
||||||
|
| `$dd` | Uptime days. |
|
||||||
|
| `$d` | Uptime days without zero. |
|
||||||
|
| `$hh` | Uptime hours. |
|
||||||
|
| `$h` | Uptime hours without zero. |
|
||||||
|
| `$mm` | Uptime minutes. |
|
||||||
|
| `$m` | Uptime minutes without zero. |
|
||||||
|
|
||||||
|
**AC online tag:** Line which will be shown when AC is online. Default is `(*)`.
|
||||||
|
|
||||||
|
**AC offline tag:** Line which will be shown when AC is offline. Default is `( )`.
|
||||||
|
|
||||||
|
#### <a href="#tooltips" class="anchor" id="tooltips"><span class="octicon octicon-link"></span></a>Tooltips
|
||||||
|
|
||||||
|
Since version 1.7.0 CPU, CPU clock, memory, swap, network and battery support graphical tooltip. To enable them just select required fields. The number of stored values can be set in the tab. Colours of the graphs are configurable too.
|
||||||
|
|
||||||
|
#### <a href="#deguiconf" class="anchor" id="deguiconf"><span class="octicon octicon-link"></span></a>DataEngine settings
|
||||||
|
|
||||||
|
**ACPI path:** Path to ACPI devices. The file `/sys/class/power_supply/`.
|
||||||
|
|
||||||
|
**GPU device:** Select one of supported GPU devices. `auto` will enable auto selection, `disable` will disable all GPU monitors. Default is `auto`.
|
||||||
|
|
||||||
|
**HDD:** Select one of HDDs for HDD temperature monitor. `all` will enable monitor for all devices, `disable` will disable HDD temperature monitor. Default is `all`.
|
||||||
|
|
||||||
|
**hddtemp cmd:** Type a command which will be run for hddtemp DataEngine. Default is `sudo smartctl -a`.
|
||||||
|
|
||||||
|
**Player symbol count:** Symbol count for dynamic player tags.
|
||||||
|
|
||||||
|
**Music player:** Select one of supported music players for player label.
|
||||||
|
|
||||||
|
**MPRIS:** Select MPRIS player name. `auto` will enable auto selection. Default is `auto`.
|
||||||
|
|
||||||
|
**MPD address:** Address of MPD server. Default is `localhost`.
|
||||||
|
|
||||||
|
**MPD port:** Port of MPD server. Default is `6600`.
|
||||||
|
|
||||||
|
### <a href="#desktoppanel" class="anchor" id="desktoppanel"><span class="octicon octicon-link"></span></a>Desktop Panel
|
||||||
|
Since version 1.11.0 it provides a minimalistic panel for monitoring on desktops. And yes, it looks like the same panel in Awesome.
|
||||||
|
|
||||||
|
##### <a href="#dpconf" class="anchor" id="dpconf"><span class="octicon octicon-link"></span></a>Desktop panel configuration
|
||||||
|
|
||||||
|
**Enable background:** Uncheck to disable default background and set transparent one. Default is `true`.
|
||||||
|
|
||||||
|
**Vertical layout:** Use vertical layout instead of horizontal one. Default is `false`.
|
||||||
|
|
||||||
|
**Widget height:** Disable automatic widget height definition and set it to this value. Default is `0` (auto).
|
||||||
|
|
||||||
|
**Widget width:** Disable automatic widget width definition and set it to this value. Default is `0` (auto).
|
||||||
|
|
||||||
|
**Mark:** Type symbol (or string) which will be shown if this desktop is active now.
|
||||||
|
|
||||||
|
**Tooltip type:** Select tooltip type. Default is `windows`.
|
||||||
|
|
||||||
|
**Tooltip width:** Using tooltip width in px. Default is `200px`.
|
||||||
|
|
||||||
|
**Color of tooltip:** Colour which is used in some tooltip types. Default is `#ffffff`.
|
||||||
|
|
||||||
|
**Pattern tags**
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|---------|---------|
|
||||||
|
| `$mark` | Show mark if this desktop is active. Shows spaces in other way. |
|
||||||
|
| `$name` | Name of the desktop. |
|
||||||
|
| `$number` | Number of the desktop. |
|
||||||
|
| `$total` | Total number of desktops. |
|
||||||
|
<!-- end of config block -->
|
||||||
|
|
||||||
|
<!-- gui block -->
|
||||||
|
## <a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Graphical user interface
|
||||||
|
|
||||||
|
## <a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Screenshots
|
||||||
|
|
||||||
|
<div class="thumbnails">
|
||||||
|
{% assign scrdesc = "Widget (clickable)" %}
|
||||||
|
{% assign scrname = "awesomewidgets_widget" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Configuration window" %}
|
||||||
|
{% assign scrname = "awesomewidgets_config_01" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Configuration window" %}
|
||||||
|
{% assign scrname = "awesomewidgets_config_02" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Configuration window" %}
|
||||||
|
{% assign scrname = "awesomewidgets_config_03" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Configuration window" %}
|
||||||
|
{% assign scrname = "awesomewidgets_config_04" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Configuration window" %}
|
||||||
|
{% assign scrname = "awesomewidgets_config_05" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Tooltips" %}
|
||||||
|
{% assign scrname = "awesomewidgets_tooltips" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
</div>
|
||||||
@ -1,188 +0,0 @@
|
|||||||
---
|
|
||||||
hastr: true
|
|
||||||
layout: project
|
|
||||||
title: git-etc
|
|
||||||
short: git-etc
|
|
||||||
tags: git, python, qt, linux, daemon, system
|
|
||||||
hasgui: true
|
|
||||||
hasdocs: false
|
|
||||||
developers:
|
|
||||||
- Evgeniy Alekseev
|
|
||||||
license: GPLv3
|
|
||||||
links:
|
|
||||||
- Archlinux <a href="//aur.archlinux.org/packages/git-etc" title="AUR">AUR package</a>
|
|
||||||
---
|
|
||||||
<!-- info block -->
|
|
||||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information</h2>
|
|
||||||
<p>Simple daemon that automatically creates git repository in the given directory and creates commit at the specified time interval.</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
$ git-etc --help
|
|
||||||
Simple daemon written on BASH for monitoring changes in files
|
|
||||||
|
|
||||||
Usage: git-etc [ -c | --config /etc/git-etc.conf ] [ -h | --help ] [ -v | --version ]
|
|
||||||
|
|
||||||
Parametrs:
|
|
||||||
-c --config - path to configuration file
|
|
||||||
-h --help - show this help and exit
|
|
||||||
-v --version - show version and exit
|
|
||||||
|
|
||||||
See "man 1 git-etc" for more details
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
$ ctrlconf --help
|
|
||||||
GUI for git-etc daemon
|
|
||||||
|
|
||||||
Usage: ctrlconf [ --default ] [ -h | --help ] [ -v | --version ]
|
|
||||||
|
|
||||||
Additional parametrs:
|
|
||||||
--default - create default configuration file
|
|
||||||
-h --help - show this help and exit
|
|
||||||
-v --version - show version and exit
|
|
||||||
|
|
||||||
See "man 1 ctrlconf" for more details
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors</h3>
|
|
||||||
<ul>
|
|
||||||
{% for devel in page.developers %}
|
|
||||||
<li>{{ devel }}</li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License</h3>
|
|
||||||
<ul>
|
|
||||||
<li>{{ page.license }}</li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of info block -->
|
|
||||||
|
|
||||||
<!-- install block -->
|
|
||||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation</h2>
|
|
||||||
|
|
||||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction</h3>
|
|
||||||
<ul>
|
|
||||||
<li>Download an <a href="//github.com/arcan1s/git-etc/releases" title="GitHub">archive</a> with latest version of source files.</li>
|
|
||||||
<li>Extract it and install the application:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
./install.sh "/path/to/root"
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
If you want install it to <code>/</code> you must run it as root, e.g.:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
sudo ./install.sh
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
If no path is specified it will be installed to <code>/</code> by default.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies</h3>
|
|
||||||
<p>I want note that all were tested on latest version of dependencies.</p>
|
|
||||||
<ul>
|
|
||||||
<li>Bash (including awk, grep, sed)</li>
|
|
||||||
<li>git</li>
|
|
||||||
<li>python2 <i>(make)</i></li>
|
|
||||||
<li>systemd <i>(optional, service file)</i></li>
|
|
||||||
<li>python2-pyqt4 <i>(optional, GUI)</i></li>
|
|
||||||
<li>xterm <i>(optional, GUI)</i></li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of install block -->
|
|
||||||
|
|
||||||
<!-- howto block -->
|
|
||||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use</h2>
|
|
||||||
<p>If you want to start the daemon into <code>/etc</code> just run</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
systemctl start git-etc
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>If you want to enable daemon autoload run</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
systemctl enable git-etc
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>But you may change path to configuration file or change parameters. To do it just copy (recommended) the source configuration file to new path</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cp /etc/git-etc.conf /new/path/to/file/git-etc.conf
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>and edit it. Then copy the source service file to <code>/etc</code>:</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cp /usr/lib/systemd/system/git-etc.service /etc/systemd/system/git-etc-my-profile.service
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>Replace following string in the file:</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
ExecStart=/usr/bin/git-etc -c /etc/git-etc.conf
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>to</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
ExecStart=/usr/bin/git-etc -c /new/path/to/file/git-etc.conf
|
|
||||||
{% endhighlight %}
|
|
||||||
<!-- end of howto block -->
|
|
||||||
|
|
||||||
<!-- config block -->
|
|
||||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Configuration</h2>
|
|
||||||
<p>All settings are stored in <code>/etc/git-etc.conf</code>. After edit them you must restart daemon</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
systemctl restart git-etc
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<h3><a href="#options" class="anchor" id="options"><span class="octicon octicon-link"></span></a>Options</h3>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<th>DIRECTORY</th>
|
|
||||||
<td>Full path to working directory with observed files. Default is <code>/etc</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>TIMESLEEP</th>
|
|
||||||
<td>Time interval between updates, hours. It must be integer and >= 1. Default is <code>12</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>IGNORELIST</th>
|
|
||||||
<td>List of files that will not be observed. Separator is ";;". May be empty.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>FORALL</th>
|
|
||||||
<td><code>1</code> will enable access for normal user. Default is <code>1</code>.</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
<!-- end of config block -->
|
|
||||||
|
|
||||||
<!-- gui block -->
|
|
||||||
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Graphical user interface</h2>
|
|
||||||
<p>Control Config (<code>ctrlconf</code>) is GUI for <code>git-etc</code> daemon written on <code>Python2/PyQt4</code>. This application allows you to view a list of commits and changes in files recorded in commit messages. Also, this application allows you to roll back to a specific commit all files (<code>git reset --hard</code>) or individual files (<code>git diff && git apply</code>). And you may merge old and new configuration files (used two branches repository - master and experimental). The application may need root privileges. Make sure that <code>sudo</code> package is installed.</p>
|
|
||||||
|
|
||||||
<h3><a href="#gui_configuration" class="anchor" id="gui_configuration"><span class="octicon octicon-link"></span></a>Configuration</h3>
|
|
||||||
<p>Just run the application and open the settings window from menu!</p>
|
|
||||||
|
|
||||||
<h3><a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Screenshots</h3>
|
|
||||||
<p>(Screenshots in Russian, but GUI has English translation.)</p>
|
|
||||||
|
|
||||||
<div class="thumbnails">
|
|
||||||
{% assign scrdesc = "Main window" %}
|
|
||||||
{% assign scrname = "git-etc_mainwindow" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "About window" %}
|
|
||||||
{% assign scrname = "git-etc_aboutwindow" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Commit window" %}
|
|
||||||
{% assign scrname = "git-etc_commitwindow" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Merging window" %}
|
|
||||||
{% assign scrname = "git-etc_mergingwindow" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Roll back window" %}
|
|
||||||
{% assign scrname = "git-etc_rollbackwindow" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
</div>
|
|
||||||
<!-- end of gui block -->
|
|
||||||
181
projects/git-etc.md
Normal file
181
projects/git-etc.md
Normal file
@ -0,0 +1,181 @@
|
|||||||
|
---
|
||||||
|
hastr: true
|
||||||
|
layout: project
|
||||||
|
title: git-etc
|
||||||
|
short: git-etc
|
||||||
|
tags: git, python, qt, linux, daemon, system
|
||||||
|
hasgui: true
|
||||||
|
hasdocs: false
|
||||||
|
developers:
|
||||||
|
- Evgeniy Alekseev
|
||||||
|
license: GPLv3
|
||||||
|
links:
|
||||||
|
- Archlinux <a href="//aur.archlinux.org/packages/git-etc", title="AUR">AUR package</a>
|
||||||
|
---
|
||||||
|
<!-- info block -->
|
||||||
|
## <a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information
|
||||||
|
|
||||||
|
Simple daemon that automatically creates git repository in the given directory and creates commit at the specified time interval.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ git-etc --help
|
||||||
|
Simple daemon written on BASH for monitoring changes in files
|
||||||
|
|
||||||
|
Usage: git-etc [ -c | --config /etc/git-etc.conf ] [ -h | --help ] [ -v | --version ]
|
||||||
|
|
||||||
|
Parametrs:
|
||||||
|
-c --config - path to configuration file
|
||||||
|
-h --help - show this help and exit
|
||||||
|
-v --version - show version and exit
|
||||||
|
|
||||||
|
See "man 1 git-etc" for more details
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ ctrlconf --help
|
||||||
|
GUI for git-etc daemon
|
||||||
|
|
||||||
|
Usage: ctrlconf [ --default ] [ -h | --help ] [ -v | --version ]
|
||||||
|
|
||||||
|
Additional parametrs:
|
||||||
|
--default - create default configuration file
|
||||||
|
-h --help - show this help and exit
|
||||||
|
-v --version - show version and exit
|
||||||
|
|
||||||
|
See "man 1 ctrlconf" for more details
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors
|
||||||
|
|
||||||
|
{% for devel in page.developers %}
|
||||||
|
* {{ devel }}{% endfor %}
|
||||||
|
|
||||||
|
### <a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License
|
||||||
|
|
||||||
|
* {{ page.license }}
|
||||||
|
|
||||||
|
<!-- end of info block -->
|
||||||
|
|
||||||
|
<!-- install block -->
|
||||||
|
## <a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation
|
||||||
|
|
||||||
|
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction
|
||||||
|
|
||||||
|
* Download an [archive](//github.com/arcan1s/git-etc/releases "GitHub") with latest version of source files.
|
||||||
|
* Extract it and install the application:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./install.sh "/path/to/root"
|
||||||
|
```
|
||||||
|
|
||||||
|
If you want install it to `/` you must run it as root, e.g.:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo ./install.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
If no path is specified it will be installed to `/` by default.
|
||||||
|
|
||||||
|
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies
|
||||||
|
|
||||||
|
I want note that all were tested on latest version of dependencies.
|
||||||
|
|
||||||
|
* Bash (including awk, grep, sed)
|
||||||
|
* git
|
||||||
|
* python2 *(make)*
|
||||||
|
* systemd *(optional, service file)*
|
||||||
|
* python2-pyqt4 *(optional, GUI)*
|
||||||
|
* xterm *(optional, GUI)*
|
||||||
|
|
||||||
|
<!-- end of install block -->
|
||||||
|
|
||||||
|
<!-- howto block -->
|
||||||
|
## <a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use
|
||||||
|
|
||||||
|
If you want to start the daemon into `/etc` just run
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl start git-etc
|
||||||
|
```
|
||||||
|
|
||||||
|
If you want to enable daemon autoload run
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl enable git-etc
|
||||||
|
```
|
||||||
|
|
||||||
|
But you may change path to configuration file or change parameters. To do it just copy (recommended) the source configuration file to new path
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp /etc/git-etc.conf /new/path/to/file/git-etc.conf
|
||||||
|
```
|
||||||
|
|
||||||
|
and edit it. Then copy the source service file to `/etc`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp /usr/lib/systemd/system/git-etc.service /etc/systemd/system/git-etc-my-profile.service
|
||||||
|
```
|
||||||
|
|
||||||
|
Replace following string in the file:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ExecStart=/usr/bin/git-etc -c /etc/git-etc.conf
|
||||||
|
```
|
||||||
|
|
||||||
|
to
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ExecStart=/usr/bin/git-etc -c /new/path/to/file/git-etc.conf
|
||||||
|
```
|
||||||
|
<!-- end of howto block -->
|
||||||
|
|
||||||
|
<!-- config block -->
|
||||||
|
## <a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Configuration
|
||||||
|
|
||||||
|
All settings are stored in `/etc/git-etc.conf`. After edit them you must restart daemon
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl restart git-etc
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#options" class="anchor" id="options"><span class="octicon octicon-link"></span></a>Options
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|------------|-------|
|
||||||
|
| DIRECTORY | Full path to working directory with observed files. Default is `/etc`. |
|
||||||
|
| TIMESLEEP | Time interval between updates, hours. It must be integer and >= 1\. Default is `12`. |
|
||||||
|
| IGNORELIST | List of files that will not be observed. Separator is ";;". May be empty. |
|
||||||
|
| FORALL | `1` will enable access for normal user. Default is `1`. |
|
||||||
|
<!-- end of config block -->
|
||||||
|
|
||||||
|
<!-- gui block -->
|
||||||
|
## <a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Graphical user interface
|
||||||
|
|
||||||
|
Control Config (`ctrlconf`) is GUI for `git-etc` daemon written on `Python2/PyQt4`. This application allows you to view a list of commits and changes in files recorded in commit messages. Also, this application allows you to roll back to a specific commit all files (`git reset --hard`) or individual files (`git diff && git apply`). And you may merge old and new configuration files (used two branches repository - master and experimental). The application may need root privileges. Make sure that `sudo` package is installed.
|
||||||
|
|
||||||
|
### <a href="#gui_configuration" class="anchor" id="gui_configuration"><span class="octicon octicon-link"></span></a>Configuration
|
||||||
|
|
||||||
|
Just run the application and open the settings window from menu!
|
||||||
|
|
||||||
|
### <a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Screenshots
|
||||||
|
|
||||||
|
(Screenshots in Russian, but GUI has English translation.)
|
||||||
|
|
||||||
|
<div class="thumbnails">
|
||||||
|
{% assign scrdesc = "Main window" %}
|
||||||
|
{% assign scrname = "git-etc_mainwindow" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "About window" %}
|
||||||
|
{% assign scrname = "git-etc_aboutwindow" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Commit window" %}
|
||||||
|
{% assign scrname = "git-etc_commitwindow" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Merging window" %}
|
||||||
|
{% assign scrname = "git-etc_mergingwindow" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Roll back window" %}
|
||||||
|
{% assign scrname = "git-etc_rollbackwindow" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
</div>
|
||||||
|
<!-- end of gui block -->
|
||||||
@ -1,206 +0,0 @@
|
|||||||
---
|
|
||||||
hastr: true
|
|
||||||
layout: project
|
|
||||||
title: Netctl GUI
|
|
||||||
short: netctl-gui
|
|
||||||
tags: archlinux, c++, qt, network, kde, netctl, system, dbus, library
|
|
||||||
hasgui: true
|
|
||||||
hasdocs: true
|
|
||||||
developers:
|
|
||||||
- Evgeniy Alekseev
|
|
||||||
- nosada (Japanese translation)
|
|
||||||
license: GPLv3
|
|
||||||
links:
|
|
||||||
- Page on <a href="//linux.softpedia.com/get/System/Networking/Netctl-GUI-103383.shtml" title="Softpedia">Softpedia</a>
|
|
||||||
- Page on <a href="//kde-apps.org/content/show.php?content=164490" title="kde-apps">kde-apps.org</a>
|
|
||||||
- <a href="//aur.archlinux.org/pkgbase/netctl-gui/" title="AUR">AUR package</a>
|
|
||||||
- <a href="/devs/netctl-gui-dbus-api.html" title="DBus API">DBus API reference</a>
|
|
||||||
- <a href="/devs/netctl-gui-security-notes.html" title="Security">Security notes</a>
|
|
||||||
---
|
|
||||||
<!-- info block -->
|
|
||||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information</h2>
|
|
||||||
<p>Graphical interface for <code>netctl</code> (several scripts for work with network connection in Archlinux). It is written on <code>C++</code> using <code>Qt</code> library. Now it may work with profiles and may create new profiles. Also it may create a connection to WiFi. Moreover, it provides a Qt library for interaction with netctl and widget and DataEngine for KDE4/KF5.</p>
|
|
||||||
|
|
||||||
<p><b>NOTE:</b> <a href="//github.com/arcan1s/netctl-gui/issues/3" title="Ticket">LOOKING FOR TRANSLATORS!</a></p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
$ netctl-gui --help
|
|
||||||
Usage:
|
|
||||||
netctl-gui [ options ]
|
|
||||||
Options:
|
|
||||||
Open window:
|
|
||||||
--detached - start detached from console
|
|
||||||
--maximized - start maximized
|
|
||||||
--minimized - start minimized to tray
|
|
||||||
--about - show about window
|
|
||||||
--netctl-auto - show netctl-auto window
|
|
||||||
--settings - show settings window
|
|
||||||
Functions:
|
|
||||||
-e, --essid <arg> - select this ESSID
|
|
||||||
-o, --open <arg> - open this profile
|
|
||||||
-s, --select <arg> - select this profile
|
|
||||||
Additional flags:
|
|
||||||
-c, --config <arg> - read configuration from this file
|
|
||||||
-d, --debug - print debug information
|
|
||||||
--default - start with default settings
|
|
||||||
--set-opts <arg> - set options for this run, comma separated
|
|
||||||
-t, --tab <arg> - open a tab with this number
|
|
||||||
Show messages:
|
|
||||||
-v, --version - show version and exit
|
|
||||||
-i, --info - show build information and exit
|
|
||||||
-h, --help - show this help and exit
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
$ netctlgui-helper --help
|
|
||||||
Usage:
|
|
||||||
netctlgui-helper [ options ]
|
|
||||||
Options:
|
|
||||||
-c, --config <arg> - read configuration from this file
|
|
||||||
-d, --debug - print debug information
|
|
||||||
--nodaemon - do not start as daemon
|
|
||||||
--replace - force replace the existing session
|
|
||||||
--restore - force restore the existing session
|
|
||||||
--system - do not read user configuration, system-wide only
|
|
||||||
Show messages:
|
|
||||||
-v, --version - show version and exit
|
|
||||||
-i, --info - show build information and exit
|
|
||||||
-h, --help - show this help and exit
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors</h3>
|
|
||||||
<ul>
|
|
||||||
{% for devel in page.developers %}
|
|
||||||
<li>{{ devel }}</li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License</h3>
|
|
||||||
<ul>
|
|
||||||
<li>{{ page.license }}</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#changelog" class="anchor" id="changelog"><span class="octicon octicon-link"></span></a>Changelog</h3>
|
|
||||||
<p><a href="//github.com/arcan1s/netctl-gui/blob/master/CHANGELOG" title="GitHub">CHANGELOG</a></p>
|
|
||||||
<!-- end of info block -->
|
|
||||||
|
|
||||||
<!-- install block -->
|
|
||||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation</h2>
|
|
||||||
|
|
||||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction</h3>
|
|
||||||
<ul>
|
|
||||||
<li>Download an <a href="//github.com/arcan1s/netctl-gui/releases" title="GitHub">archive</a> with latest version of source files.</li>
|
|
||||||
<li>Extract it and install the application. If you want install it into <code>/</code>, you should run as root following commands:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cd /path/to/extracted/archive
|
|
||||||
mkdir build && cd build
|
|
||||||
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release ../
|
|
||||||
make
|
|
||||||
sudo make install
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
Available cmake flags are:
|
|
||||||
<ul>
|
|
||||||
<li>components:
|
|
||||||
<ul>
|
|
||||||
<li><code>-DBUILD_DATAENGINE:BOOL=0</code> - do not build DataEngine</li>
|
|
||||||
<li><code>-DBUILD_GUI:BOOL=0</code> - do not build GUI</li>
|
|
||||||
<li><code>-DBUILD_HELPER:BOOL=0</code> - do not build helper daemon</li>
|
|
||||||
<li><code>-DBUILD_LIBRARY:BOOL=0</code> - do not build library</li>
|
|
||||||
<li><code>-DBUILD_PLASMOID:BOOL=0</code> - do not build Plasmoid</li>
|
|
||||||
</ul></li>
|
|
||||||
<li>additional components:
|
|
||||||
<ul>
|
|
||||||
<li><code>-DBUILD_DOCS:BOOL=0</code> - do not build developer documentation</li>
|
|
||||||
<li><code>-DBUILD_TEST:BOOL=1</code> - build auto tests for the library and the helper</li>
|
|
||||||
</ul></li>
|
|
||||||
<li>project properties:
|
|
||||||
<ul>
|
|
||||||
<li><code>-DDBUS_SYSTEMCONF_PATH=/etc/dbus-1/system.d/</code> - path to DBus system configuration files</li>
|
|
||||||
<li><code>-DSYSTEMD_SERVICE_PATH=lib/systemd/system</code> - path to systemd services</li>
|
|
||||||
<li><code>-DUSE_CAPABILITIES:BOOL=0</code> - do not use setcap to get privileges to the helper</li>
|
|
||||||
<li><code>-DBUILD_KDE4:BOOL=1</code> - build plasmoid under KDE4 instead of KF5</li>
|
|
||||||
<li><code>-DUSE_QT5:BOOL=0</code> - use Qt4 instead of Qt5 for GUI</li>
|
|
||||||
</ul></li>
|
|
||||||
</ul></li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies</h3>
|
|
||||||
<p>I want note that all were tested on latest version of dependencies.</p>
|
|
||||||
<ul>
|
|
||||||
<li>netctl</li>
|
|
||||||
<li>qt5-base <i>(if Qt5 is used)</i> <b>or</b> qt4 <i>(if Qt4 is used)</i></li>
|
|
||||||
<li>automoc4 <i>(make)</i></li>
|
|
||||||
<li>cmake <i>(make)</i></li>
|
|
||||||
<li>qt5-tools <i>(make, if Qt5 is used)</i></li>
|
|
||||||
<li>kdebase-workspace <i>(optional, KDE4 widget)</i></li>
|
|
||||||
<li>plasma-frameworks <i>(optional, KF5 widget)</i></li>
|
|
||||||
<li>sudo <i>(optional, sudo support)</i></li>
|
|
||||||
<li>wpa_supplicant <i>(optional, WiFi support)</i></li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of install block -->
|
|
||||||
|
|
||||||
<!-- howto block -->
|
|
||||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use</h2>
|
|
||||||
<p>Just run application <code>netctl-gui</code>. If it is needed (and if you use KDE), you may add widget <code>netctl</code>, which provides by the application.</p>
|
|
||||||
<!-- end of howto block -->
|
|
||||||
|
|
||||||
<!-- config block -->
|
|
||||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Configuration</h2>
|
|
||||||
<p>It is recommended to use graphical interface for configuration. Configuration files are:</p>
|
|
||||||
<ul>
|
|
||||||
<li><code>$HOME/.config/netctl-gui.conf</code> - GUI/helper user configuration</li>
|
|
||||||
<li><code>/etc/netctl-gui.conf</code> - helper system-wide configuration</li>
|
|
||||||
<ul>
|
|
||||||
<li><code>$KDEHOME/share/config/plasma-dataengine-netctl.conf</code> - DataEngine user configuration</li>
|
|
||||||
<li><code>$KDESYSTEM/share/config/plasma-dataengine-netctl.conf</code> - DataEngine system-wide configuration</li>
|
|
||||||
</ul>
|
|
||||||
<ul>
|
|
||||||
<li><code>$HOME/.config/plasma-dataengine-netctl.conf</code> - DataEngine user configuration</li>
|
|
||||||
<li><code>/etc/xdg/plasma-dataengine-netctl.conf</code> - DataEngine system-wide configuration</li>
|
|
||||||
</ul>
|
|
||||||
</ul>
|
|
||||||
<!-- end of config block -->
|
|
||||||
|
|
||||||
<!-- gui block -->
|
|
||||||
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Graphical user interface</h2>
|
|
||||||
<p>Graphical interface provides by <code>netctl-gui</code> application.</p>
|
|
||||||
|
|
||||||
<h3><a name="screenshots" class="anchor" href="#screenshots"><span class="octicon octicon-link"></span></a>Screenshots</h3>
|
|
||||||
<div class="thumbnails">
|
|
||||||
{% assign scrdesc = "DataEngine" %}
|
|
||||||
{% assign scrname = "netctl-gui_dataengine" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Widget" %}
|
|
||||||
{% assign scrname = "netctl-gui_plasmoid" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Widget settings window" %}
|
|
||||||
{% assign scrname = "netctl-gui_plasmoid_conf_01" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Widget settings window" %}
|
|
||||||
{% assign scrname = "netctl-gui_plasmoid_conf_02" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Widget settings window" %}
|
|
||||||
{% assign scrname = "netctl-gui_plasmoid_conf_03" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Main window" %}
|
|
||||||
{% assign scrname = "netctl-gui_main" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Profile window" %}
|
|
||||||
{% assign scrname = "netctl-gui_profile" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "WiFi window" %}
|
|
||||||
{% assign scrname = "netctl-gui_wifi" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "About window" %}
|
|
||||||
{% assign scrname = "netctl-gui_about" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "netctl-auto window" %}
|
|
||||||
{% assign scrname = "netctl-gui_netctl-auto" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Settings window" %}
|
|
||||||
{% assign scrname = "netctl-gui_settings" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
</div>
|
|
||||||
<!-- end of gui block -->
|
|
||||||
203
projects/netctl-gui.md
Normal file
203
projects/netctl-gui.md
Normal file
@ -0,0 +1,203 @@
|
|||||||
|
---
|
||||||
|
hastr: true
|
||||||
|
layout: project
|
||||||
|
title: Netctl GUI
|
||||||
|
short: netctl-gui
|
||||||
|
tags: archlinux, c++, qt, network, kde, netctl, system, dbus, library
|
||||||
|
hasgui: true
|
||||||
|
hasdocs: true
|
||||||
|
developers:
|
||||||
|
- Evgeniy Alekseev
|
||||||
|
- nosada (Japanese translation)
|
||||||
|
license: GPLv3
|
||||||
|
links:
|
||||||
|
- Page on <a href="//linux.softpedia.com/get/System/Networking/Netctl-GUI-103383.shtml" title="Softpedia">Softpedia</a>
|
||||||
|
- Page on <a href="//kde-apps.org/content/show.php?content=164490" title="kde-apps">kde-apps.org</a>
|
||||||
|
- <a href="//aur.archlinux.org/pkgbase/netctl-gui/" title="AUR">AUR package</a>
|
||||||
|
- <a href="/devs/netctl-gui-dbus-api.html" title="DBus API">DBus API reference</a>
|
||||||
|
- <a href="/devs/netctl-gui-security-notes.html" title="Security">Security notes</a>
|
||||||
|
---
|
||||||
|
<!-- info block -->
|
||||||
|
## <a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information
|
||||||
|
|
||||||
|
Graphical interface for `netctl` (several scripts for work with network connection in Archlinux). It is written on `C++` using `Qt` library. Now it may work with profiles and may create new profiles. Also it may create a connection to WiFi. Moreover, it provides a Qt library for interaction with netctl and widget and DataEngine for KDE4/KF5.
|
||||||
|
|
||||||
|
**NOTE:** [LOOKING FOR TRANSLATORS!](//github.com/arcan1s/netctl-gui/issues/3 "Ticket")
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ netctl-gui --help
|
||||||
|
Usage:
|
||||||
|
netctl-gui [ options ]
|
||||||
|
Options:
|
||||||
|
Open window:
|
||||||
|
--detached - start detached from console
|
||||||
|
--maximized - start maximized
|
||||||
|
--minimized - start minimized to tray
|
||||||
|
--about - show about window
|
||||||
|
--netctl-auto - show netctl-auto window
|
||||||
|
--settings - show settings window
|
||||||
|
Functions:
|
||||||
|
-e, --essid <arg> - select this ESSID
|
||||||
|
-o, --open <arg> - open this profile
|
||||||
|
-s, --select <arg> - select this profile
|
||||||
|
Additional flags:
|
||||||
|
-c, --config <arg> - read configuration from this file
|
||||||
|
-d, --debug - print debug information
|
||||||
|
--default - start with default settings
|
||||||
|
--set-opts <arg> - set options for this run, comma separated
|
||||||
|
-t, --tab <arg> - open a tab with this number
|
||||||
|
Show messages:
|
||||||
|
-v, --version - show version and exit
|
||||||
|
-i, --info - show build information and exit
|
||||||
|
-h, --help - show this help and exit
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ netctlgui-helper --help
|
||||||
|
Usage:
|
||||||
|
netctlgui-helper [ options ]
|
||||||
|
Options:
|
||||||
|
-c, --config <arg> - read configuration from this file
|
||||||
|
-d, --debug - print debug information
|
||||||
|
--nodaemon - do not start as daemon
|
||||||
|
--replace - force replace the existing session
|
||||||
|
--restore - force restore the existing session
|
||||||
|
--system - do not read user configuration, system-wide only
|
||||||
|
Show messages:
|
||||||
|
-v, --version - show version and exit
|
||||||
|
-i, --info - show build information and exit
|
||||||
|
-h, --help - show this help and exit
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors
|
||||||
|
|
||||||
|
{% for devel in page.developers %}
|
||||||
|
* {{ devel }}{% endfor %}
|
||||||
|
|
||||||
|
### <a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License
|
||||||
|
|
||||||
|
* {{ page.license }}
|
||||||
|
|
||||||
|
### <a href="#changelog" class="anchor" id="changelog"><span class="octicon octicon-link"></span></a>Changelog
|
||||||
|
|
||||||
|
[CHANGELOG](//github.com/arcan1s/netctl-gui/blob/master/CHANGELOG "GitHub")
|
||||||
|
|
||||||
|
<!-- end of info block -->
|
||||||
|
|
||||||
|
<!-- install block -->
|
||||||
|
## <a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation
|
||||||
|
|
||||||
|
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction
|
||||||
|
|
||||||
|
* Download an [archive](//github.com/arcan1s/netctl-gui/releases "GitHub") with latest version of source files.
|
||||||
|
* Extract it and install the application. If you want install it into `/`, you should run as root following commands:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /path/to/extracted/archive
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release ../
|
||||||
|
make
|
||||||
|
sudo make install
|
||||||
|
```
|
||||||
|
|
||||||
|
Available cmake flags are:
|
||||||
|
|
||||||
|
* components:
|
||||||
|
* `-DBUILD_DATAENGINE:BOOL=0` - do not build DataEngine
|
||||||
|
* `-DBUILD_GUI:BOOL=0` - do not build GUI
|
||||||
|
* `-DBUILD_HELPER:BOOL=0` - do not build helper daemon
|
||||||
|
* `-DBUILD_LIBRARY:BOOL=0` - do not build library
|
||||||
|
* `-DBUILD_PLASMOID:BOOL=0` - do not build Plasmoid
|
||||||
|
* additional components:
|
||||||
|
* `-DBUILD_DOCS:BOOL=0` - do not build developer documentation
|
||||||
|
* `-DBUILD_TEST:BOOL=1` - build auto tests for the library and the helper
|
||||||
|
* project properties:
|
||||||
|
* `-DDBUS_SYSTEMCONF_PATH=/etc/dbus-1/system.d/` - path to DBus system configuration files
|
||||||
|
* `-DSYSTEMD_SERVICE_PATH=lib/systemd/system` - path to systemd services
|
||||||
|
* `-DUSE_CAPABILITIES:BOOL=0` - do not use setcap to get privileges to the helper
|
||||||
|
* `-DBUILD_KDE4:BOOL=1` - build plasmoid under KDE4 instead of KF5
|
||||||
|
* `-DUSE_QT5:BOOL=0` - use Qt4 instead of Qt5 for GUI
|
||||||
|
|
||||||
|
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies
|
||||||
|
|
||||||
|
I want note that all were tested on latest version of dependencies.
|
||||||
|
|
||||||
|
* netctl
|
||||||
|
* qt5-base *(if Qt5 is used)* **or** qt4 *(if Qt4 is used)*
|
||||||
|
* automoc4 *(make)*
|
||||||
|
* cmake *(make)*
|
||||||
|
* qt5-tools *(make, if Qt5 is used)*
|
||||||
|
* kdebase-workspace *(optional, KDE4 widget)*
|
||||||
|
* plasma-frameworks *(optional, KF5 widget)*
|
||||||
|
* sudo *(optional, sudo support)*
|
||||||
|
* wpa_supplicant *(optional, WiFi support)*
|
||||||
|
|
||||||
|
<!-- end of install block -->
|
||||||
|
|
||||||
|
<!-- howto block -->
|
||||||
|
## <a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use
|
||||||
|
|
||||||
|
Just run application `netctl-gui`. If it is needed (and if you use KDE), you may add widget `netctl`, which provides by the application.
|
||||||
|
|
||||||
|
<!-- end of howto block -->
|
||||||
|
|
||||||
|
<!-- config block -->
|
||||||
|
## <a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Configuration
|
||||||
|
|
||||||
|
It is recommended to use graphical interface for configuration. Configuration files are:
|
||||||
|
|
||||||
|
* UI and helper
|
||||||
|
* `$HOME/.config/netctl-gui.conf` - GUI/helper user configuration
|
||||||
|
* `/etc/netctl-gui.conf` - helper system-wide configuration
|
||||||
|
* DataEngine (KDE4 version)
|
||||||
|
* `$KDEHOME/share/config/plasma-dataengine-netctl.conf` - DataEngine user configuration
|
||||||
|
* `$KDESYSTEM/share/config/plasma-dataengine-netctl.conf` - DataEngine system-wide configuration
|
||||||
|
* DataEngine (KF5 version)
|
||||||
|
* `$HOME/.config/plasma-dataengine-netctl.conf` - DataEngine user configuration
|
||||||
|
* `/etc/xdg/plasma-dataengine-netctl.conf` - DataEngine system-wide configuration
|
||||||
|
|
||||||
|
<!-- end of config block -->
|
||||||
|
|
||||||
|
<!-- gui block -->
|
||||||
|
## <a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Graphical user interface
|
||||||
|
|
||||||
|
Graphical interface provides by `netctl-gui` application.
|
||||||
|
|
||||||
|
### <a name="screenshots" class="anchor" href="#screenshots"><span class="octicon octicon-link"></span></a>Screenshots
|
||||||
|
|
||||||
|
<div class="thumbnails">
|
||||||
|
{% assign scrdesc = "DataEngine" %}
|
||||||
|
{% assign scrname = "netctl-gui_dataengine" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Widget" %}
|
||||||
|
{% assign scrname = "netctl-gui_plasmoid" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Widget settings window" %}
|
||||||
|
{% assign scrname = "netctl-gui_plasmoid_conf_01" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Widget settings window" %}
|
||||||
|
{% assign scrname = "netctl-gui_plasmoid_conf_02" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Widget settings window" %}
|
||||||
|
{% assign scrname = "netctl-gui_plasmoid_conf_03" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Main window" %}
|
||||||
|
{% assign scrname = "netctl-gui_main" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Profile window" %}
|
||||||
|
{% assign scrname = "netctl-gui_profile" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "WiFi window" %}
|
||||||
|
{% assign scrname = "netctl-gui_wifi" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "About window" %}
|
||||||
|
{% assign scrname = "netctl-gui_about" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "netctl-auto window" %}
|
||||||
|
{% assign scrname = "netctl-gui_netctl-auto" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Settings window" %}
|
||||||
|
{% assign scrname = "netctl-gui_settings" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
</div>
|
||||||
|
<!-- end of gui block -->
|
||||||
@ -1,106 +0,0 @@
|
|||||||
---
|
|
||||||
hastr: true
|
|
||||||
layout: project
|
|
||||||
title: Oblikue strategies
|
|
||||||
short: oblikuestrategies
|
|
||||||
tags: qt, c++, kde, linux, fun
|
|
||||||
hasgui: true
|
|
||||||
hasdocs: false
|
|
||||||
developers:
|
|
||||||
- Evgeniy Alekseev
|
|
||||||
license: GPL
|
|
||||||
links:
|
|
||||||
- Page on <a href="//kde-look.org/content/show.php/oblikue-strategies?content=160503" title="kde-look">kde-look.org</a>
|
|
||||||
- Archlinux <a href="//aur.archlinux.org/packages/kdeplasma-applets-oblikuestrategies" title="AUR">AUR package</a>
|
|
||||||
---
|
|
||||||
<!-- info block -->
|
|
||||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information</h2>
|
|
||||||
<p>Plasmoid written on <code>CPP</code> that displays a random draw from Brian Eno and Peter Schmidt's <a href="//en.wikipedia.org/wiki/Oblique_strategies" title="Wiki">Oblique Strategies</a>. It is <a href="//gnome-look.org/content/show.php/Oblique+Strategies?content=78405" title="gnome-look">GNOME applet</a> fork with some of special features.</p>
|
|
||||||
|
|
||||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors</h3>
|
|
||||||
<ul>
|
|
||||||
{% for devel in page.developers %}
|
|
||||||
<li>{{ devel }}</li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License</h3>
|
|
||||||
<ul>
|
|
||||||
<li>{{ page.license }}</li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of info block -->
|
|
||||||
|
|
||||||
<!-- install block -->
|
|
||||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation</h2>
|
|
||||||
|
|
||||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction</h3>
|
|
||||||
<ul>
|
|
||||||
<li>Download an <a href="//github.com/arcan1s/oblikuestrategies/releases" title="GitHub">archive</a> with latest version of source files.</li>
|
|
||||||
<li>Extract it and install the application. For global isntallation type:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cd /where/is/applet/
|
|
||||||
mkdir build && cd build
|
|
||||||
cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` -DCMAKE_BUILD_TYPE=Release ../
|
|
||||||
make
|
|
||||||
sudo make install
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
For local isntallation type:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cd /where/is/applet/
|
|
||||||
mkdir build && cd build
|
|
||||||
cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --localprefix` -DCMAKE_BUILD_TYPE=Release ../
|
|
||||||
make
|
|
||||||
make install
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
</li>
|
|
||||||
<li>Restart plasma to load the applet:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
kquitapp plasma-desktop && sleep 2 && plasma-desktop
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
Also you might need to run <code>kbuildsycoca4</code> in order to get the <code>*.desktop</code> file recognized:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
kbuildsycoca4 &> /dev/null
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies</h3>
|
|
||||||
<p>I want note that all were tested on latest version of dependencies.</p>
|
|
||||||
<ul>
|
|
||||||
<li>kdebase-workspace</li>
|
|
||||||
<li>automoc4 <i>(make)</i></li>
|
|
||||||
<li>cmake <i>(make)</i></li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of install block -->
|
|
||||||
|
|
||||||
<!-- howto block -->
|
|
||||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use</h2>
|
|
||||||
<p>Open your Plasma widgets and select <code>Oblikue strategies</code>.</p>
|
|
||||||
<!-- end of howto block -->
|
|
||||||
|
|
||||||
<!-- config block -->
|
|
||||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Configuration</h2>
|
|
||||||
<p>Right click on widget.</p>
|
|
||||||
<!-- end of config block -->
|
|
||||||
|
|
||||||
<!-- gui block -->
|
|
||||||
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Graphical user interface</h2>
|
|
||||||
|
|
||||||
<h3><a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Screenshots</h3>
|
|
||||||
<div class="thumbnails">
|
|
||||||
{% assign scrdesc = "Widget" %}
|
|
||||||
{% assign scrname = "oblikuestrategies_widget" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Configuration window" %}
|
|
||||||
{% assign scrname = "oblikuestrategies_config" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
</div>
|
|
||||||
<!-- end of gui block -->
|
|
||||||
107
projects/oblikuestrategies.md
Normal file
107
projects/oblikuestrategies.md
Normal file
@ -0,0 +1,107 @@
|
|||||||
|
---
|
||||||
|
hastr: true
|
||||||
|
layout: project
|
||||||
|
title: Oblikue strategies
|
||||||
|
short: oblikuestrategies
|
||||||
|
tags: qt, c++, kde, linux, fun
|
||||||
|
hasgui: true
|
||||||
|
hasdocs: false
|
||||||
|
developers:
|
||||||
|
- Evgeniy Alekseev
|
||||||
|
license: GPL
|
||||||
|
links:
|
||||||
|
- Page on <a href="//kde-look.org/content/show.php/oblikue-strategies?content=160503", title="kde-look">kde-look.org</a>
|
||||||
|
- Archlinux <a href="//aur.archlinux.org/packages/kdeplasma-applets-oblikuestrategies", title="AUR">AUR package</a>
|
||||||
|
---
|
||||||
|
<!-- info block -->
|
||||||
|
## <a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information
|
||||||
|
|
||||||
|
Plasmoid written on `CPP` that displays a random draw from Brian Eno and Peter Schmidt's [Oblique Strategies](//en.wikipedia.org/wiki/Oblique_strategies "Wiki"). It is [GNOME applet](//gnome-look.org/content/show.php/Oblique+Strategies?content=78405 "gnome-look") fork with some of special features.
|
||||||
|
|
||||||
|
### <a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors
|
||||||
|
|
||||||
|
{% for devel in page.developers %}
|
||||||
|
* {{ devel }}{% endfor %}
|
||||||
|
|
||||||
|
### <a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License
|
||||||
|
|
||||||
|
* {{ page.license }}
|
||||||
|
|
||||||
|
<!-- end of info block -->
|
||||||
|
|
||||||
|
<!-- install block -->
|
||||||
|
## <a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation
|
||||||
|
|
||||||
|
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction
|
||||||
|
|
||||||
|
* Download an [archive](//github.com/arcan1s/oblikuestrategies/releases "GitHub") with latest version of source files.
|
||||||
|
* Extract it and install the application. For global isntallation type:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /where/is/applet/
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` -DCMAKE_BUILD_TYPE=Release ../
|
||||||
|
make
|
||||||
|
sudo make install
|
||||||
|
```
|
||||||
|
|
||||||
|
For local installation type:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /where/is/applet/
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --localprefix` -DCMAKE_BUILD_TYPE=Release ../
|
||||||
|
make
|
||||||
|
make install
|
||||||
|
```
|
||||||
|
|
||||||
|
* Restart plasma to load the applet:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
kquitapp plasma-desktop && sleep 2 && plasma-desktop
|
||||||
|
```
|
||||||
|
|
||||||
|
Also you might need to run `kbuildsycoca4` in order to get the `*.desktop` file recognized:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
kbuildsycoca4 &> /dev/null
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies
|
||||||
|
|
||||||
|
I want note that all were tested on latest version of dependencies.
|
||||||
|
|
||||||
|
* kdebase-workspace
|
||||||
|
* automoc4 *(make)*
|
||||||
|
* cmake *(make)*
|
||||||
|
|
||||||
|
<!-- end of install block -->
|
||||||
|
|
||||||
|
<!-- howto block -->
|
||||||
|
## <a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use
|
||||||
|
|
||||||
|
Open your Plasma widgets and select `Oblikue strategies`.
|
||||||
|
|
||||||
|
<!-- end of howto block -->
|
||||||
|
|
||||||
|
<!-- config block -->
|
||||||
|
## <a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Configuration
|
||||||
|
|
||||||
|
Right click on widget.
|
||||||
|
|
||||||
|
<!-- end of config block -->
|
||||||
|
|
||||||
|
<!-- gui block -->
|
||||||
|
## <a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Graphical user interface
|
||||||
|
|
||||||
|
### <a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Screenshots
|
||||||
|
|
||||||
|
<div class="thumbnails">
|
||||||
|
{% assign scrdesc = "Widget" %}
|
||||||
|
{% assign scrname = "oblikuestrategies_widget" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Configuration window" %}
|
||||||
|
{% assign scrname = "oblikuestrategies_config" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
</div>
|
||||||
|
<!-- end of gui block -->
|
||||||
@ -1,169 +0,0 @@
|
|||||||
---
|
|
||||||
hastr: true
|
|
||||||
layout: project
|
|
||||||
title: queued
|
|
||||||
short: queued
|
|
||||||
tags: linux, shell, daemon, system
|
|
||||||
hasgui: false
|
|
||||||
hasdocs: false
|
|
||||||
developers:
|
|
||||||
- Evgeniy Alekseev
|
|
||||||
license: GPLv3
|
|
||||||
links:
|
|
||||||
---
|
|
||||||
<!-- info block -->
|
|
||||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information</h2>
|
|
||||||
<p>Daemon for starting jobs to queue of calculations. It was written as proof-of-concept.</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
$ queued --help
|
|
||||||
Simple daemon written on BASH for starting jobs to queue of calculations
|
|
||||||
|
|
||||||
Usage: queued [ -c /etc/queued.conf ] [ -v | --version ] [ -h | --help ]
|
|
||||||
Parametrs:
|
|
||||||
-c PATH - path to configuration file. Default is '/etc/queued.conf'
|
|
||||||
|
|
||||||
-v --version - show version and exit
|
|
||||||
-h --help - show this help and exit
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
$ add_queued --help
|
|
||||||
add_queued [ -c /etc/queued.conf ] [ -p NUM ] [ -u USER ] [ -h | --help ] /path/to/script
|
|
||||||
|
|
||||||
Parameters:
|
|
||||||
-c PATH - path to configuration file. Default is '/etc/queued.conf'
|
|
||||||
-p NUM - job priority
|
|
||||||
-u USER - username
|
|
||||||
-h --help - show this help and exit
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors</h3>
|
|
||||||
<ul>
|
|
||||||
{% for devel in page.developers %}
|
|
||||||
<li>{{ devel }}</li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License</h3>
|
|
||||||
<ul>
|
|
||||||
<li>{{ page.license }}</li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of info block -->
|
|
||||||
|
|
||||||
<!-- install block -->
|
|
||||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation</h2>
|
|
||||||
|
|
||||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction</h3>
|
|
||||||
<ul>
|
|
||||||
<li>Download an <a href="//github.com/arcan1s/queued/releases" title="GitHub">archive</a> with latest version of source files.</li>
|
|
||||||
<li>Extract it and install the application:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
./install.sh "/path/to/root/"
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
If you want install it to <code>/</code> you must run it as root, e.g.:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
sudo ./install.sh
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
If no path is specified it will be installed to <code>/</code> by default.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies</h3>
|
|
||||||
<p>I want note that all were tested on latest version of dependencies.</p>
|
|
||||||
<ul>
|
|
||||||
<li>Bash (including awk, grep, sed)</li>
|
|
||||||
<li>systemd <i>(optional, service file)</i></li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of install block -->
|
|
||||||
|
|
||||||
<!-- howto block -->
|
|
||||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use</h2>
|
|
||||||
<p>If you want to start the daemon just run</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
systemctl start queued
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>If you want to enable daemon autoload run</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
systemctl enable queued
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>But you may change path to configuration file or change parameters. To do it just copy (recommended) the source configuration file to new path</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cp /etc/queued.conf /path/to/new/queued.conf
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>and edit it. Then copy the source service file to <code>/etc</code>:</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cp /usr/lib/systemd/system/queued.service /etc/systemd/system/queued-my-profile.service
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>Replace following string in the file:</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
ExecStart=/usr/bin/queued
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>to</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
ExecStart=/usr/bin/queued -c /path/to/new/queued.conf
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<h3><a href="#adding" class="anchor" id="adding"><span class="octicon octicon-link"></span></a>Adding a job</h3>
|
|
||||||
<ol>
|
|
||||||
<li>Create shell script with the command (e.g. it have a name <code>script.sh</code>).</li>
|
|
||||||
<li>Create priority file (<code>script.sh.pr</code>) with the job priority if it is needed.</li>
|
|
||||||
<li>Create user file (<code>script.sh.user</code>) with the job username if it is needed.</li>
|
|
||||||
<li>Copy files to <code>$WORKDIR</code>.</li>
|
|
||||||
</ol>
|
|
||||||
<p>Also you may use <code>add_queued</code>.</p>
|
|
||||||
|
|
||||||
<h2><a href="#configuration" class="anchor" id="configuration"><span class="octicon octicon-link"></span></a>Configuration</h2>
|
|
||||||
<p>All settings are stored in <code>/etc/queued.conf</code>. After edit them you must restart daemon</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
systemctl restart queued
|
|
||||||
{% endhighlight %}
|
|
||||||
<!-- end of howto block -->
|
|
||||||
|
|
||||||
<!-- config block -->
|
|
||||||
<h3><a href="#options" class="anchor" id="options"><span class="octicon octicon-link"></span></a>Options</h3>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<th>WORKDIR</th>
|
|
||||||
<td>Full path to directory with source jobs. Default is <code>/var/lib/queued/work</code>. This directory must contain source scripts <code>script-name</code>, a priority file (it is not necessary) <code>script-name.pr</code> and a file with username (it is not necessary too) <code>script-name.user</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>JOBDIR</th>
|
|
||||||
<td>Full path to directory with running jobs. Default is <code>/var/lib/queued/job</code>. All job files will be moved here.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>QUEUEFILE</th>
|
|
||||||
<td>Full path to file with queue list. Default is <code>/var/lib/queued/queue</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>PRIORITY</th>
|
|
||||||
<td>Default priority. Default is <code>0</code>. The higher the value, the higher the priority of the task.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>SLEEPTIME</th>
|
|
||||||
<td>Time interval in minutes. Default is <code>5</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>STARTASUSER</th>
|
|
||||||
<td>Default user. Default is <code>root</code>. This user will own created files.</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
<!-- end of config block -->
|
|
||||||
|
|
||||||
<!-- gui block -->
|
|
||||||
<!-- end of gui block -->
|
|
||||||
153
projects/queued.md
Normal file
153
projects/queued.md
Normal file
@ -0,0 +1,153 @@
|
|||||||
|
---
|
||||||
|
hastr: true
|
||||||
|
layout: project
|
||||||
|
title: queued
|
||||||
|
short: queued
|
||||||
|
tags: linux, shell, daemon, system
|
||||||
|
hasgui: false
|
||||||
|
hasdocs: false
|
||||||
|
developers:
|
||||||
|
- Evgeniy Alekseev
|
||||||
|
license: GPLv3
|
||||||
|
links:
|
||||||
|
---
|
||||||
|
<!-- info block -->
|
||||||
|
## <a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information
|
||||||
|
|
||||||
|
Daemon for starting jobs to queue of calculations. It was written as proof-of-concept.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ queued --help
|
||||||
|
Simple daemon written on BASH for starting jobs to queue of calculations
|
||||||
|
|
||||||
|
Usage: queued [ -c /etc/queued.conf ] [ -v | --version ] [ -h | --help ]
|
||||||
|
Parametrs:
|
||||||
|
-c PATH - path to configuration file. Default is '/etc/queued.conf'
|
||||||
|
|
||||||
|
-v --version - show version and exit
|
||||||
|
-h --help - show this help and exit
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ add_queued --help
|
||||||
|
add_queued [ -c /etc/queued.conf ] [ -p NUM ] [ -u USER ] [ -h | --help ] /path/to/script
|
||||||
|
|
||||||
|
Parameters:
|
||||||
|
-c PATH - path to configuration file. Default is '/etc/queued.conf'
|
||||||
|
-p NUM - job priority
|
||||||
|
-u USER - username
|
||||||
|
-h --help - show this help and exit
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors
|
||||||
|
|
||||||
|
{% for devel in page.developers %}
|
||||||
|
* {{ devel }}{% endfor %}
|
||||||
|
|
||||||
|
### <a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License
|
||||||
|
|
||||||
|
* {{ page.license }}
|
||||||
|
|
||||||
|
<!-- end of info block -->
|
||||||
|
|
||||||
|
<!-- install block -->
|
||||||
|
## <a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation
|
||||||
|
|
||||||
|
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction
|
||||||
|
|
||||||
|
* Download an [archive](//github.com/arcan1s/queued/releases "GitHub") with latest version of source files.
|
||||||
|
* Extract it and install the application:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./install.sh "/path/to/root/"
|
||||||
|
```
|
||||||
|
|
||||||
|
If you want install it to `/` you must run it as root, e.g.:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo ./install.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
If no path is specified it will be installed to `/` by default.
|
||||||
|
|
||||||
|
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies
|
||||||
|
|
||||||
|
I want note that all were tested on latest version of dependencies.
|
||||||
|
|
||||||
|
* Bash (including awk, grep, sed)
|
||||||
|
* systemd *(optional, service file)*
|
||||||
|
|
||||||
|
<!-- end of install block -->
|
||||||
|
|
||||||
|
<!-- howto block -->
|
||||||
|
## <a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use
|
||||||
|
|
||||||
|
If you want to start the daemon just run
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl start queued
|
||||||
|
```
|
||||||
|
|
||||||
|
If you want to enable daemon autoload run
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl enable queued
|
||||||
|
```
|
||||||
|
|
||||||
|
But you may change path to configuration file or change parameters. To do it just copy (recommended) the source configuration file to new path
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp /etc/queued.conf /path/to/new/queued.conf
|
||||||
|
```
|
||||||
|
|
||||||
|
and edit it. Then copy the source service file to `/etc`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp /usr/lib/systemd/system/queued.service /etc/systemd/system/queued-my-profile.service
|
||||||
|
```
|
||||||
|
|
||||||
|
Replace following string in the file:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ExecStart=/usr/bin/queued
|
||||||
|
```
|
||||||
|
|
||||||
|
to
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ExecStart=/usr/bin/queued -c /path/to/new/queued.conf
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#adding" class="anchor" id="adding"><span class="octicon octicon-link"></span></a>Adding a job
|
||||||
|
|
||||||
|
1. Create shell script with the command (e.g. it have a name `script.sh`).
|
||||||
|
2. Create priority file (`script.sh.pr`) with the job priority if it is needed.
|
||||||
|
3. Create user file (`script.sh.user`) with the job username if it is needed.
|
||||||
|
4. Copy files to `$WORKDIR`.
|
||||||
|
|
||||||
|
Also you may use `add_queued`.
|
||||||
|
|
||||||
|
## <a href="#configuration" class="anchor" id="configuration"><span class="octicon octicon-link"></span></a>Configuration
|
||||||
|
|
||||||
|
All settings are stored in `/etc/queued.conf`. After edit them you must restart daemon
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl restart queued
|
||||||
|
```
|
||||||
|
<!-- end of howto block -->
|
||||||
|
|
||||||
|
<!-- config block -->
|
||||||
|
### <a href="#options" class="anchor" id="options"><span class="octicon octicon-link"></span></a>Options
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|---------|---------|
|
||||||
|
| WORKDIR | Full path to directory with source jobs. Default is `/var/lib/queued/work`. This directory must contain source scripts `script-name`, a priority file (it is not necessary) `script-name.pr` and a file with username (it is not necessary too) `script-name.user`. |
|
||||||
|
| JOBDIR | Full path to directory with running jobs. Default is `/var/lib/queued/job`. All job files will be moved here. |
|
||||||
|
| QUEUEFILE | Full path to file with queue list. Default is `/var/lib/queued/queue`. |
|
||||||
|
| PRIORITY | Default priority. Default is `0`. The higher the value, the higher the priority of the task. |
|
||||||
|
| SLEEPTIME | Time interval in minutes. Default is `5`. |
|
||||||
|
| STARTASUSER | Default user. Default is `root`. This user will own created files. |
|
||||||
|
<!-- end of config block -->
|
||||||
|
|
||||||
|
<!-- gui block -->
|
||||||
|
<!-- end of gui block -->
|
||||||
@ -1,161 +0,0 @@
|
|||||||
---
|
|
||||||
hastr: true
|
|
||||||
layout: project
|
|
||||||
title: Report a Bug
|
|
||||||
short: reportabug
|
|
||||||
tags: qt, c++, library, development
|
|
||||||
hasgui: false
|
|
||||||
hasdocs: true
|
|
||||||
developers:
|
|
||||||
- Evgeniy Alekseev
|
|
||||||
license: LGPLv3
|
|
||||||
links:
|
|
||||||
---
|
|
||||||
<!-- info block -->
|
|
||||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information</h2>
|
|
||||||
<p>Qt application/library which allows users to create an issue for projects which are hosted on GitHub. It may work over <a href="//github.com" title="GitHub">GitHub</a> or <a href="//gitreports.com/" title="GitReports">GitReport</a>. It works fine, but it was created as proof-of-concept.</p>
|
|
||||||
|
|
||||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors</h3>
|
|
||||||
<ul>
|
|
||||||
{% for devel in page.developers %}
|
|
||||||
<li>{{ devel }}</li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License</h3>
|
|
||||||
<ul>
|
|
||||||
<li>{{ page.license }}</li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of info block -->
|
|
||||||
|
|
||||||
<!-- install block -->
|
|
||||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation</h2>
|
|
||||||
|
|
||||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction</h3>
|
|
||||||
<h4><a href="#singleapp" class="anchor" id="singleapp"><span class="octicon octicon-link"></span></a>Build as a single application</h4>
|
|
||||||
<ul>
|
|
||||||
<li>Download the actual source <a href="//github.com/arcan1s/reportabug/releases" title="GitHub">tarball</a>.</li>
|
|
||||||
<li>Extract it and set up your configuration.</li>
|
|
||||||
<li>Install the application:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cd /path/to/extracted/archive
|
|
||||||
mkdir build && cd build
|
|
||||||
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release -DBUILD_AS_LIBRARY:BOOL=0 ../
|
|
||||||
make
|
|
||||||
sudo make install
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h4><a href="#aslibrary" class="anchor" id="aslibrary"><span class="octicon octicon-link"></span></a>Build as a library in your project</h4>
|
|
||||||
<ul>
|
|
||||||
<li>Download the actual source <a href="//github.com/arcan1s/reportabug/releases" title="GitHub">tarball</a>.</li>
|
|
||||||
<li>Extract it and set up your configuration.</li>
|
|
||||||
<li>include it into your project. For example if you use <code>cmake</code>:
|
|
||||||
|
|
||||||
{% highlight cmake %}
|
|
||||||
add_subdirectory (reportabug)
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
</li>
|
|
||||||
<li>Declare class in you sources. For example:
|
|
||||||
|
|
||||||
{% highlight cpp %}
|
|
||||||
Reportabug *reportWindow = new Reportabug(parent=this,
|
|
||||||
debugCmd=false,
|
|
||||||
params=0);
|
|
||||||
reportWindow->showWindow();
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
</li>
|
|
||||||
<li>Link your application with this library.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h4><a href="#cmakeflags" class="anchor" id="cmakeflags"><span class="octicon octicon-link"></span></a>Available cmake flags:</h4>
|
|
||||||
<ul>
|
|
||||||
<li><code>-DBUILD_AS_LIBRARY=0</code> - build the application but not a library.</li>
|
|
||||||
<li><code>-DBUILD_DOCS=1</code> - build developer documentation.</li>
|
|
||||||
<li><code>-DBUILD_SHARED_LIBRARY=1</code> - build the shared library instead of static one.</li>
|
|
||||||
<li><code>-DENABLE_GITHUB=0</code> - disable GitHub module.</li>
|
|
||||||
<li><code>-DENABLE_GITREPORT=0</code> - disable GitReport module.</li>
|
|
||||||
<li><code>-DOWN_GITHUB_TOKEN=STRING</code> - use STRING as own GitHub token.</li>
|
|
||||||
<li><code>-DUSE_QT5=0</code> - use Qt4 instead of Qt5.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies</h3>
|
|
||||||
<p>I want note that all were tested on latest version of dependencies.</p>
|
|
||||||
<ul>
|
|
||||||
<li>qt5-base <i>(if Qt5 is used)</i> <b>or</b> qt4 <i>(if Qt4 is used)</i></li>
|
|
||||||
<li>qt5-network (if Qt5 is used)</li>
|
|
||||||
<li>automoc4 <i>(make)</i></li>
|
|
||||||
<li>cmake <i>(make)</i></li>
|
|
||||||
<li>doxygen <i>(make, documentation)</i></li>
|
|
||||||
<li>qt5-webkit (if Qt5 is used) <b>or</b> qtwebkit (if Qt4 is used) <i>(optional, required by GitReports module)</i></li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of install block -->
|
|
||||||
|
|
||||||
<!-- howto block -->
|
|
||||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use</h2>
|
|
||||||
<h3><a href="#github" class="anchor" id="github"><span class="octicon octicon-link"></span></a>GitHub module</h3>
|
|
||||||
|
|
||||||
<p>This module creates an issue over GitHub. <a href="//developer.github.com/v3/issues/" title="Documentation">GitHub API</a> is used for creating issue. User should type own username and password. The typical POST request is:</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
curl -X POST -u user:pass -d '{"title":"A new bug","body":"Some error occurs"}' \
|
|
||||||
//api.github.com/repos/owner/repo/issues
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>To disable this module use <code>-DENABLE_GITHUB=0</code> cmake flag.</p>
|
|
||||||
|
|
||||||
<p>This module may send request using developer's token too. Please visit <a href="//github.com/settings/applications" title="Settings">this page</a> and generate a new one. Needed scopes are <code>public_repo</code> (or <code>repo</code> if you will use it for a private repository).<br>
|
|
||||||
<b>Please keep in mind that passing the token in the clear, you may discredit your account.</b></p>
|
|
||||||
|
|
||||||
<p>The typical POST request is:</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
curl -X POST -H "Authorization: token token" -d '{"title":"A new bug","body":"Some error occurs"}' \
|
|
||||||
//api.github.com/repos/owner/repo/issues
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>To enable this module set up your token using <code>-DOWN_GITHUB_TOKEN=0</code> cmake flag.</p>
|
|
||||||
|
|
||||||
<p>This module requires <code>QtNetwork</code> module.</p>
|
|
||||||
|
|
||||||
<h3><a href="#gitreports" class="anchor" id="gitreports"><span class="octicon octicon-link"></span></a>GitReports module</h3>
|
|
||||||
<p>This module creates issue over <a href="//gitreports.com/about" title="GitReports">GitReports</a>. Please visit <a href="//gitreports.com/" title="GitReports">this page</a> and set up it for your repository.</p>
|
|
||||||
|
|
||||||
<p>To disable this module use <code>-DENABLE_GITREPORT=0</code> cmake flag. This module requires <code>QtNetwork</code> and <code>QtWebKit</code> modules.</p>
|
|
||||||
<!-- end of howto block -->
|
|
||||||
|
|
||||||
<!-- config block -->
|
|
||||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Configuration</h2>
|
|
||||||
<p>For the developer configuration please use <code>config.h</code> header. Also you may load parametrs dynamically using <code>params</code> array (needed keys is the same as for the header</p>
|
|
||||||
<h3><a href="#mainconfig" class="anchor" id="mainconfig"><span class="octicon octicon-link"></span></a>Main configuration</h3>
|
|
||||||
<ul>
|
|
||||||
<li><code>OWNER</code> - the owner of the source repository.</li>
|
|
||||||
<li><code>PROJECT</code> - the project name.</li>
|
|
||||||
<li><code>TAG_BODY</code> - default body of an issue. It may be used for both modules.</li>
|
|
||||||
<li><code>TAG_TITLE</code> - default title of an issue. It may be used only for GitHub module.</li>
|
|
||||||
<li><code>TAG_ASSIGNEE</code> - assign an issue to this account. It may be used only for GitHub module. This tag will work only if user has push access. If it will be empty, it will be ignored.</li>
|
|
||||||
<li><code>TAG_LABELS</code> - set these labels to an issue. Labels should be comma separated. It may be used only for GitHub module. This tag will work only if user has push access. If it will be empty, it will be ignored.</li>
|
|
||||||
<li><code>TAG_MILESTONE</code> - set this milestone to an issue. It may be used only for GitHub module. This tag will work only if user has push access. If it will be empty, it will be ignored.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#githubconfig" class="anchor" id="githubconfig"><span class="octicon octicon-link"></span></a>GitHub module settings</h3>
|
|
||||||
<ul>
|
|
||||||
<li><code>GITHUB_COMBOBOX</code> - text of this module into comboBox.</li>
|
|
||||||
<li><code>ISSUES_URL</code> - issues url, in the most cases do not touch it. Default is <code>//api.github.com/repos/$OWNER/$PROJECT/issues</code>. Available tags here are <code>$PROJECT</code>, <code>$OWNER</code>.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#gitreportsconfig" class="anchor" id="gitreportsconfig"><span class="octicon octicon-link"></span></a>GitReports module settings</h3>
|
|
||||||
<ul>
|
|
||||||
<li><code>CAPTCHA_URL</code> - captcha url, in the most cases do not touch it. Default is <code>//gitreports.com/simple_captcha?code=</code>.</li>
|
|
||||||
<li><code>GITREPORT_COMBOBOX</code> - text of this module into comboBox.</li>
|
|
||||||
<li><code>PUBLIC_URL</code> - issues url, in the most cases do not touch it. Default is <code>//gitreports.com/issue/$OWNER/$PROJECT</code>. Available tags here are <code>$PROJECT</code>, <code>$OWNER</code>.</li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of config block -->
|
|
||||||
|
|
||||||
<!-- gui block -->
|
|
||||||
<!-- end of gui block -->
|
|
||||||
157
projects/reportabug.md
Normal file
157
projects/reportabug.md
Normal file
@ -0,0 +1,157 @@
|
|||||||
|
---
|
||||||
|
hastr: true
|
||||||
|
layout: project
|
||||||
|
title: Report a Bug
|
||||||
|
short: reportabug
|
||||||
|
tags: qt, c++, library, development
|
||||||
|
hasgui: false
|
||||||
|
hasdocs: true
|
||||||
|
developers:
|
||||||
|
- Evgeniy Alekseev
|
||||||
|
license: LGPLv3
|
||||||
|
links:
|
||||||
|
---
|
||||||
|
<!-- info block -->
|
||||||
|
## <a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information
|
||||||
|
|
||||||
|
Qt application/library which allows users to create an issue for projects which are hosted on GitHub. It may work over [GitHub](//github.com "GitHub") or [GitReport](//gitreports.com/ "GitReports"). It works fine, but it was created as proof-of-concept.
|
||||||
|
|
||||||
|
### <a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors
|
||||||
|
|
||||||
|
{% for devel in page.developers %}
|
||||||
|
* {{ devel }}{% endfor %}
|
||||||
|
|
||||||
|
### <a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License
|
||||||
|
|
||||||
|
* {{ page.license }}
|
||||||
|
|
||||||
|
<!-- end of info block -->
|
||||||
|
|
||||||
|
<!-- install block -->
|
||||||
|
## <a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation
|
||||||
|
|
||||||
|
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction
|
||||||
|
|
||||||
|
#### <a href="#singleapp" class="anchor" id="singleapp"><span class="octicon octicon-link"></span></a>Build as a standalone application
|
||||||
|
|
||||||
|
* Download the actual source [tarball](//github.com/arcan1s/reportabug/releases "GitHub").
|
||||||
|
* Extract it and set up your configuration.
|
||||||
|
* Install the application:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /path/to/extracted/archive
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release -DBUILD_AS_LIBRARY:BOOL=0 ../
|
||||||
|
make
|
||||||
|
sudo make install
|
||||||
|
```
|
||||||
|
|
||||||
|
#### <a href="#aslibrary" class="anchor" id="aslibrary"><span class="octicon octicon-link"></span></a>Build as a library in your project
|
||||||
|
|
||||||
|
* Download the actual source [tarball](//github.com/arcan1s/reportabug/releases "GitHub").
|
||||||
|
* Extract it and set up your configuration.
|
||||||
|
* include it into your project. For example if you use `cmake`:
|
||||||
|
|
||||||
|
```cmake
|
||||||
|
add_subdirectory (reportabug)
|
||||||
|
```
|
||||||
|
|
||||||
|
* Declare class in you sources. For example:
|
||||||
|
|
||||||
|
```cpp
|
||||||
|
Reportabug *reportWindow = new Reportabug(parent=this, debugCmd=false, params=0);
|
||||||
|
reportWindow->showWindow();
|
||||||
|
```
|
||||||
|
|
||||||
|
* Link your application with this library.
|
||||||
|
|
||||||
|
#### <a href="#cmakeflags" class="anchor" id="cmakeflags"><span class="octicon octicon-link"></span></a>Available cmake flags:
|
||||||
|
|
||||||
|
* `-DBUILD_AS_LIBRARY=0` - build the application but not a library.
|
||||||
|
* `-DBUILD_DOCS=1` - build developer documentation.
|
||||||
|
* `-DBUILD_SHARED_LIBRARY=1` - build the shared library instead of static one.
|
||||||
|
* `-DENABLE_GITHUB=0` - disable GitHub module.
|
||||||
|
* `-DENABLE_GITREPORT=0` - disable GitReport module.
|
||||||
|
* `-DOWN_GITHUB_TOKEN=STRING` - use STRING as own GitHub token.
|
||||||
|
* `-DUSE_QT5=0` - use Qt4 instead of Qt5.
|
||||||
|
|
||||||
|
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies
|
||||||
|
|
||||||
|
I want note that all were tested on latest version of dependencies.
|
||||||
|
|
||||||
|
* qt5-base *(if Qt5 is used)* **or** qt4 *(if Qt4 is used)*
|
||||||
|
* qt5-network (if Qt5 is used)
|
||||||
|
* automoc4 *(make)*
|
||||||
|
* cmake *(make)*
|
||||||
|
* doxygen *(make, documentation)*
|
||||||
|
* qt5-webkit (if Qt5 is used) **or** qtwebkit (if Qt4 is used) *(optional, required by GitReports module)*
|
||||||
|
|
||||||
|
<!-- end of install block -->
|
||||||
|
|
||||||
|
<!-- howto block -->
|
||||||
|
## <a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use
|
||||||
|
|
||||||
|
### <a href="#github" class="anchor" id="github"><span class="octicon octicon-link"></span></a>GitHub module
|
||||||
|
|
||||||
|
This module creates an issue over GitHub. [GitHub API](//developer.github.com/v3/issues/ "Documentation") is used for creating issue. User should type own username and password. The typical POST request is:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST -u user:pass -d '{"title":"A new bug","body":"Some error occurs"}' \
|
||||||
|
//api.github.com/repos/owner/repo/issues
|
||||||
|
```
|
||||||
|
|
||||||
|
To disable this module use `-DENABLE_GITHUB=0` cmake flag.
|
||||||
|
|
||||||
|
This module may send request using developer's token too. Please visit [this page](//github.com/settings/applications "Settings") and generate a new one. Needed scopes are `public_repo` (or `repo` if you will use it for a private repository).
|
||||||
|
|
||||||
|
**Please keep in mind that passing the token in the clear, you may discredit your account.**
|
||||||
|
|
||||||
|
The typical POST request is:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST -H "Authorization: token token" -d '{"title":"A new bug","body":"Some error occurs"}' \
|
||||||
|
//api.github.com/repos/owner/repo/issues
|
||||||
|
```
|
||||||
|
|
||||||
|
To enable this module set up your token using `-DOWN_GITHUB_TOKEN=0` cmake flag.
|
||||||
|
|
||||||
|
This module requires `QtNetwork` module.
|
||||||
|
|
||||||
|
### <a href="#gitreports" class="anchor" id="gitreports"><span class="octicon octicon-link"></span></a>GitReports module
|
||||||
|
|
||||||
|
This module creates issue over [GitReports](//gitreports.com/about "GitReports"). Please visit [this page](//gitreports.com/ "GitReports") and set up it for your repository.
|
||||||
|
|
||||||
|
To disable this module use `-DENABLE_GITREPORT=0` cmake flag. This module requires `QtNetwork` and `QtWebKit` modules.
|
||||||
|
|
||||||
|
<!-- end of howto block -->
|
||||||
|
|
||||||
|
<!-- config block -->
|
||||||
|
## <a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Configuration
|
||||||
|
|
||||||
|
For the developer configuration please use `config.h` header. Also you may load parametrs dynamically using `params` array (needed keys is the same as for the header
|
||||||
|
|
||||||
|
### <a href="#mainconfig" class="anchor" id="mainconfig"><span class="octicon octicon-link"></span></a>Main configuration
|
||||||
|
|
||||||
|
* `OWNER` - the owner of the source repository.
|
||||||
|
* `PROJECT` - the project name.
|
||||||
|
* `TAG_BODY` - default body of an issue. It may be used for both modules.
|
||||||
|
* `TAG_TITLE` - default title of an issue. It may be used only for GitHub module.
|
||||||
|
* `TAG_ASSIGNEE` - assign an issue to this account. It may be used only for GitHub module. This tag will work only if user has push access. If it will be empty, it will be ignored.
|
||||||
|
* `TAG_LABELS` - set these labels to an issue. Labels should be comma separated. It may be used only for GitHub module. This tag will work only if user has push access. If it will be empty, it will be ignored.
|
||||||
|
* `TAG_MILESTONE` - set this milestone to an issue. It may be used only for GitHub module. This tag will work only if user has push access. If it will be empty, it will be ignored.
|
||||||
|
|
||||||
|
### <a href="#githubconfig" class="anchor" id="githubconfig"><span class="octicon octicon-link"></span></a>GitHub module settings
|
||||||
|
|
||||||
|
* `GITHUB_COMBOBOX` - text of this module into comboBox.
|
||||||
|
* `ISSUES_URL` - issues url, in the most cases do not touch it. Default is `//api.github.com/repos/$OWNER/$PROJECT/issues`. Available tags here are `$PROJECT`, `$OWNER`.
|
||||||
|
|
||||||
|
### <a href="#gitreportsconfig" class="anchor" id="gitreportsconfig"><span class="octicon octicon-link"></span></a>GitReports module settings
|
||||||
|
|
||||||
|
* `CAPTCHA_URL` - captcha url, in the most cases do not touch it. Default is `//gitreports.com/simple_captcha?code=`.
|
||||||
|
* `GITREPORT_COMBOBOX` - text of this module into comboBox.
|
||||||
|
* `PUBLIC_URL` - issues url, in the most cases do not touch it. Default is `//gitreports.com/issue/$OWNER/$PROJECT`. Available tags here are `$PROJECT`, `$OWNER`.
|
||||||
|
|
||||||
|
<!-- end of config block -->
|
||||||
|
|
||||||
|
<!-- gui block -->
|
||||||
|
<!-- end of gui block -->
|
||||||
@ -1,915 +0,0 @@
|
|||||||
---
|
|
||||||
category: ru
|
|
||||||
hastr: true
|
|
||||||
layout: project
|
|
||||||
title: Awesome Widgets
|
|
||||||
short: awesome-widgets
|
|
||||||
tags: python, kde, qt, linux, система, awesome
|
|
||||||
hasgui: true
|
|
||||||
hasdocs: false
|
|
||||||
developers:
|
|
||||||
- Evgeniy Alekseev
|
|
||||||
- Ernesto Avilés Vzqz (перевод на испанский)
|
|
||||||
- Mermouy (перевод на французский)
|
|
||||||
- underr (перевод на бразильский португальский)
|
|
||||||
- Виктор Слободян (перевод на украинский)
|
|
||||||
- Lemueler (перевод на китайский)
|
|
||||||
- Heimen Stoffels (перевод на голландский)
|
|
||||||
license: GPLv3
|
|
||||||
links:
|
|
||||||
- Страница плазмоида на <a href="//kde-look.org/content/show.php/Awesome+Widgets?content=157124" title="kde-look">kde-look.org</a>
|
|
||||||
- Страница DataEngine на <a href="//kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773" title="kde-look">kde-look.org</a>
|
|
||||||
- Пакет в <a href="//aur.archlinux.org/packages/kdeplasma-applets-awesome-widgets" title="AUR">AUR</a>
|
|
||||||
- Пакет для <a href="//software.opensuse.org/package/plasma5-awesome-widgets" title="openSUSE">openSUSE</a> (спасибо Kott)
|
|
||||||
- Пакеты для <a href="//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>
|
|
||||||
---
|
|
||||||
<!-- info block -->
|
|
||||||
<h2><a href="#information" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
|
||||||
<p>Набор минималистичных легко настраиваемых пламоидов, написанных на <code>C++/Qt</code>. Они выглядят, как виджеты в <a href="//awesome.naquadah.org/" title="Домашняя страница Awesome">Awesome WM</a>. Также пакет предоставляет дополнительный системный <a href="//techbase.kde.org/Development/Tutorials/Plasma/DataEngines" title="Мануал для разработчиков">DataEngine</a>.</p>
|
|
||||||
|
|
||||||
<p><b>ВНИМАНИЕ:</b> <a href="//github.com/arcan1s/awesome-widgets/issues/14" title="Тикет">НУЖНЫ ПЕРЕВОДЧИКИ!</a></p>
|
|
||||||
<p><b>Совместим с Plasma 5!</b></p>
|
|
||||||
|
|
||||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
|
||||||
<ul>
|
|
||||||
{% for devel in page.developers %}
|
|
||||||
<li>{{ devel }}</li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
|
||||||
<ul>
|
|
||||||
<li>{{ page.license }}</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#changelog" class="anchor" id="changelog"><span class="octicon octicon-link"></span></a>Список изменений</h3>
|
|
||||||
<p><a href="//github.com/arcan1s/awesome-widgets/blob/master/CHANGELOG-RU" title="GitHub">CHANGELOG-RU</a></p>
|
|
||||||
<!-- end of info block -->
|
|
||||||
|
|
||||||
<!-- install block -->
|
|
||||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
|
||||||
|
|
||||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
|
||||||
<ul>
|
|
||||||
<li>Скачайте <a href="//github.com/arcan1s/awesome-widgets/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</li>
|
|
||||||
<li>Извлеките из него файлы и установите:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cd /путь/к/извлеченным/файлам/
|
|
||||||
mkdir build && cd build
|
|
||||||
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr ../
|
|
||||||
make
|
|
||||||
sudo make install
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<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>plasma-framework</li>
|
|
||||||
<li>cmake <i>(make)</i></li>
|
|
||||||
<li>extra-cmake-modules <i>(make)</i></li>
|
|
||||||
<li>hddtemp <b>или</b> smartmontools <i>(опционально, для контроля за температурой HDD)</i></li>
|
|
||||||
<li>один из поддерживаемых музыкальных плееров <i>(опционально, для контроля за музыкальным плеером)</i></li>
|
|
||||||
<li>проприетарный видеодрайвер <i>(опционально, для контроля за GPU)</i></li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of install block -->
|
|
||||||
|
|
||||||
<!-- howto block -->
|
|
||||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
|
||||||
<p>Откройте список виджетов Plasma и выберете <code>Awesome Widget</code>.</p>
|
|
||||||
|
|
||||||
<h3><a href="#tips" class="anchor" id="tips"><span class="octicon octicon-link"></span></a>Tips & tricks</h3>
|
|
||||||
<p>Вы можете использовать несколько цветов в тексте. Просто вставьте нужный текст в html код. Смотри <a href="//github.com/arcan1s/awesome-widgets/issues/9" title="GitHub">вопрос</a> для более подробной информации.</p>
|
|
||||||
<!-- end of howto block -->
|
|
||||||
|
|
||||||
<!-- config block -->
|
|
||||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
|
||||||
|
|
||||||
<h3><a href="#deconf" class="anchor" id="deconf"><span class="octicon octicon-link"></span></a>Настройка DataEngine</h3>
|
|
||||||
<p>Вы можете отредактировать настройки DataEngine, которые хранятся в <code>/etc/xdg/plasma-dataengine-extsysmon.conf</code> и <code>$HOME/.config/plasma-dataengine-extsysmon.conf</code>. Раскомментируйте необходимые строчки и отредактируйте их.</p>
|
|
||||||
|
|
||||||
<h4><a href="#deoptions" class="anchor" id="deoptions"><span class="octicon octicon-link"></span></a>Опции DataEngine</h4>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<th>ACPIPATH</th>
|
|
||||||
<td>Путь к устройствам ACPI. По умолчанию <code>/sys/class/power_supply/</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>GPUDEV</th>
|
|
||||||
<td>Устанавливает тип GPU. Может быть <code>nvidia</code> (для nVidia), <code>ati</code> (для ATI Radeon), <code>disable</code> или <code>auto</code>. По умолчанию <code>auto</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>HDDDEV</th>
|
|
||||||
<td>Устанавливает блочное устройство для <code>hddtemp</code> через запятую или <code>all</code> для всех возможных. <code>disable</code> отключит монитор температуры HDD. По умолчанию <code>all</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>HDDTEMPCMD</th>
|
|
||||||
<td>Команда, которая будет запущена для hddtemp. По умолчанию <code>sudo smartctl -a</code>. Поддерживаемые приложения - <code>hddtemp</code> и <code>smartmontools</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>MPDADDRESS</th>
|
|
||||||
<td>Адрес MPD хоста. По умолчанию <code>localhost</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>MPDPORT</th>
|
|
||||||
<td>Адрес MPD хоста. По умолчанию <code>6600</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>PLAYER</th>
|
|
||||||
<td>Устанавливает музыкальный плеер. Поддерживаемые плееры: mpd и с поддержкой MPRIS/DBus. <code>disable</code> отключит данный монитор.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>PLAYERSYMBOLS</th>
|
|
||||||
<td>Количество символов в динамических тегах монитора за плеером. По умолчанию <code>10</code>.</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
<h3><a href="#widconf" class="anchor" id="widconf"><span class="octicon octicon-link"></span></a>Настройка виджета</h3>
|
|
||||||
<p>Для настройки внешнего вида Вы должны открыть окно настроек и установить требуемый формат текста. HTML теги обрабатываются корректно.</p>
|
|
||||||
|
|
||||||
<p>Доступные флаги приведены в таблице ниже.<br>
|
|
||||||
<b>ЗАМЕЧАНИЕ</b> Нумерация всех массивов в переменных начинается с 0.</p>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<th>Тип</th>
|
|
||||||
<th>Тег</th>
|
|
||||||
<th>Описание</th>
|
|
||||||
<th>Введен</th>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="5">Время</th>
|
|
||||||
<td><code>$time</code></td>
|
|
||||||
<td>Время в стандартном формате. Например, <code>fri Nov 6 04:48:01 2013</code>.</td>
|
|
||||||
<td>1.5.1</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$isotime</code></td>
|
|
||||||
<td>Время в формате ISO.</td>
|
|
||||||
<td>1.5.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$shorttime</code></td>
|
|
||||||
<td>Время в коротком формате локали.</td>
|
|
||||||
<td>1.5.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$longtime</code></td>
|
|
||||||
<td>Время в длинном формате локали.</td>
|
|
||||||
<td>1.5.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$ctime</code></td>
|
|
||||||
<td>Специальный формат времени.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="2">Время работы</th>
|
|
||||||
<td><code>$uptime</code></td>
|
|
||||||
<td>Системный аптайм, <code>---d--h--m</code>.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$cuptime</code></td>
|
|
||||||
<td>Специальный формат аптайма.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="3">Средняя загрузка</th>
|
|
||||||
<td><code>$la1</code></td>
|
|
||||||
<td>Средняя загрузка за 1 минуту, <code>-----</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$la5</code></td>
|
|
||||||
<td>Средняя загрузка за 5 минут, <code>-----</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$la15</code></td>
|
|
||||||
<td>Средняя загрузка за 15 минут, <code>-----</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="2">CPU</th>
|
|
||||||
<td><code>$cpu</code></td>
|
|
||||||
<td>Полная загрузка CPU, %, <code>-----</code>.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$cpuN</code></td>
|
|
||||||
<td>Загрузка CPU для ядра N, %, <code>-----</code>.</td>
|
|
||||||
<td>1.7.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="2">Частота CPU</th>
|
|
||||||
<td><code>$cpucl</code></td>
|
|
||||||
<td>Средняя частота CPU, МГц, <code>----</code>.</td>
|
|
||||||
<td>1.1.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$cpuclN</code></td>
|
|
||||||
<td>Частота CPU для ядра N, МГц, <code>----</code>.</td>
|
|
||||||
<td>1.7.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="1">Температура</th>
|
|
||||||
<td><code>$tempN</code></td>
|
|
||||||
<td>Температура для датчика N, <code>----</code>. Пример: <code>$temp0</code></td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="1">GPU</th>
|
|
||||||
<td><code>$gpu</code></td>
|
|
||||||
<td>Использование GPU, %, <code>-----</code>. <code>aticonfig</code> или <code>nvidia-smi</code> должны быть установлены.</td>
|
|
||||||
<td>1.3.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="1">Температура GPU</th>
|
|
||||||
<td><code>$gputemp</code></td>
|
|
||||||
<td>Температура GPU, <code>----</code>. <code>aticonfig</code> или <code>nvidia-smi</code> должны быть установлены.</td>
|
|
||||||
<td>1.3.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="9">Память</th>
|
|
||||||
<td><code>$mem</code></td>
|
|
||||||
<td>Использование RAM, %, <code>-----</code>.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memmb</code></td>
|
|
||||||
<td>Использование RAM, MB, <code>-----</code>.</td>
|
|
||||||
<td>1.1.1</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memgb</code></td>
|
|
||||||
<td>Использование RAM, GB, <code>----</code>.</td>
|
|
||||||
<td>1.7.3</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memfreemb</code></td>
|
|
||||||
<td>Свободная RAM, MB, <code>-----</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memfreegb</code></td>
|
|
||||||
<td>Свободная RAM, GB, <code>----</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memtotmb</code></td>
|
|
||||||
<td>RAM, MB, <code>-----</code>.</td>
|
|
||||||
<td>1.10.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memtotgb</code></td>
|
|
||||||
<td>RAM, GB, <code>----</code>.</td>
|
|
||||||
<td>1.10.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memusedmb</code></td>
|
|
||||||
<td>Занятая и кэшированная RAM, MB, <code>-----</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$memusedgb</code></td>
|
|
||||||
<td>Занятая и кэшированная RAM, GB, <code>----</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="7">Swap</th>
|
|
||||||
<td><code>$swap</code></td>
|
|
||||||
<td>Использование swap, %, <code>-----</code>.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$swapmb</code></td>
|
|
||||||
<td>Использование swap, MB, <code>-----</code>.</td>
|
|
||||||
<td>1.1.1</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$swapgb</code></td>
|
|
||||||
<td>Использование swap, GB, <code>----</code>.</td>
|
|
||||||
<td>1.7.3</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$swapfreemb</code></td>
|
|
||||||
<td>Свободный swap, MB, <code>-----</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$swapfreegb</code></td>
|
|
||||||
<td>Свободный swap, GB, <code>----</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$swaptotmb</code></td>
|
|
||||||
<td>swap, MB, <code>-----</code>.</td>
|
|
||||||
<td>1.10.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$swaptotgb</code></td>
|
|
||||||
<td>swap, GB, <code>----</code>.</td>
|
|
||||||
<td>1.10.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="7">HDD</th>
|
|
||||||
<td><code>$hddN</code></td>
|
|
||||||
<td>Занятость точки монтирования N, %, <code>-----</code>. Пример: <code>$hdd0</code>.</td>
|
|
||||||
<td>1.3.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddmbN</code></td>
|
|
||||||
<td>Занятость точки монтирования N, MB, <code>-----</code>. Пример: <code>$hddmb0</code>.</td>
|
|
||||||
<td>1.8.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddgbN</code></td>
|
|
||||||
<td>Занятость точки монтирования N, GB, <code>-----</code>. Пример: <code>$hddgb0</code>.</td>
|
|
||||||
<td>1.8.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddfreembN</code></td>
|
|
||||||
<td>Свободное место точки монтирования N, MB, <code>-----</code>. Пример: <code>$hddfreemb0</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddfreegbN</code></td>
|
|
||||||
<td>Свободное место точки монтирования N, GB, <code>-----</code>. Пример: <code>$hddfreegb0</code>.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddtotmbN</code></td>
|
|
||||||
<td>Размер точки монтирования N, MB, <code>-----</code>. Пример: <code>$hddtotmb0</code>.</td>
|
|
||||||
<td>1.10.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddtotgbN</code></td>
|
|
||||||
<td>Размер точки монтирования N, GB, <code>-----</code>. Пример: <code>$hddtotgb0</code>.</td>
|
|
||||||
<td>1.10.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="2">Скорость HDD</th>
|
|
||||||
<td><code>$hddrN</code></td>
|
|
||||||
<td>Скорость записи диска N, KB/s, <code>-----</code>. Пример: <code>$hddr0</code>.</td>
|
|
||||||
<td>1.9.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hddwN</code></td>
|
|
||||||
<td>Скорость чтения диска N, KB/s, <code>-----</code>. Пример: <code>$hddw0</code>.</td>
|
|
||||||
<td>1.9.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="1">Температура HDD</th>
|
|
||||||
<td><code>$hddtempN</code></td>
|
|
||||||
<td>Температура HDD с номером N, <code>----</code>. Пример <code>$hddtemp0</code>. <code>hddtemp</code> или <code>smartmontools</code> должен быть установлен.</td>
|
|
||||||
<td>1.7.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="13">Сеть</th>
|
|
||||||
<td><code>$down</code></td>
|
|
||||||
<td>Скорость загрузки активного устройства, KB/s или MB/s, <code>----</code>.</td>
|
|
||||||
<td>1.7.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$downkb</code></td>
|
|
||||||
<td>Скорость загрузки активного устройства, KB/s, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$downunits</code></td>
|
|
||||||
<td>Единицы скорости загрузки активного устройства, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$downN</code></td>
|
|
||||||
<td>Скорость загрузки устройства N, KB/s или MB/s, <code>----</code>.</td>
|
|
||||||
<td>2.2.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$downkbN</code></td>
|
|
||||||
<td>Скорость загрузки устройства N, KB/s, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$downunitsN</code></td>
|
|
||||||
<td>Единицы cкорости загрузки устройства N, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$up</code></td>
|
|
||||||
<td>Скорость отдачи активного устройства, KB/s или MB/s, <code>----</code>.</td>
|
|
||||||
<td>1.7.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$upkb</code></td>
|
|
||||||
<td>Скорость отдачи активного устройства, KB/s, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$upunits</code></td>
|
|
||||||
<td>Единицы скорости отдачи активного устройства, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$upN</code></td>
|
|
||||||
<td>Скорость отдачи устройства N, KB/s или MB/s, <code>----</code>.</td>
|
|
||||||
<td>2.2.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$upkbN</code></td>
|
|
||||||
<td>Скорость отдачи устройства N, KB/s, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$upunitsN</code></td>
|
|
||||||
<td>Единицы скорости отдачи устройства N, <code>----</code>.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$netdev</code></td>
|
|
||||||
<td>Текущее устройство.</td>
|
|
||||||
<td>1.1.1</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="3">Батарея</th>
|
|
||||||
<td><code>$bat</code></td>
|
|
||||||
<td>Средний заряд батареи, %, <code>---</code>.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$batN</code></td>
|
|
||||||
<td>Заряд батареи N, %, <code>---</code>.</td>
|
|
||||||
<td>2.0.3</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$ac</code></td>
|
|
||||||
<td>Статус зарядного устройства. Возвращает <code>(*)</code>, если устройство подключено, или <code>( )</code>, если нет.</td>
|
|
||||||
<td></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="11">Музыкальный плеер</th>
|
|
||||||
<td><code>$album</code></td>
|
|
||||||
<td>Альбом текущей песни. Один из поддерживаемых музыкальных плееров должен быть установлен.</td>
|
|
||||||
<td>1.5.3</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$dalbum</code></td>
|
|
||||||
<td>Альбом текущей песни с фиксированным количеством символов, показывающийся, как бегущая строка.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$salbum</code></td>
|
|
||||||
<td>Альбом текущей песни с фиксированным количеством символов, показывающийся с многоточием на конце.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$artist</code></td>
|
|
||||||
<td>Исполнитель текущей песни. Один из поддерживаемых музыкальных плееров должен быть установлен.</td>
|
|
||||||
<td>1.5.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$dartist</code></td>
|
|
||||||
<td>Исполнитель текущей песни с фиксированным количеством символов, показывающийся, как бегущая строка.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$sartist</code></td>
|
|
||||||
<td>Исполнитель текущей песни с фиксированным количеством символов, показывающийся с многоточием на конце.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$duration</code></td>
|
|
||||||
<td>Длительность текущей песни. Один из поддерживаемых музыкальных плееров должен быть установлен.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$progress</code></td>
|
|
||||||
<td>Прогресс текущей песни. Один из поддерживаемых музыкальных плееров должен быть установлен.</td>
|
|
||||||
<td>1.5.3</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$title</code></td>
|
|
||||||
<td>Название текущей песни. Один из поддерживаемых музыкальных плееров должен быть установлен.</td>
|
|
||||||
<td>1.5.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$dtitle</code></td>
|
|
||||||
<td>Название текущей песни с фиксированным количеством символов, показывающийся, как бегущая строка.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$stitle</code></td>
|
|
||||||
<td>Название текущей песни с фиксированным количеством символов, показывающийся с многоточием на конце.</td>
|
|
||||||
<td>3.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="3">Процессы</th>
|
|
||||||
<td><code>$ps</code></td>
|
|
||||||
<td>Список запущенных процессов, разделенных запятой.</td>
|
|
||||||
<td>1.8.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$pscount</code></td>
|
|
||||||
<td>Число запущенных процессов.</td>
|
|
||||||
<td>1.8.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$pstotal</code></td>
|
|
||||||
<td>Общее число процессов.</td>
|
|
||||||
<td>1.8.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="1">Пакетный менеджер</th>
|
|
||||||
<td><code>$pkgcountN</code></td>
|
|
||||||
<td>Число пакетов, доступных для обновления, для команды N.</td>
|
|
||||||
<td>1.8.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="1">Своя команда</th>
|
|
||||||
<td><code>$customN</code></td>
|
|
||||||
<td>Получить данные из указанной команды N. Например, <code>$custom0</code>.</td>
|
|
||||||
<td>1.9.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="3">Рабочий стол</th>
|
|
||||||
<td><code>$desktop</code></td>
|
|
||||||
<td>Имя текущего рабочего стола.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$ndesktop</code></td>
|
|
||||||
<td>Номер текущего рабочего стола.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$tdesktops</code></td>
|
|
||||||
<td>Общее число рабочих столов.</td>
|
|
||||||
<td>2.0.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="9">Котировки</th>
|
|
||||||
<td><code>$askN</code></td>
|
|
||||||
<td>Получить аск по тикеру N. Например, <code>$ask0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$askchgN</code></td>
|
|
||||||
<td>Абсолютное изменение аск по тикеру N. Например, <code>$askchg0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$percaskchgN</code></td>
|
|
||||||
<td>Изменение аск по тикеру N, %. Например, <code>$percaskchg0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$bidN</code></td>
|
|
||||||
<td>Получить бид по тикеру N. Например, <code>$bid0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$bidchgN</code></td>
|
|
||||||
<td>Абсолютное изменение бид по тикеру N. Например, <code>$bidchg0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$percbidchgN</code></td>
|
|
||||||
<td>Изменение бид по тикеру N, %. Например, <code>$percbidchg0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$priceN</code></td>
|
|
||||||
<td>Получить цену по тикеру N. Например, <code>$price0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$pricechgN</code></td>
|
|
||||||
<td>Абсолютное изменение цены по тикеру N. Например, <code>$pricechg0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$percpricechgN</code></td>
|
|
||||||
<td>Изменение цены по тикеру N, %. Например, <code>$percpricechg0</code>.</td>
|
|
||||||
<td>2.2.2</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th rowspan="5">Погода</th>
|
|
||||||
<td><code>$weatherIdN</code></td>
|
|
||||||
<td>Численное ID погоды. Например <code>$weatherId0</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$weatherN</code></td>
|
|
||||||
<td>Статус погоды. Например <code>$weather0</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$humidityN</code></td>
|
|
||||||
<td>Влажность, %. Например <code>$humidity0</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$pressureN</code></td>
|
|
||||||
<td>Давление, бар. Например <code>$pressure0</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$temperatureN</code></td>
|
|
||||||
<td>Температура. Humidity <code>$temperature0</code>.</td>
|
|
||||||
<td>2.4.0</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
<h4><a href="#lambda" class="anchor" id="lambda"><span class="octicon octicon-link"></span></a>Лямбда функции</h4>
|
|
||||||
<p>Начиная с версии 3.0.0 основной виджет поддерживает лямбда выражения, которые рассчитываются в рантайме. Они объявляются использованием конструкции <code>${{ }}</code>:</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>покажет разность между скоростями загрузки и отдачи. Другая особенность, предоставляемая лямбда выражениями - тег <code>$this</code>, который вернет последнее значение данной лямбда функции. Ниже чуть более сложный пример, который покажет бегущую строку "Артист - Название" с длиной меньшей либо равной 10 символам:</p>
|
|
||||||
|
|
||||||
{% highlight javascript %}
|
|
||||||
{% raw %}${{{% endraw %}
|
|
||||||
function runningLine() {
|
|
||||||
var current = "$artist - $title";
|
|
||||||
var index = current.indexOf("$this");
|
|
||||||
if (("$this" == "") || ((index + 20 + 1) > current.length))
|
|
||||||
return current.substring(0, 20);
|
|
||||||
else
|
|
||||||
return current.substring(index + 1, index + 20 + 1);
|
|
||||||
}
|
|
||||||
runningLine()
|
|
||||||
{% 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>true</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Переводить строки:</b> Переводить или нет строковые теги. По умолчанию <code>true</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Заменить символ перевода строки:</b> Заменить <code>\n</code> на <code><br></code>. По умолчанию <code>false</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Перенос слов:</b> Включить перенос слов. По умолчанию <code>false</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Включить всплывающие сообщения:</b> Снимите галочку, если вы не хотите всплывающих сообщений на системные события. По умолчанию <code>true</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Проверять обновления:</b> Проверять или нет обновления при запуске. По умолчанию <code>true</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Высота виджета:</b> Отключит автоматическое определение высоты виджета и установит ее в данное значение. По умолчанию <code>0</code> (автоматически).</p>
|
|
||||||
|
|
||||||
<p><b>Ширина виджета:</b> Отключит автоматическое определение ширины виджета и установит ее в данное значение. По умолчанию <code>0</code> (автоматически).</p>
|
|
||||||
|
|
||||||
<p><b>Интервал обновления:</b> Интервал обновления виджета, мс. По умолчанию <code>1000</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Очередь сообщений:</b> Использовать указанное количество тредов в пуле. <code>0</code> означает идеальное количество тредов. По умолчанию <code>0</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Температурные единицы:</b> Выберете единицы температуры. Доступные единицы следующие: Цельсий, Фаренгейт и Кельвин.</p>
|
|
||||||
|
|
||||||
<p><b>Свой формат времени:</b></p>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<td><code>$dddd</code></td>
|
|
||||||
<td>Длинный день недели.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$ddd</code></td>
|
|
||||||
<td>Короткий день недели.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$dd</code></td>
|
|
||||||
<td>День.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$d</code></td>
|
|
||||||
<td>День без нуля.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$MMMM</code></td>
|
|
||||||
<td>Месяц в длинном формате.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$MMM</code></td>
|
|
||||||
<td>Месяц в коротком формате.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$MM</code></td>
|
|
||||||
<td>Месяц.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$M</code></td>
|
|
||||||
<td>Месяц без нуля.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$yyyy</code></td>
|
|
||||||
<td>Год.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$yy</code></td>
|
|
||||||
<td>Год в коротком формате.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hh</code></td>
|
|
||||||
<td>Часы.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<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>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$m</code></td>
|
|
||||||
<td>Минуты без нуля.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$ss</code></td>
|
|
||||||
<td>Секунды.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<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>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<td><code>$dd</code></td>
|
|
||||||
<td>Дни аптайма.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$d</code></td>
|
|
||||||
<td>Дни аптайма без нуля.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$hh</code></td>
|
|
||||||
<td>Часы аптайма.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$h</code></td>
|
|
||||||
<td>Часы аптайма без нуля.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$mm</code></td>
|
|
||||||
<td>Минуты аптайма.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$m</code></td>
|
|
||||||
<td>Минуты аптайма без нуля.</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
<p><b>AC online тег:</b> Строка, которая будет показана, когда AC онлайн. По умолчанию <code>(*)</code>.</p>
|
|
||||||
|
|
||||||
<p><b>AC offline тег:</b> Строка, которая будет показана, когда AC оффлайн. По умолчанию <code>( )</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>
|
|
||||||
|
|
||||||
<h4><a href="#deguiconf" class="anchor" id="deguiconf"><span class="octicon octicon-link"></span></a>Настройка DataEngine</h4>
|
|
||||||
<p><b>Устройства ACPI:</b> Путь к устройствам ACPI. По умолчанию <code>/sys/class/power_supply/</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Устройство GPU:</b> Выберете одно из поддерживаемых устройств GPU. <code>auto</code> включит автоматическое определение устройства, <code>disable</code> отключит все мониторы GPU. По умолчанию <code>auto</code>.</p>
|
|
||||||
|
|
||||||
<p><b>HDD:</b> Выберете один из HDD для монитора температуры HDD. <code>all</code> включит монитор для всех доступных устройств, <code>disable</code> отключит монитор температуры HDD. По умолчанию <code>all</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Команда hddtemp:</b> Введите команду, которая будет запущена для hddtemp DataEngine. По умолчанию <code>sudo hddtemp</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Количество символов для плеера:</b> Количество символов, которые будут показываться в динамических тегах плеера.</p>
|
|
||||||
|
|
||||||
<p><b>Музыкальный плеер:</b> Выберете один из поддерживаемых музыкальных плееров для соответствующего поля.</p>
|
|
||||||
|
|
||||||
<p><b>MPRIS:</b> Выберете имя плеера MPRIS. <code>auto</code> включит автоматическое определение плеера. По умолчанию <code>auto</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Адрес MPD:</b> Адрес MPD сервера. По умолчанию <code>localhost</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Порт MPD:</b> Порт MPD сервера. По умолчанию <code>6600</code>.</p>
|
|
||||||
|
|
||||||
<h3><a href="#desktoppanel" class="anchor" id="desktoppanel"><span class="octicon octicon-link"></span></a>Desktop panel</h3>
|
|
||||||
<p>Начиная с версии 1.11.0 виджеты предоставляют панель для мониторинга за рабочими столами. И да, он выглядит, как аналогичная панель в Awesome.</p>
|
|
||||||
|
|
||||||
<h4><a href="#dpconf" class="anchor" id="dpconf"><span class="octicon octicon-link"></span></a>Настройка Desktop panel</h4>
|
|
||||||
<p><b>Включить фон:</b> Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный. По умолчанию <code>true</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Вертикальная разметка:</b> Использовать вертикальную разметку вместо горизонтальной. По умолчанию <code>false</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Высота виджета:</b> Отключит автоматическое определение высоты виджета и установит ее в данное значение. По умолчанию <code>0</code> (автоматически).</p>
|
|
||||||
|
|
||||||
<p><b>Ширина виджета:</b> Отключит автоматическое определение ширины виджета и установит ее в данное значение. По умолчанию <code>0</code> (автоматически).</p>
|
|
||||||
|
|
||||||
<p><b>Метка</b> Введите символ (или строку), которая будет показана, если данный рабочий стол сейчас активен.</p>
|
|
||||||
|
|
||||||
<p><b>Тип тултипа:</b> Тип превью, по умолчанию <code>Окна</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Ширина тултипа:</b> Ширина тултипа в пикселях. По умолчанию <code>200px</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Цвет тултипа:</b> Цвет, который будет использован в некоторых типах тултипа. По умолчанию <code>#ffffff</code>.</p>
|
|
||||||
|
|
||||||
<p><b>Теги шаблона</b></p>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<td><code>$mark</code></td>
|
|
||||||
<td>Показать метку, если данный рабочий стол активен. Иначе показывает пробелы</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$name</code></td>
|
|
||||||
<td>Имя рабочего стола.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$number</code></td>
|
|
||||||
<td>Номер рабочего стола.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><code>$total</code></td>
|
|
||||||
<td>Общее число рабочих столов.</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
<!-- end of config block -->
|
|
||||||
|
|
||||||
<!-- gui block -->
|
|
||||||
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс</h2>
|
|
||||||
|
|
||||||
<h2><a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Скриншоты</h2>
|
|
||||||
<div class="thumbnails">
|
|
||||||
{% assign scrdesc = "Виджет (кликабельно)" %}
|
|
||||||
{% assign scrname = "awesomewidgets_widget" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно настроек" %}
|
|
||||||
{% assign scrname = "awesomewidgets_config_01" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно настроек" %}
|
|
||||||
{% assign scrname = "awesomewidgets_config_02" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно настроек" %}
|
|
||||||
{% assign scrname = "awesomewidgets_config_03" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно настроек" %}
|
|
||||||
{% assign scrname = "awesomewidgets_config_04" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно настроек" %}
|
|
||||||
{% assign scrname = "awesomewidgets_config_05" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Тултипы" %}
|
|
||||||
{% assign scrname = "awesomewidgets_tooltips" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
</div>
|
|
||||||
421
ru/projects/awesome-widgets.md
Normal file
421
ru/projects/awesome-widgets.md
Normal file
@ -0,0 +1,421 @@
|
|||||||
|
---
|
||||||
|
category: ru
|
||||||
|
hastr: true
|
||||||
|
layout: project
|
||||||
|
title: Awesome Widgets
|
||||||
|
short: awesome-widgets
|
||||||
|
tags: python, kde, qt, linux, система, awesome
|
||||||
|
hasgui: true
|
||||||
|
hasdocs: false
|
||||||
|
developers:
|
||||||
|
- Evgeniy Alekseev
|
||||||
|
- Ernesto Avilés Vzqz (перевод на испанский)
|
||||||
|
- Mermouy (перевод на французский)
|
||||||
|
- underr (перевод на бразильский португальский)
|
||||||
|
- Виктор Слободян (перевод на украинский)
|
||||||
|
- Lemueler (перевод на китайский)
|
||||||
|
- Heimen Stoffels (перевод на голландский)
|
||||||
|
license: GPLv3
|
||||||
|
links:
|
||||||
|
- Страница плазмоида на <a href="//kde-look.org/content/show.php/Awesome+Widgets?content=157124" title="kde-look">kde-look.org</a>
|
||||||
|
- Страница DataEngine на <a href="//kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773" title="kde-look">kde-look.org</a>
|
||||||
|
- Пакет в <a href="//aur.archlinux.org/packages/kdeplasma-applets-awesome-widgets" title="AUR">AUR</a>
|
||||||
|
- Пакет для <a href="//software.opensuse.org/package/plasma5-awesome-widgets" title="openSUSE">openSUSE</a> (спасибо Kott)
|
||||||
|
- Пакеты для <a href="//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>
|
||||||
|
---
|
||||||
|
<!-- info block -->
|
||||||
|
## <a href="#information" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация
|
||||||
|
|
||||||
|
Набор минималистичных легко настраиваемых пламоидов, написанных на `C++/Qt`. Они выглядят, как виджеты в [Awesome WM](//awesome.naquadah.org/ "Домашняя страница Awesome"). Также пакет предоставляет дополнительный системный [DataEngine](//techbase.kde.org/Development/Tutorials/Plasma/DataEngines "Мануал для разработчиков").
|
||||||
|
|
||||||
|
**ВНИМАНИЕ:** [НУЖНЫ ПЕРЕВОДЧИКИ!](//github.com/arcan1s/awesome-widgets/issues/14 "Тикет")
|
||||||
|
|
||||||
|
**Совместим с Plasma 5!**
|
||||||
|
|
||||||
|
### <a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики
|
||||||
|
|
||||||
|
{% for devel in page.developers %}
|
||||||
|
* {{ devel }}{% endfor %}
|
||||||
|
|
||||||
|
### <a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия
|
||||||
|
|
||||||
|
* {{ page.license }}
|
||||||
|
|
||||||
|
### <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")
|
||||||
|
|
||||||
|
<!-- end of info block -->
|
||||||
|
|
||||||
|
<!-- install block -->
|
||||||
|
## <a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка
|
||||||
|
|
||||||
|
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция
|
||||||
|
|
||||||
|
* Скачайте [архив](//github.com/arcan1s/awesome-widgets/releases "GitHub") с актуальной версией исходных файлов.
|
||||||
|
* Извлеките из него файлы и установите:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /путь/к/извлеченным/файлам/
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr ../
|
||||||
|
make
|
||||||
|
sudo make install
|
||||||
|
```
|
||||||
|
|
||||||
|
**ВНИМАНИЕ:** Для Plasma 5, вероятно, потребуется флаг `-DKDE_INSTALL_USE_QT_SYS_PATHS=ON`
|
||||||
|
|
||||||
|
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости
|
||||||
|
|
||||||
|
Все было протестировано на последних версиях зависимостей.
|
||||||
|
|
||||||
|
* plasma-framework
|
||||||
|
* cmake *(make)*
|
||||||
|
* extra-cmake-modules *(make)*
|
||||||
|
* hddtemp **или** smartmontools *(опционально, для контроля за температурой HDD)*
|
||||||
|
* один из поддерживаемых музыкальных плееров *(опционально, для контроля за музыкальным плеером)*
|
||||||
|
* проприетарный видеодрайвер *(опционально, для контроля за GPU)*
|
||||||
|
|
||||||
|
<!-- end of install block -->
|
||||||
|
|
||||||
|
<!-- howto block -->
|
||||||
|
## <a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование
|
||||||
|
|
||||||
|
Откройте список виджетов Plasma и выберете `Awesome Widget`.
|
||||||
|
|
||||||
|
### <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") для более подробной информации.
|
||||||
|
|
||||||
|
<!-- end of howto block -->
|
||||||
|
|
||||||
|
<!-- config block -->
|
||||||
|
## <a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка
|
||||||
|
|
||||||
|
### <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`. Раскомментируйте необходимые строчки и отредактируйте их.
|
||||||
|
|
||||||
|
### <a href="#deoptions" class="anchor" id="deoptions"><span class="octicon octicon-link"></span></a>Опции DataEngine
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|----------|----------|
|
||||||
|
| ACPIPATH | Путь к устройствам ACPI. По умолчанию `/sys/class/power_supply/`. |
|
||||||
|
| GPUDEV | Устанавливает тип GPU. Может быть `nvidia` (для nVidia), `ati` (для ATI Radeon), `disable` или `auto`. По умолчанию `auto`. |
|
||||||
|
| HDDDEV | Устанавливает блочное устройство для `hddtemp` через запятую или `all` для всех возможных. `disable` отключит монитор температуры HDD. По умолчанию `all`. |
|
||||||
|
| HDDTEMPCMD | Команда, которая будет запущена для hddtemp. По умолчанию `sudo smartctl -a`. Поддерживаемые приложения - `hddtemp` и `smartmontools`. |
|
||||||
|
| MPDADDRESS | Адрес MPD хоста. По умолчанию `localhost`. |
|
||||||
|
| MPDPORT | Адрес MPD хоста. По умолчанию `6600`. |
|
||||||
|
| PLAYER | Устанавливает музыкальный плеер. Поддерживаемые плееры: mpd и с поддержкой MPRIS/DBus. `disable` отключит данный монитор. |
|
||||||
|
| PLAYERSYMBOLS | Количество символов в динамических тегах монитора за плеером. По умолчанию `10`. |
|
||||||
|
|
||||||
|
### <a href="#widconf" class="anchor" id="widconf"><span class="octicon octicon-link"></span></a>Настройка виджета
|
||||||
|
|
||||||
|
Для настройки внешнего вида Вы должны открыть окно настроек и установить требуемый формат текста. HTML теги обрабатываются корректно.
|
||||||
|
|
||||||
|
Доступные флаги приведены в таблице ниже.
|
||||||
|
|
||||||
|
**ЗАМЕЧАНИЕ** Нумерация всех массивов в переменных начинается с 0.
|
||||||
|
|
||||||
|
| Тег | Описание | Введен |
|
||||||
|
|-----|----------|--------|
|
||||||
|
| `$time` | Время в стандартном формате. Например, `fri Nov 6 04:48:01 2013`. | 1.5.1 |
|
||||||
|
| `$isotime` | Время в формате ISO. | 1.5.2 |
|
||||||
|
| `$shorttime` | Время в коротком формате локали. | 1.5.2 |
|
||||||
|
| `$longtime` | Время в длинном формате локали. | 1.5.2 |
|
||||||
|
| `$ctime` | Специальный формат времени. | 2.0.0 |
|
||||||
|
| `$uptime` | Системный аптайм, `---d--h--m`. |
|
||||||
|
| `$cuptime` | Специальный формат аптайма. | 2.0.0 |
|
||||||
|
| `$la1` | Средняя загрузка за 1 минуту, `-----`. | 2.4.0 |
|
||||||
|
| `$la5` | Средняя загрузка за 5 минут, `-----`. | 2.4.0 |
|
||||||
|
| `$la15` | Средняя загрузка за 15 минут, `-----`. | 2.4.0 |
|
||||||
|
| `$cpu` | Полная загрузка CPU, %, `-----`. |
|
||||||
|
| `$cpuN` | Загрузка CPU для ядра N, %, `-----`. | 1.7.0 |
|
||||||
|
| `$cpucl` | Средняя частота CPU, МГц, `----`. | 1.1.2 |
|
||||||
|
| `$cpuclN` | Частота CPU для ядра N, МГц, `----`. | 1.7.0 |
|
||||||
|
| `$tempN` | Температура для датчика N, `----`. Пример: `$temp0` |
|
||||||
|
| `$gpu` | Использование GPU, %, `-----`. `aticonfig` или `nvidia-smi` должны быть установлены. | 1.3.2 |
|
||||||
|
| `$gputemp` | Температура GPU, `----`. `aticonfig` или `nvidia-smi` должны быть установлены. | 1.3.2 |
|
||||||
|
| `$mem` | Использование RAM, %, `-----`. |
|
||||||
|
| `$memmb` | Использование RAM, MB, `-----`. | 1.1.1 |
|
||||||
|
| `$memgb` | Использование RAM, GB, `----`. | 1.7.3 |
|
||||||
|
| `$memfreemb` | Свободная RAM, MB, `-----`. | 2.0.0 |
|
||||||
|
| `$memfreegb` | Свободная RAM, GB, `----`. | 2.0.0 |
|
||||||
|
| `$memtotmb` | RAM, MB, `-----`. | 1.10.0 |
|
||||||
|
| `$memtotgb` | RAM, GB, `----`. | 1.10.0 |
|
||||||
|
| `$memusedmb` | Занятая и кэшированная RAM, MB, `-----`. | 2.0.0 |
|
||||||
|
| `$memusedgb` | Занятая и кэшированная RAM, GB, `----`. | 2.0.0 |
|
||||||
|
| `$swap` | Использование swap, %, `-----`. |
|
||||||
|
| `$swapmb` | Использование swap, MB, `-----`. | 1.1.1 |
|
||||||
|
| `$swapgb` | Использование swap, GB, `----`. | 1.7.3 |
|
||||||
|
| `$swapfreemb` | Свободный swap, MB, `-----`. | 2.0.0 |
|
||||||
|
| `$swapfreegb` | Свободный swap, GB, `----`. | 2.0.0 |
|
||||||
|
| `$swaptotmb` | swap, MB, `-----`. | 1.10.0 |
|
||||||
|
| `$swaptotgb` | swap, GB, `----`. | 1.10.0 |
|
||||||
|
| `$hddN` | Занятость точки монтирования N, %, `-----`. Пример: `$hdd0`. | 1.3.2 |
|
||||||
|
| `$hddmbN` | Занятость точки монтирования N, MB, `-----`. Пример: `$hddmb0`. | 1.8.0 |
|
||||||
|
| `$hddgbN` | Занятость точки монтирования N, GB, `-----`. Пример: `$hddgb0`. | 1.8.0 |
|
||||||
|
| `$hddfreembN` | Свободное место точки монтирования N, MB, `-----`. Пример: `$hddfreemb0`. | 2.0.0 |
|
||||||
|
| `$hddfreegbN` | Свободное место точки монтирования N, GB, `-----`. Пример: `$hddfreegb0`. | 2.0.0 |
|
||||||
|
| `$hddtotmbN` | Размер точки монтирования N, MB, `-----`. Пример: `$hddtotmb0`. | 1.10.0 |
|
||||||
|
| `$hddtotgbN` | Размер точки монтирования N, GB, `-----`. Пример: `$hddtotgb0`. | 1.10.0 |
|
||||||
|
| `$hddrN` | Скорость записи диска N, KB/s, `-----`. Пример: `$hddr0`. | 1.9.0 |
|
||||||
|
| `$hddwN` | Скорость чтения диска N, KB/s, `-----`. Пример: `$hddw0`. | 1.9.0 |
|
||||||
|
| `$hddtempN` | Температура HDD с номером N, `----`. Пример `$hddtemp0`. `hddtemp` или `smartmontools` должен быть установлен. | 1.7.0 |
|
||||||
|
| `$down` | Скорость загрузки активного устройства, KB/s или MB/s, `----`. | 1.7.0 |
|
||||||
|
| `$downkb` | Скорость загрузки активного устройства, KB/s, `----`. | 3.0.0 |
|
||||||
|
| `$downunits` | Единицы скорости загрузки активного устройства, `----`. | 3.0.0 |
|
||||||
|
| `$downN` | Скорость загрузки устройства N, KB/s или MB/s, `----`. | 2.2.0 |
|
||||||
|
| `$downkbN` | Скорость загрузки устройства N, KB/s, `----`. | 3.0.0 |
|
||||||
|
| `$downunitsN` | Единицы cкорости загрузки устройства N, `----`. | 3.0.0 |
|
||||||
|
| `$up` | Скорость отдачи активного устройства, KB/s или MB/s, `----`. | 1.7.0 |
|
||||||
|
| `$upkb` | Скорость отдачи активного устройства, KB/s, `----`. | 3.0.0 |
|
||||||
|
| `$upunits` | Единицы скорости отдачи активного устройства, `----`. | 3.0.0 |
|
||||||
|
| `$upN` | Скорость отдачи устройства N, KB/s или MB/s, `----`. | 2.2.0 |
|
||||||
|
| `$upkbN` | Скорость отдачи устройства N, KB/s, `----`. | 3.0.0 |
|
||||||
|
| `$upunitsN` | Единицы скорости отдачи устройства N, `----`. | 3.0.0 |
|
||||||
|
| `$netdev` | Текущее устройство. | 1.1.1 |
|
||||||
|
| `$bat` | Средний заряд батареи, %, `---`. |
|
||||||
|
| `$batN` | Заряд батареи N, %, `---`. | 2.0.3 |
|
||||||
|
| `$ac` | Статус зарядного устройства. Возвращает `(*)`, если устройство подключено, или `( )`, если нет. |
|
||||||
|
| `$album` | Альбом текущей песни. Один из поддерживаемых музыкальных плееров должен быть установлен. | 1.5.3 |
|
||||||
|
| `$dalbum` | Альбом текущей песни с фиксированным количеством символов, показывающийся, как бегущая строка. | 3.0.0 |
|
||||||
|
| `$salbum` | Альбом текущей песни с фиксированным количеством символов, показывающийся с многоточием на конце. | 3.0.0 |
|
||||||
|
| `$artist` | Исполнитель текущей песни. Один из поддерживаемых музыкальных плееров должен быть установлен. | 1.5.0 |
|
||||||
|
| `$dartist` | Исполнитель текущей песни с фиксированным количеством символов, показывающийся, как бегущая строка. | 3.0.0 |
|
||||||
|
| `$sartist` | Исполнитель текущей песни с фиксированным количеством символов, показывающийся с многоточием на конце. | 3.0.0 |
|
||||||
|
| `$duration` | Длительность текущей песни. Один из поддерживаемых музыкальных плееров должен быть установлен. | 2.0.0 |
|
||||||
|
| `$progress` | Прогресс текущей песни. Один из поддерживаемых музыкальных плееров должен быть установлен. | 1.5.3 |
|
||||||
|
| `$title` | Название текущей песни. Один из поддерживаемых музыкальных плееров должен быть установлен. | 1.5.0 |
|
||||||
|
| `$dtitle` | Название текущей песни с фиксированным количеством символов, показывающийся, как бегущая строка. | 3.0.0 |
|
||||||
|
| `$stitle` | Название текущей песни с фиксированным количеством символов, показывающийся с многоточием на конце. | 3.0.0 |
|
||||||
|
| `$ps` | Список запущенных процессов, разделенных запятой. | 1.8.0 |
|
||||||
|
| `$pscount` | Число запущенных процессов. | 1.8.0 |
|
||||||
|
| `$pstotal` | Общее число процессов. | 1.8.0 |
|
||||||
|
| `$pkgcountN` | Число пакетов, доступных для обновления, для команды N. | 1.8.0 |
|
||||||
|
| `$customN` | Получить данные из указанной команды N. Например, `$custom0`. | 1.9.0 |
|
||||||
|
| `$desktop` | Имя текущего рабочего стола. | 2.0.0 |
|
||||||
|
| `$ndesktop` | Номер текущего рабочего стола. | 2.0.0 |
|
||||||
|
| `$tdesktops` | Общее число рабочих столов. | 2.0.0 |
|
||||||
|
| `$askN` | Получить аск по тикеру N. Например, `$ask0`. | 2.2.2 |
|
||||||
|
| `$askchgN` | Абсолютное изменение аск по тикеру N. Например, `$askchg0`. | 2.2.2 |
|
||||||
|
| `$percaskchgN` | Изменение аск по тикеру N, %. Например, `$percaskchg0`. | 2.2.2 |
|
||||||
|
| `$bidN` | Получить бид по тикеру N. Например, `$bid0`. | 2.2.2 |
|
||||||
|
| `$bidchgN` | Абсолютное изменение бид по тикеру N. Например, `$bidchg0`. | 2.2.2 |
|
||||||
|
| `$percbidchgN` | Изменение бид по тикеру N, %. Например, `$percbidchg0`. | 2.2.2 |
|
||||||
|
| `$priceN` | Получить цену по тикеру N. Например, `$price0`. | 2.2.2 |
|
||||||
|
| `$pricechgN` | Абсолютное изменение цены по тикеру N. Например, `$pricechg0`. | 2.2.2 |
|
||||||
|
| `$percpricechgN` | Изменение цены по тикеру N, %. Например, `$percpricechg0`. | 2.2.2 |
|
||||||
|
| `$weatherIdN` | Численное ID погоды. Например `$weatherId0`. | 2.4.0 |
|
||||||
|
| `$weatherN` | Статус погоды. Например `$weather0`. | 2.4.0 |
|
||||||
|
| `$humidityN` | Влажность, %. Например `$humidity0`. | 2.4.0 |
|
||||||
|
| `$pressureN` | Давление, бар. Например `$pressure0`. | 2.4.0 |
|
||||||
|
| `$temperatureN` | Температура. Humidity `$temperature0`. | 2.4.0 |
|
||||||
|
|
||||||
|
### <a href="#lambda" class="anchor" id="lambda"><span class="octicon octicon-link"></span></a>Лямбда функции
|
||||||
|
|
||||||
|
Начиная с версии 3.0.0 основной виджет поддерживает лямбда выражения, которые рассчитываются в рантайме. Они объявляются использованием конструкции `${% raw %}${{{% endraw %} {% raw %}}}{% endraw %}`:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
{% raw %}${{{% endraw %}
|
||||||
|
function three()
|
||||||
|
{
|
||||||
|
return 1 + 2;
|
||||||
|
}
|
||||||
|
three()
|
||||||
|
{% raw %}}}{% endraw %}
|
||||||
|
```
|
||||||
|
|
||||||
|
Функции внутри будут интерпретированы, как JavaScript, любая переменная из основного набора поддерживается. Так, функция:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
{% raw %}${{{% endraw %}
|
||||||
|
function colorCpu()
|
||||||
|
{
|
||||||
|
if ($cpu > 90.0)
|
||||||
|
return "<span style=\"color:#ff0000;\">$cpu</span>"
|
||||||
|
else
|
||||||
|
return "$cpu"
|
||||||
|
}
|
||||||
|
colorCpu()
|
||||||
|
{% raw %}}}{% endraw %}
|
||||||
|
```
|
||||||
|
|
||||||
|
покажет значение `$cpu` красным, если оно больше 90.0, иначе - покажет цветом по-умолчанию. Также поддерживаются произвольные вычисления:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
{% raw %}${{{% endraw %}
|
||||||
|
$down - $up
|
||||||
|
{% raw %}}}{% endraw %}
|
||||||
|
```
|
||||||
|
|
||||||
|
покажет разность между скоростями загрузки и отдачи. Другая особенность, предоставляемая лямбда выражениями - тег `$this`, который вернет последнее значение данной лямбда функции. Ниже чуть более сложный пример, который покажет бегущую строку "Артист - Название" с длиной меньшей либо равной 10 символам:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
{% raw %}${{{% endraw %}
|
||||||
|
function runningLine() {
|
||||||
|
var current = "$artist - $title";
|
||||||
|
var index = current.indexOf("$this");
|
||||||
|
if (("$this" == "") || ((index + 20 + 1) > current.length))
|
||||||
|
return current.substring(0, 20);
|
||||||
|
else
|
||||||
|
return current.substring(index + 1, index + 20 + 1);
|
||||||
|
}
|
||||||
|
runningLine()
|
||||||
|
{% raw %}}}{% endraw %}
|
||||||
|
```
|
||||||
|
|
||||||
|
Таким образом, лямбда выражения могут быть использованы, например, чтобы показывать произвольное значение, которое будет рассчитано в рантайме, или, чтобы показать различную информацию, в зависимости от некоторых условий. Однако, пожалуйста, учитывайте, что подобные вычисления в рантайме могут увеличить нагрузку на CPU.
|
||||||
|
|
||||||
|
### <a href="#advanced" class="anchor" id="advanced"><span class="octicon octicon-link"></span></a>Расширенные настройки
|
||||||
|
|
||||||
|
**Включить фон:** Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный. По умолчанию `true`.
|
||||||
|
|
||||||
|
**Переводить строки:** Переводить или нет строковые теги. По умолчанию `true`.
|
||||||
|
|
||||||
|
**Заменить символ перевода строки:** Заменить `\n` на `<br>`. По умолчанию `false`.
|
||||||
|
|
||||||
|
**Перенос слов:** Включить перенос слов. По умолчанию `false`.
|
||||||
|
|
||||||
|
**Включить всплывающие сообщения:** Снимите галочку, если вы не хотите всплывающих сообщений на системные события. По умолчанию `true`.
|
||||||
|
|
||||||
|
**Проверять обновления:** Проверять или нет обновления при запуске. По умолчанию `true`.
|
||||||
|
|
||||||
|
**Высота виджета:** Отключит автоматическое определение высоты виджета и установит ее в данное значение. По умолчанию `0` (автоматически).
|
||||||
|
|
||||||
|
**Ширина виджета:** Отключит автоматическое определение ширины виджета и установит ее в данное значение. По умолчанию `0` (автоматически).
|
||||||
|
|
||||||
|
**Интервал обновления:** Интервал обновления виджета, мс. По умолчанию `1000`.
|
||||||
|
|
||||||
|
**Очередь сообщений:** Использовать указанное количество тредов в пуле. `0` означает идеальное количество тредов. По умолчанию `0`.
|
||||||
|
|
||||||
|
**Температурные единицы:** Выберете единицы температуры. Доступные единицы следующие: Цельсий, Фаренгейт и Кельвин.
|
||||||
|
|
||||||
|
**Свой формат времени:**
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|---------|---------|
|
||||||
|
| `$dddd` | Длинный день недели. |
|
||||||
|
| `$ddd` | Короткий день недели. |
|
||||||
|
| `$dd` | День. |
|
||||||
|
| `$d` | День без нуля. |
|
||||||
|
| `$MMMM` | Месяц в длинном формате. |
|
||||||
|
| `$MMM` | Месяц в коротком формате. |
|
||||||
|
| `$MM` | Месяц. |
|
||||||
|
| `$M` | Месяц без нуля. |
|
||||||
|
| `$yyyy` | Год. |
|
||||||
|
| `$yy` | Год в коротком формате. |
|
||||||
|
| `$hh` | Часы. |
|
||||||
|
| `$h` | Часы без нуля. |
|
||||||
|
| `$HH` | Часы в 24-часовом формате. |
|
||||||
|
| `$H` | Часы в 24-часовом формате без нуля. |
|
||||||
|
| `$mm` | Минуты. |
|
||||||
|
| `$m` | Минуты без нуля. |
|
||||||
|
| `$ss` | Секунды. |
|
||||||
|
| `$s` | Секунды без нуля. |
|
||||||
|
| `$t` | Временная зона. |
|
||||||
|
| `$a`/`$ap` | am или pm. |
|
||||||
|
| `$A`/`$AP` | AM или PM. |
|
||||||
|
|
||||||
|
**Свой формат времени работы:**
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|-------|-------|
|
||||||
|
| `$dd` | Дни аптайма. |
|
||||||
|
| `$d` | Дни аптайма без нуля. |
|
||||||
|
| `$hh` | Часы аптайма. |
|
||||||
|
| `$h` | Часы аптайма без нуля. |
|
||||||
|
| `$mm` | Минуты аптайма. |
|
||||||
|
| `$m` | Минуты аптайма без нуля. |
|
||||||
|
|
||||||
|
**AC online тег:** Строка, которая будет показана, когда AC онлайн. По умолчанию `(*)`.
|
||||||
|
|
||||||
|
**AC offline тег:** Строка, которая будет показана, когда AC оффлайн. По умолчанию `( )`.
|
||||||
|
|
||||||
|
### <a href="#tooltips" class="anchor" id="tooltips"><span class="octicon octicon-link"></span></a>Тултипы
|
||||||
|
|
||||||
|
Начиная с версии 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`.
|
||||||
|
|
||||||
|
**HDD:** Выберете один из HDD для монитора температуры HDD. `all` включит монитор для всех доступных устройств, `disable` отключит монитор температуры HDD. По умолчанию `all`.
|
||||||
|
|
||||||
|
**Команда hddtemp:** Введите команду, которая будет запущена для hddtemp DataEngine. По умолчанию `sudo hddtemp`.
|
||||||
|
|
||||||
|
**Количество символов для плеера:** Количество символов, которые будут показываться в динамических тегах плеера.
|
||||||
|
|
||||||
|
**Музыкальный плеер:** Выберете один из поддерживаемых музыкальных плееров для соответствующего поля.
|
||||||
|
|
||||||
|
**MPRIS:** Выберете имя плеера MPRIS. `auto` включит автоматическое определение плеера. По умолчанию `auto`.
|
||||||
|
|
||||||
|
**Адрес MPD:** Адрес MPD сервера. По умолчанию `localhost`.
|
||||||
|
|
||||||
|
**Порт MPD:** Порт MPD сервера. По умолчанию `6600`.
|
||||||
|
|
||||||
|
### <a href="#desktoppanel" class="anchor" id="desktoppanel"><span class="octicon octicon-link"></span></a>Desktop panel
|
||||||
|
|
||||||
|
Начиная с версии 1.11.0 виджеты предоставляют панель для мониторинга за рабочими столами. И да, он выглядит, как аналогичная панель в Awesome.
|
||||||
|
|
||||||
|
### <a href="#dpconf" class="anchor" id="dpconf"><span class="octicon octicon-link"></span></a>Настройка Desktop panel
|
||||||
|
|
||||||
|
**Включить фон:** Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный. По умолчанию `true`.
|
||||||
|
|
||||||
|
**Вертикальная разметка:** Использовать вертикальную разметку вместо горизонтальной. По умолчанию `false`.
|
||||||
|
|
||||||
|
**Высота виджета:** Отключит автоматическое определение высоты виджета и установит ее в данное значение. По умолчанию `0` (автоматически).
|
||||||
|
|
||||||
|
**Ширина виджета:** Отключит автоматическое определение ширины виджета и установит ее в данное значение. По умолчанию `0` (автоматически).
|
||||||
|
|
||||||
|
**Метка** Введите символ (или строку), которая будет показана, если данный рабочий стол сейчас активен.
|
||||||
|
|
||||||
|
**Тип тултипа:** Тип превью, по умолчанию `Окна`.
|
||||||
|
|
||||||
|
**Ширина тултипа:** Ширина тултипа в пикселях. По умолчанию `200px`.
|
||||||
|
|
||||||
|
**Цвет тултипа:** Цвет, который будет использован в некоторых типах тултипа. По умолчанию `#ffffff`.
|
||||||
|
|
||||||
|
**Теги шаблона**
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|---------|---------|
|
||||||
|
| `$mark` | Показать метку, если данный рабочий стол активен. Иначе показывает пробелы |
|
||||||
|
| `$name` | Имя рабочего стола. |
|
||||||
|
| `$number` | Номер рабочего стола. |
|
||||||
|
| `$total` | Общее число рабочих столов. |
|
||||||
|
|
||||||
|
<!-- end of config block -->
|
||||||
|
|
||||||
|
<!-- gui block -->
|
||||||
|
## <a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс
|
||||||
|
|
||||||
|
## <a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Скриншоты
|
||||||
|
|
||||||
|
<div class="thumbnails">
|
||||||
|
{% assign scrdesc = "Виджет (кликабельно)" %}
|
||||||
|
{% assign scrname = "awesomewidgets_widget" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно настроек" %}
|
||||||
|
{% assign scrname = "awesomewidgets_config_01" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно настроек" %}
|
||||||
|
{% assign scrname = "awesomewidgets_config_02" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно настроек" %}
|
||||||
|
{% assign scrname = "awesomewidgets_config_03" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно настроек" %}
|
||||||
|
{% assign scrname = "awesomewidgets_config_04" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно настроек" %}
|
||||||
|
{% assign scrname = "awesomewidgets_config_05" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Тултипы" %}
|
||||||
|
{% assign scrname = "awesomewidgets_tooltips" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
</div>
|
||||||
@ -1,188 +0,0 @@
|
|||||||
---
|
|
||||||
category: ru
|
|
||||||
hastr: true
|
|
||||||
layout: project
|
|
||||||
title: git-etc
|
|
||||||
short: git-etc
|
|
||||||
tags: git, python, qt, linux, system, демон
|
|
||||||
hasgui: true
|
|
||||||
hasdocs: false
|
|
||||||
developers:
|
|
||||||
- Evgeniy Alekseev
|
|
||||||
license: GPLv3
|
|
||||||
links:
|
|
||||||
- Пакет в <a href="//aur.archlinux.org/packages/git-etc" title="AUR">AUR</a>
|
|
||||||
---
|
|
||||||
<!-- info block -->
|
|
||||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
|
||||||
<p>Простой демон, который создает git репозиторий в указанной директории и создает коммит в указанный промежуток времени.</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
$ git-etc --help
|
|
||||||
Simple daemon written on BASH for monitoring changes in files
|
|
||||||
|
|
||||||
Usage: git-etc [ -c | --config /etc/git-etc.conf ] [ -h | --help ] [ -v | --version ]
|
|
||||||
|
|
||||||
Parametrs:
|
|
||||||
-c --config - path to configuration file
|
|
||||||
-h --help - show this help and exit
|
|
||||||
-v --version - show version and exit
|
|
||||||
|
|
||||||
See "man 1 git-etc" for more details
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
$ ctrlconf --help
|
|
||||||
GUI for git-etc daemon
|
|
||||||
|
|
||||||
Usage: ctrlconf [ --default ] [ -h | --help ] [ -v | --version ]
|
|
||||||
|
|
||||||
Additional parametrs:
|
|
||||||
--default - create default configuration file
|
|
||||||
-h --help - show this help and exit
|
|
||||||
-v --version - show version and exit
|
|
||||||
|
|
||||||
See "man 1 ctrlconf" for more details
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
|
||||||
<ul>
|
|
||||||
{% for devel in page.developers %}
|
|
||||||
<li>{{ devel }}</li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
|
||||||
<ul>
|
|
||||||
<li>{{ page.license }}</li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of info block -->
|
|
||||||
|
|
||||||
<!-- install block -->
|
|
||||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
|
||||||
|
|
||||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
|
||||||
<ul>
|
|
||||||
<li>Скачайте <a href="//github.com/arcan1s/git-etc/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</li>
|
|
||||||
<li>Извлеките из него файлы и установите приложение:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
./install.sh "/путь/к/корню/"
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
Если Вы хотите установить в <code>/</code>, Вы должны запустить это, как root:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
sudo ./install.sh
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
Если путь не указан, пакет будет установлен в <code>/</code>.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
|
||||||
<p>Все было протестировано на последних версиях зависимостей.</p>
|
|
||||||
<ul>
|
|
||||||
<li>Bash (включая awk, grep, sed)</li>
|
|
||||||
<li>git</li>
|
|
||||||
<li>python2 <i>(make)</i></li>
|
|
||||||
<li>systemd <i>(опционально, service-файл)</i></li>
|
|
||||||
<li>python2-pyqt4 <i>(опционально, GUI)</i></li>
|
|
||||||
<li>xterm <i>(опционально, GUI)</i></li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of install block -->
|
|
||||||
|
|
||||||
<!-- howto block -->
|
|
||||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
|
||||||
<p>Если Вы хотите запустить демон в <code>/etc</code>, просто запустите</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
systemctl start git-etc
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>Если Вы хотите включить автозагрузку демона, запутите</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
systemctl enable git-etc
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>Но Вы можете изменить путь к конфигурационному файлу или изменить параметры. Для этого, скопируйте (рекомендуется) исходный конфигурационный файл</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cp /etc/git-etc.conf /новый/путь/к/git-etc.conf
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>и отредактируйте его. Затем скопируйте исходный service-файл в <code>/etc</code>:</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cp /usr/lib/systemd/system/git-etc.service /etc/systemd/system/git-etc-my-profile.service
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>Замените следующую строку в этом файле:</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
ExecStart=/usr/bin/git-etc -c /etc/git-etc.conf
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>на</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
ExecStart=/usr/bin/git-etc -c /новый/путь/к/git-etc.conf
|
|
||||||
{% endhighlight %}
|
|
||||||
<!-- end of howto block -->
|
|
||||||
|
|
||||||
<!-- config block -->
|
|
||||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
|
||||||
<p>Все настройки хранятся в <code>/etc/git-etc.conf</code>. После редактирования, Вы должны перезапустить демон</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
systemctl restart git-etc
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<h3><a href="#options" class="anchor" id="options"><span class="octicon octicon-link"></span></a>Опции</h3>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<th>DIRECTORY</th>
|
|
||||||
<td>Полный путь к рабочей директории с наблюдаемыми файлами. По умолчанию <code>/etc</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>TIMESLEEP</th>
|
|
||||||
<td>Промежуток времени между обновлениями, часы. Должно быть целым и >= 1. По умолчанию <code>12</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>IGNORELIST</th>
|
|
||||||
<td>Список файлов, которые не будут наблюдаться. Разделитель ";;". Может быть пустым.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>FORALL</th>
|
|
||||||
<td><code>1</code> включит доступ для обычного пользователя. По умолчанию <code>1</code>.</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
<!-- end of config block -->
|
|
||||||
|
|
||||||
<!-- gui block -->
|
|
||||||
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс</h2>
|
|
||||||
<p>Control Config (<code>ctrlconf</code>) - графический интерфейс для <code>git-etc</code>, написанный на <code>Python2/PyQt4</code>. Данное приложение позволяет Вам увидеть список коммитов и изменения в файлах в данных коммитах. Также данное приложение позволит Вам откатиться на указанный коммит (все файлы, посредством <code>git reset --hard</code>, или только указанный, посредством <code>git diff && git apply</code>). Также Вы можете объединить старый и новый конфигурационные файлы (используются две
|
|
||||||
ветки репозитория master и experimental). Приложение может потребовать привелегии root, убедитесь, что пакет <code>sudo</code> установлен.</p>
|
|
||||||
|
|
||||||
<h3><a href="#gui_configuration" class="anchor" id="gui_configuration"><span class="octicon octicon-link"></span></a>Настройка</h3>
|
|
||||||
<p>Запустите приложение и откройте окно настроек из меню.</p>
|
|
||||||
|
|
||||||
<h3><a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Скриншоты</h3>
|
|
||||||
<div class="thumbnails">
|
|
||||||
{% assign scrdesc = "Основное окно" %}
|
|
||||||
{% assign scrname = "git-etc_mainwindow" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно 'О программе'" %}
|
|
||||||
{% assign scrname = "git-etc_aboutwindow" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно с просмотром изменений при коммите" %}
|
|
||||||
{% assign scrname = "git-etc_commitwindow" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно объединения" %}
|
|
||||||
{% assign scrname = "git-etc_mergingwindow" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно отката" %}
|
|
||||||
{% assign scrname = "git-etc_rollbackwindow" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
</div>
|
|
||||||
<!-- end of gui block -->
|
|
||||||
181
ru/projects/git-etc.md
Normal file
181
ru/projects/git-etc.md
Normal file
@ -0,0 +1,181 @@
|
|||||||
|
---
|
||||||
|
category: ru
|
||||||
|
hastr: true
|
||||||
|
layout: project
|
||||||
|
title: git-etc
|
||||||
|
short: git-etc
|
||||||
|
tags: git, python, qt, linux, system, демон
|
||||||
|
hasgui: true
|
||||||
|
hasdocs: false
|
||||||
|
developers:
|
||||||
|
- Evgeniy Alekseev
|
||||||
|
license: GPLv3
|
||||||
|
links:
|
||||||
|
- Пакет в <a href="//aur.archlinux.org/packages/git-etc" title="AUR">AUR</a>
|
||||||
|
---
|
||||||
|
<!-- info block -->
|
||||||
|
## <a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация
|
||||||
|
|
||||||
|
Простой демон, который создает git репозиторий в указанной директории и создает коммит в указанный промежуток времени.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ git-etc --help
|
||||||
|
Simple daemon written on BASH for monitoring changes in files
|
||||||
|
|
||||||
|
Usage: git-etc [ -c | --config /etc/git-etc.conf ] [ -h | --help ] [ -v | --version ]
|
||||||
|
|
||||||
|
Parametrs:
|
||||||
|
-c --config - path to configuration file
|
||||||
|
-h --help - show this help and exit
|
||||||
|
-v --version - show version and exit
|
||||||
|
|
||||||
|
See "man 1 git-etc" for more details
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ ctrlconf --help
|
||||||
|
GUI for git-etc daemon
|
||||||
|
|
||||||
|
Usage: ctrlconf [ --default ] [ -h | --help ] [ -v | --version ]
|
||||||
|
|
||||||
|
Additional parametrs:
|
||||||
|
--default - create default configuration file
|
||||||
|
-h --help - show this help and exit
|
||||||
|
-v --version - show version and exit
|
||||||
|
|
||||||
|
See "man 1 ctrlconf" for more details
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики
|
||||||
|
|
||||||
|
{% for devel in page.developers %}
|
||||||
|
* {{ devel }}{% endfor %}
|
||||||
|
|
||||||
|
### <a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия
|
||||||
|
|
||||||
|
* {{ page.license }}
|
||||||
|
|
||||||
|
<!-- end of info block -->
|
||||||
|
|
||||||
|
<!-- install block -->
|
||||||
|
## <a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка
|
||||||
|
|
||||||
|
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция
|
||||||
|
|
||||||
|
* Скачайте [архив](//github.com/arcan1s/git-etc/releases "GitHub") с актуальной версией исходных файлов.
|
||||||
|
* Извлеките из него файлы и установите приложение:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./install.sh "/путь/к/корню/"
|
||||||
|
```
|
||||||
|
|
||||||
|
Если Вы хотите установить в `/`, Вы должны запустить это, как root:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo ./install.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
Если путь не указан, пакет будет установлен в `/`.
|
||||||
|
|
||||||
|
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости
|
||||||
|
|
||||||
|
Все было протестировано на последних версиях зависимостей.
|
||||||
|
|
||||||
|
* Bash (включая awk, grep, sed)
|
||||||
|
* git
|
||||||
|
* python2 *(make)*
|
||||||
|
* systemd *(опционально, service-файл)*
|
||||||
|
* python2-pyqt4 *(опционально, GUI)*
|
||||||
|
* xterm *(опционально, GUI)*
|
||||||
|
|
||||||
|
<!-- end of install block -->
|
||||||
|
|
||||||
|
<!-- howto block -->
|
||||||
|
## <a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование
|
||||||
|
|
||||||
|
Если Вы хотите запустить демон в `/etc`, просто запустите
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl start git-etc
|
||||||
|
```
|
||||||
|
|
||||||
|
Если Вы хотите включить автозагрузку демона, запутите
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl enable git-etc
|
||||||
|
```
|
||||||
|
|
||||||
|
Но Вы можете изменить путь к конфигурационному файлу или изменить параметры. Для этого, скопируйте (рекомендуется) исходный конфигурационный файл
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp /etc/git-etc.conf /новый/путь/к/git-etc.conf
|
||||||
|
```
|
||||||
|
|
||||||
|
и отредактируйте его. Затем скопируйте исходный service-файл в `/etc`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp /usr/lib/systemd/system/git-etc.service /etc/systemd/system/git-etc-my-profile.service
|
||||||
|
```
|
||||||
|
|
||||||
|
Замените следующую строку в этом файле:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ExecStart=/usr/bin/git-etc -c /etc/git-etc.conf
|
||||||
|
```
|
||||||
|
|
||||||
|
на
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ExecStart=/usr/bin/git-etc -c /новый/путь/к/git-etc.conf
|
||||||
|
```
|
||||||
|
<!-- end of howto block -->
|
||||||
|
|
||||||
|
<!-- config block -->
|
||||||
|
## <a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка
|
||||||
|
|
||||||
|
Все настройки хранятся в `/etc/git-etc.conf`. После редактирования, Вы должны перезапустить демон
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl restart git-etc
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#options" class="anchor" id="options"><span class="octicon octicon-link"></span></a>Опции
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|-------|-------|
|
||||||
|
| DIRECTORY | Полный путь к рабочей директории с наблюдаемыми файлами. По умолчанию `/etc`. |
|
||||||
|
| TIMESLEEP | Промежуток времени между обновлениями, часы. Должно быть целым и >= 1\. По умолчанию `12`. |
|
||||||
|
| IGNORELIST | Список файлов, которые не будут наблюдаться. Разделитель ";;". Может быть пустым. |
|
||||||
|
| FORALL | `1` включит доступ для обычного пользователя. По умолчанию `1`. |
|
||||||
|
<!-- end of config block -->
|
||||||
|
|
||||||
|
<!-- gui block -->
|
||||||
|
## <a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс
|
||||||
|
|
||||||
|
Control Config (`ctrlconf`) - графический интерфейс для `git-etc`, написанный на `Python2/PyQt4`. Данное приложение позволяет Вам увидеть список коммитов и изменения в файлах в данных коммитах. Также данное приложение позволит Вам откатиться на указанный коммит (все файлы, посредством `git reset --hard`, или только указанный, посредством `git diff && git apply`). Также Вы можете объединить старый и новый конфигурационные файлы (используются две
|
||||||
|
ветки репозитория master и experimental). Приложение может потребовать привелегии root, убедитесь, что пакет `sudo` установлен.
|
||||||
|
|
||||||
|
### <a href="#gui_configuration" class="anchor" id="gui_configuration"><span class="octicon octicon-link"></span></a>Настройка
|
||||||
|
|
||||||
|
Запустите приложение и откройте окно настроек из меню.
|
||||||
|
|
||||||
|
### <a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Скриншоты
|
||||||
|
|
||||||
|
<div class="thumbnails">
|
||||||
|
{% assign scrdesc = "Основное окно" %}
|
||||||
|
{% assign scrname = "git-etc_mainwindow" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно 'О программе'" %}
|
||||||
|
{% assign scrname = "git-etc_aboutwindow" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно с просмотром изменений при коммите" %}
|
||||||
|
{% assign scrname = "git-etc_commitwindow" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно объединения" %}
|
||||||
|
{% assign scrname = "git-etc_mergingwindow" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно отката" %}
|
||||||
|
{% assign scrname = "git-etc_rollbackwindow" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
</div>
|
||||||
|
<!-- end of gui block -->
|
||||||
@ -1,209 +0,0 @@
|
|||||||
---
|
|
||||||
category: ru
|
|
||||||
hastr: true
|
|
||||||
layout: project
|
|
||||||
title: Netctl GUI
|
|
||||||
short: netctl-gui
|
|
||||||
tags: archlinux, c++, qt, сеть, kde, netctl, система, dbus, библиотека
|
|
||||||
hasgui: true
|
|
||||||
hasdocs: true
|
|
||||||
developers:
|
|
||||||
- Evgeniy Alekseev
|
|
||||||
- nosada (перевод на японский)
|
|
||||||
license: GPLv3
|
|
||||||
links:
|
|
||||||
- Страница на <a href="//linux.softpedia.com/get/System/Networking/Netctl-GUI-103383.shtml" title="Softpedia">Softpedia</a>
|
|
||||||
- Страница на <a href="//kde-apps.org/content/show.php?content=164490" title="kde-apps">kde-apps.org</a>
|
|
||||||
- <a href="//aur.archlinux.org/pkgbase/netctl-gui/" title="AUR">Пакет в AUR</a>
|
|
||||||
- <a href="/devs/netctl-gui-dbus-api.html" title="DBus API">Описание DBus API</a>
|
|
||||||
- <a href="/devs/netctl-gui-security-notes.html" title="Security">Примечания о безопасности</a>
|
|
||||||
---
|
|
||||||
<!-- info block -->
|
|
||||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
|
||||||
<p>Графическая оболочка для <code>netctl</code> (набор скриптов для поднятия сети в Arch'е). Написана на <code>C++</code> с использованием библиотеки <code>Qt</code>. На текущим момент умеет работать с профилями, в том числе создавать новые, а также умеет подключаться к WiFi. Также предоставляет библиотеку для взаимодействия с netctl и виджет и DataEngine для KDE.</p>
|
|
||||||
|
|
||||||
<p><b>ВНИМАНИЕ:</b> <a href="//github.com/arcan1s/netctl-gui/issues/3" title="Тикет">НУЖНЫ ПЕРЕВОДЧИКИ!</a></p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
$ netctl-gui --help
|
|
||||||
Использование:
|
|
||||||
netctl-gui [ options ]
|
|
||||||
Опции:
|
|
||||||
Открыть окно:
|
|
||||||
--detached - запустить открепленным от консоли
|
|
||||||
--maximized - запустить развернутым
|
|
||||||
--minimized - запустить свернутым в трей
|
|
||||||
--about - показать окно "О программе"
|
|
||||||
--netctl-auto - показать окно netctl-auto
|
|
||||||
--settings - показать окно настроек
|
|
||||||
Функции:
|
|
||||||
-e, --essid <arg> - выбрать данный ESSID
|
|
||||||
-o, --open <arg> - открыть данный профиль
|
|
||||||
-s, --select <arg> - выбрать данный профиль
|
|
||||||
Дополнительные флаги:
|
|
||||||
-c, --config <arg> - прочитать настройки из данного файла
|
|
||||||
-d, --debug - показать отладочную информацию
|
|
||||||
--default - запустить со стандартными настройками
|
|
||||||
--set-opts <arg> - установить опции для данного запуска, разделенные запятыми
|
|
||||||
-t, --tab <arg> - открыть вкладку с этим номером
|
|
||||||
Показать сообщения:
|
|
||||||
-v, --version - показать версию и выход
|
|
||||||
-i, --info - показать информацию о сборке и выход
|
|
||||||
-h, --help - показать справку и выход
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
$ netctlgui-helper --help
|
|
||||||
Использование:
|
|
||||||
netctlgui-helper [ options ]
|
|
||||||
Опции:
|
|
||||||
-c, --config <arg> - прочитать настройки из данного файла
|
|
||||||
-d, --debug - показать отладочную информацию
|
|
||||||
--nodaemon - не запускать как демон
|
|
||||||
--replace - принудительно заменить существующую сессию
|
|
||||||
--restore - принудительно восстановить существующую сессию
|
|
||||||
--system - не считывать пользовательские настройки, только системные
|
|
||||||
Показать сообщения:
|
|
||||||
-v, --version - показать версию и выход
|
|
||||||
-i, --info - показать информацию о сборке и выход
|
|
||||||
-h, --help - показать справку и выход
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
|
||||||
<ul>
|
|
||||||
{% for devel in page.developers %}
|
|
||||||
<li>{{ devel }}</li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
|
||||||
<ul>
|
|
||||||
<li>{{ page.license }}</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#changelog" class="anchor" id="changelog"><span class="octicon octicon-link"></span></a>Changelog</h3>
|
|
||||||
<p><a href="//github.com/arcan1s/netctl-gui/blob/master/CHANGELOG" title="GitHub">CHANGELOG</a></p>
|
|
||||||
<!-- end of info block -->
|
|
||||||
|
|
||||||
<!-- install block -->
|
|
||||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
|
||||||
|
|
||||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
|
||||||
<ul>
|
|
||||||
<li>Скачайте <a href="//github.com/arcan1s/netctl-gui/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</li>
|
|
||||||
<li>Извлеките из него файлы и установите приложение. Если Вы хотите установить в <code>/</code>, Вы должны запустить как root:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cd /путь/к/распакованному/архиву
|
|
||||||
mkdir build && cd build
|
|
||||||
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release ../
|
|
||||||
make
|
|
||||||
sudo make install
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
Доступные флаги cmake:
|
|
||||||
<ul>
|
|
||||||
<li>компоненты:
|
|
||||||
<ul>
|
|
||||||
<li><code>-DBUILD_DATAENGINE:BOOL=0</code> - не собирать DataEngine</li>
|
|
||||||
<li><code>-DBUILD_GUI:BOOL=0</code> - не собирать GUI</li>
|
|
||||||
<li><code>-DBUILD_HELPER:BOOL=0</code> - не собирать хелпер</li>
|
|
||||||
<li><code>-DBUILD_LIBRARY:BOOL=0</code> - не собирать библиотеку</li>
|
|
||||||
<li><code>-DBUILD_PLASMOID:BOOL=0</code> - не собирать плазмоид</li>
|
|
||||||
</ul></li>
|
|
||||||
<li>дополнительные компоненты:
|
|
||||||
<ul>
|
|
||||||
<li><code>-DBUILD_DOCS:BOOL=0</code> - не собирать документацию разработчика</li>
|
|
||||||
<li><code>-DBUILD_TEST:BOOL=1</code> - собирать авто тесты для библиотеки и хелпера</li>
|
|
||||||
</ul></li>
|
|
||||||
<li>свойства проекта:
|
|
||||||
<ul>
|
|
||||||
<li><code>-DDBUS_SYSTEMCONF_PATH=/etc/dbus-1/system.d/</code> - путь к системный файлам конфигурации DBus</li>
|
|
||||||
<li><code>-DSYSTEMD_SERVICE_PATH=lib/systemd/system</code> - путь к сервису systemd</li>
|
|
||||||
<li><code>-DUSE_CAPABILITIES:BOOL=0</code> - не использовать setcap, чтобы дать необходимые привилегии хелперу</li>
|
|
||||||
<li><code>-DBUILD_KDE4:BOOL=1</code> - собирать виджет под KDE4 вместо KF5</li>
|
|
||||||
<li><code>-DUSE_QT5:BOOL=0</code> - использовать Qt4 вместо Qt5</li>
|
|
||||||
</ul></li>
|
|
||||||
</ul></li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
|
||||||
<p>Все было протестировано на последних версиях зависимостей.</p>
|
|
||||||
<ul>
|
|
||||||
<li>netctl</li>
|
|
||||||
<li>qt5-base <i>(если используется Qt5)</i> <b>или</b> qt4 <i>(если используется Qt4)</i></li>
|
|
||||||
<li>automoc4 <i>(make)</i></li>
|
|
||||||
<li>cmake <i>(make)</i></li>
|
|
||||||
<li>qt5-tools <i>(make, если используется Qt5)</i></li>
|
|
||||||
<li>kdebase-workspace <i>(опционально, KDE4 виджет)</i></li>
|
|
||||||
<li>plasma-frameworks <i>(опционально, KF5 виджет)</i></li>
|
|
||||||
<li>sudo <i>(опционально, поддержка sudo)</i></li>
|
|
||||||
<li>wpa_supplicant <i>(опционально, поддержка WiFi)</i></li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of install block -->
|
|
||||||
|
|
||||||
<!-- howto block -->
|
|
||||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
|
||||||
<p>Просто запустите приложение <code>netctl-gui</code>. Если потребуется (и если Вы используете KDE), можете добавить виджет <code>netctl</code>, предоставляемый приложением.</p>
|
|
||||||
<!-- end of howto block -->
|
|
||||||
|
|
||||||
<!-- config block -->
|
|
||||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
|
||||||
<p>Рекомендуется использовать графический интерфейс для настройки. Конфигурационные файлы:</p>
|
|
||||||
<ul>
|
|
||||||
<li><code>$HOME/.config/netctl-gui.conf</code> - пользовательские настройки GUI/хелпера</li>
|
|
||||||
<li><code>/etc/netctl-gui.conf</code> - системные настройки хелпера</li>
|
|
||||||
<ul>
|
|
||||||
<li><code>$KDEHOME/share/config/plasma-dataengine-netctl.conf</code> - пользовательские настройки DataEngine</li>
|
|
||||||
<li><code>$KDESYSTEM/share/config/plasma-dataengine-netctl.conf</code> - системные настройки DataEngine</li>
|
|
||||||
</ul>
|
|
||||||
<ul>
|
|
||||||
<li><code>$HOME/.config/plasma-dataengine-netctl.conf</code> - пользовательские настройки DataEngine</li>
|
|
||||||
<li><code>/etc/xdg/plasma-dataengine-netctl.conf</code> - системные настройки DataEngine</li>
|
|
||||||
</ul>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<p>Для настройки виджета и DataEngine рекомендуется использовать графический интерфейс. Все настройки графического интерфейса хранятся в <code>$HOME/.config/netctl-gui.conf</code>. Для редактирования настоятельно рекомендуется использовать графический интерфейс.</p>
|
|
||||||
<!-- end of config block -->
|
|
||||||
|
|
||||||
<!-- gui block -->
|
|
||||||
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс</h2>
|
|
||||||
<p>Графический интерфейс предоставляется приложением <code>netctl-gui</code>.</p>
|
|
||||||
|
|
||||||
<h3><a name="screenshots" class="anchor" href="#screenshots"><span class="octicon octicon-link"></span></a>Скриншоты</h3>
|
|
||||||
<div class="thumbnails">
|
|
||||||
{% assign scrdesc = "DataEngine" %}
|
|
||||||
{% assign scrname = "netctl-gui_dataengine" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Виджет" %}
|
|
||||||
{% assign scrname = "netctl-gui_plasmoid" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Настройки виджета" %}
|
|
||||||
{% assign scrname = "netctl-gui_plasmoid_conf_01" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Настройки виджета" %}
|
|
||||||
{% assign scrname = "netctl-gui_plasmoid_conf_02" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Настройки виджета" %}
|
|
||||||
{% assign scrname = "netctl-gui_plasmoid_conf_03" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Главное окно" %}
|
|
||||||
{% assign scrname = "netctl-gui_main" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно создания профиля" %}
|
|
||||||
{% assign scrname = "netctl-gui_profile" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "WiFi меню" %}
|
|
||||||
{% assign scrname = "netctl-gui_wifi" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно 'О программе'" %}
|
|
||||||
{% assign scrname = "netctl-gui_about" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно netctl-auto" %}
|
|
||||||
{% assign scrname = "netctl-gui_netctl-auto" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно настроек" %}
|
|
||||||
{% assign scrname = "netctl-gui_settings" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
</div>
|
|
||||||
<!-- end of gui block -->
|
|
||||||
206
ru/projects/netctl-gui.md
Normal file
206
ru/projects/netctl-gui.md
Normal file
@ -0,0 +1,206 @@
|
|||||||
|
---
|
||||||
|
category: ru
|
||||||
|
hastr: true
|
||||||
|
layout: project
|
||||||
|
title: Netctl GUI
|
||||||
|
short: netctl-gui
|
||||||
|
tags: archlinux, c++, qt, сеть, kde, netctl, система, dbus, библиотека
|
||||||
|
hasgui: true
|
||||||
|
hasdocs: true
|
||||||
|
developers:
|
||||||
|
- Evgeniy Alekseev
|
||||||
|
- nosada (перевод на японский)
|
||||||
|
license: GPLv3
|
||||||
|
links:
|
||||||
|
- Страница на <a href="//linux.softpedia.com/get/System/Networking/Netctl-GUI-103383.shtml" title="Softpedia">Softpedia</a>
|
||||||
|
- Страница на <a href="//kde-apps.org/content/show.php?content=164490" title="kde-apps">kde-apps.org</a>
|
||||||
|
- <a href="//aur.archlinux.org/pkgbase/netctl-gui/" title="AUR">Пакет в AUR</a>
|
||||||
|
- <a href="/devs/netctl-gui-dbus-api.html" title="DBus API">Описание DBus API</a>
|
||||||
|
- <a href="/devs/netctl-gui-security-notes.html" title="Security">Примечания о безопасности</a>
|
||||||
|
---
|
||||||
|
<!-- info block -->
|
||||||
|
## <a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация
|
||||||
|
|
||||||
|
Графическая оболочка для `netctl` (набор скриптов для поднятия сети в Arch'е). Написана на `C++` с использованием библиотеки `Qt`. На текущим момент умеет работать с профилями, в том числе создавать новые, а также умеет подключаться к WiFi. Также предоставляет библиотеку для взаимодействия с netctl и виджет и DataEngine для KDE.
|
||||||
|
|
||||||
|
**ВНИМАНИЕ:** [НУЖНЫ ПЕРЕВОДЧИКИ!](//github.com/arcan1s/netctl-gui/issues/3 "Тикет")
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ netctl-gui --help
|
||||||
|
Использование:
|
||||||
|
netctl-gui [ options ]
|
||||||
|
Опции:
|
||||||
|
Открыть окно:
|
||||||
|
--detached - запустить открепленным от консоли
|
||||||
|
--maximized - запустить развернутым
|
||||||
|
--minimized - запустить свернутым в трей
|
||||||
|
--about - показать окно "О программе"
|
||||||
|
--netctl-auto - показать окно netctl-auto
|
||||||
|
--settings - показать окно настроек
|
||||||
|
Функции:
|
||||||
|
-e, --essid <arg> - выбрать данный ESSID
|
||||||
|
-o, --open <arg> - открыть данный профиль
|
||||||
|
-s, --select <arg> - выбрать данный профиль
|
||||||
|
Дополнительные флаги:
|
||||||
|
-c, --config <arg> - прочитать настройки из данного файла
|
||||||
|
-d, --debug - показать отладочную информацию
|
||||||
|
--default - запустить со стандартными настройками
|
||||||
|
--set-opts <arg> - установить опции для данного запуска, разделенные запятыми
|
||||||
|
-t, --tab <arg> - открыть вкладку с этим номером
|
||||||
|
Показать сообщения:
|
||||||
|
-v, --version - показать версию и выход
|
||||||
|
-i, --info - показать информацию о сборке и выход
|
||||||
|
-h, --help - показать справку и выход
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ netctlgui-helper --help
|
||||||
|
Использование:
|
||||||
|
netctlgui-helper [ options ]
|
||||||
|
Опции:
|
||||||
|
-c, --config <arg> - прочитать настройки из данного файла
|
||||||
|
-d, --debug - показать отладочную информацию
|
||||||
|
--nodaemon - не запускать как демон
|
||||||
|
--replace - принудительно заменить существующую сессию
|
||||||
|
--restore - принудительно восстановить существующую сессию
|
||||||
|
--system - не считывать пользовательские настройки, только системные
|
||||||
|
Показать сообщения:
|
||||||
|
-v, --version - показать версию и выход
|
||||||
|
-i, --info - показать информацию о сборке и выход
|
||||||
|
-h, --help - показать справку и выход
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики
|
||||||
|
|
||||||
|
{% for devel in page.developers %}
|
||||||
|
* {{ devel }}{% endfor %}
|
||||||
|
|
||||||
|
### <a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия
|
||||||
|
|
||||||
|
* {{ page.license }}
|
||||||
|
|
||||||
|
### <a href="#changelog" class="anchor" id="changelog"><span class="octicon octicon-link"></span></a>Changelog
|
||||||
|
|
||||||
|
[CHANGELOG](//github.com/arcan1s/netctl-gui/blob/master/CHANGELOG "GitHub")
|
||||||
|
|
||||||
|
<!-- end of info block -->
|
||||||
|
|
||||||
|
<!-- install block -->
|
||||||
|
## <a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка
|
||||||
|
|
||||||
|
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция
|
||||||
|
|
||||||
|
* Скачайте [архив](//github.com/arcan1s/netctl-gui/releases "GitHub") с актуальной версией исходных файлов.
|
||||||
|
* Извлеките из него файлы и установите приложение. Если Вы хотите установить в `/`, Вы должны запустить как root:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /путь/к/распакованному/архиву
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release ../
|
||||||
|
make
|
||||||
|
sudo make install
|
||||||
|
```
|
||||||
|
|
||||||
|
Доступные флаги cmake:
|
||||||
|
|
||||||
|
* компоненты:
|
||||||
|
* `-DBUILD_DATAENGINE:BOOL=0` - не собирать DataEngine
|
||||||
|
* `-DBUILD_GUI:BOOL=0` - не собирать GUI
|
||||||
|
* `-DBUILD_HELPER:BOOL=0` - не собирать хелпер
|
||||||
|
* `-DBUILD_LIBRARY:BOOL=0` - не собирать библиотеку
|
||||||
|
* `-DBUILD_PLASMOID:BOOL=0` - не собирать плазмоид
|
||||||
|
* дополнительные компоненты:
|
||||||
|
* `-DBUILD_DOCS:BOOL=0` - не собирать документацию разработчика
|
||||||
|
* `-DBUILD_TEST:BOOL=1` - собирать авто тесты для библиотеки и хелпера
|
||||||
|
* свойства проекта:
|
||||||
|
* `-DDBUS_SYSTEMCONF_PATH=/etc/dbus-1/system.d/` - путь к системный файлам конфигурации DBus
|
||||||
|
* `-DSYSTEMD_SERVICE_PATH=lib/systemd/system` - путь к сервису systemd
|
||||||
|
* `-DUSE_CAPABILITIES:BOOL=0` - не использовать setcap, чтобы дать необходимые привилегии хелперу
|
||||||
|
* `-DBUILD_KDE4:BOOL=1` - собирать виджет под KDE4 вместо KF5
|
||||||
|
* `-DUSE_QT5:BOOL=0` - использовать Qt4 вместо Qt5
|
||||||
|
|
||||||
|
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости
|
||||||
|
|
||||||
|
Все было протестировано на последних версиях зависимостей.
|
||||||
|
|
||||||
|
* netctl
|
||||||
|
* qt5-base *(если используется Qt5)* **или** qt4 *(если используется Qt4)*
|
||||||
|
* automoc4 *(make)*
|
||||||
|
* cmake *(make)*
|
||||||
|
* qt5-tools *(make, если используется Qt5)*
|
||||||
|
* kdebase-workspace *(опционально, KDE4 виджет)*
|
||||||
|
* plasma-frameworks *(опционально, KF5 виджет)*
|
||||||
|
* sudo *(опционально, поддержка sudo)*
|
||||||
|
* wpa_supplicant *(опционально, поддержка WiFi)*
|
||||||
|
|
||||||
|
<!-- end of install block -->
|
||||||
|
|
||||||
|
<!-- howto block -->
|
||||||
|
## <a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование
|
||||||
|
|
||||||
|
Просто запустите приложение `netctl-gui`. Если потребуется (и если Вы используете KDE), можете добавить виджет `netctl`, предоставляемый приложением.
|
||||||
|
|
||||||
|
<!-- end of howto block -->
|
||||||
|
|
||||||
|
<!-- config block -->
|
||||||
|
## <a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка
|
||||||
|
|
||||||
|
Рекомендуется использовать графический интерфейс для настройки. Конфигурационные файлы:
|
||||||
|
|
||||||
|
* Графический интерфейс и хелпер
|
||||||
|
* `$HOME/.config/netctl-gui.conf` - пользовательские настройки GUI/хелпера
|
||||||
|
* `/etc/netctl-gui.conf` - системные настройки хелпера
|
||||||
|
* DataEngine (KDE4 версия)
|
||||||
|
* `$KDEHOME/share/config/plasma-dataengine-netctl.conf` - пользовательские настройки DataEngine
|
||||||
|
* `$KDESYSTEM/share/config/plasma-dataengine-netctl.conf` - системные настройки DataEngine
|
||||||
|
* DataEngine (KF5 версия)
|
||||||
|
* `$HOME/.config/plasma-dataengine-netctl.conf` - пользовательские настройки DataEngine
|
||||||
|
* `/etc/xdg/plasma-dataengine-netctl.conf` - системные настройки DataEngine
|
||||||
|
|
||||||
|
Для настройки виджета и DataEngine рекомендуется использовать графический интерфейс. Все настройки графического интерфейса хранятся в `$HOME/.config/netctl-gui.conf`. Для редактирования настоятельно рекомендуется использовать графический интерфейс.
|
||||||
|
|
||||||
|
<!-- end of config block -->
|
||||||
|
|
||||||
|
<!-- gui block -->
|
||||||
|
## <a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс
|
||||||
|
|
||||||
|
Графический интерфейс предоставляется приложением `netctl-gui`.
|
||||||
|
|
||||||
|
### <a name="screenshots" class="anchor" href="#screenshots"><span class="octicon octicon-link"></span></a>Скриншоты
|
||||||
|
|
||||||
|
<div class="thumbnails">
|
||||||
|
{% assign scrdesc = "DataEngine" %}
|
||||||
|
{% assign scrname = "netctl-gui_dataengine" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Виджет" %}
|
||||||
|
{% assign scrname = "netctl-gui_plasmoid" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Настройки виджета" %}
|
||||||
|
{% assign scrname = "netctl-gui_plasmoid_conf_01" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Настройки виджета" %}
|
||||||
|
{% assign scrname = "netctl-gui_plasmoid_conf_02" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Настройки виджета" %}
|
||||||
|
{% assign scrname = "netctl-gui_plasmoid_conf_03" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Главное окно" %}
|
||||||
|
{% assign scrname = "netctl-gui_main" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно создания профиля" %}
|
||||||
|
{% assign scrname = "netctl-gui_profile" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "WiFi меню" %}
|
||||||
|
{% assign scrname = "netctl-gui_wifi" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно 'О программе'" %}
|
||||||
|
{% assign scrname = "netctl-gui_about" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно netctl-auto" %}
|
||||||
|
{% assign scrname = "netctl-gui_netctl-auto" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно настроек" %}
|
||||||
|
{% assign scrname = "netctl-gui_settings" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
</div>
|
||||||
|
<!-- end of gui block -->
|
||||||
@ -1,107 +0,0 @@
|
|||||||
---
|
|
||||||
category: ru
|
|
||||||
hastr: true
|
|
||||||
layout: project
|
|
||||||
title: Oblikue strategies
|
|
||||||
short: oblikuestrategies
|
|
||||||
tags: qt, c++, kde, linux, досуг
|
|
||||||
hasgui: true
|
|
||||||
hasdocs: false
|
|
||||||
developers:
|
|
||||||
- Evgeniy Alekseev
|
|
||||||
license: GPL
|
|
||||||
links:
|
|
||||||
- Страница на <a href="//kde-look.org/content/show.php/oblikue-strategies?content=160503" title="kde-look">kde-look.org</a>
|
|
||||||
- Пакет в <a href="//aur.archlinux.org/packages/kdeplasma-applets-oblikuestrategies" title="AUR">AUR</a>
|
|
||||||
---
|
|
||||||
<!-- info block -->
|
|
||||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
|
||||||
<p>Плазмоид, написанный на <code>CPP</code> который показывает случайные карты из Brian Eno и Peter Schmidt's <a href="//en.wikipedia.org/wiki/Oblique_strategies" title="Wiki">Oblique Strategies</a>. Это форк <a href="//gnome-look.org/content/show.php/Oblique+Strategies?content=78405" title="gnome-look">апплета для GNOME</a> с некоторыми дополнительными фичами.</p>
|
|
||||||
|
|
||||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
|
||||||
<ul>
|
|
||||||
{% for devel in page.developers %}
|
|
||||||
<li>{{ devel }}</li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
|
||||||
<ul>
|
|
||||||
<li>{{ page.license }}</li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of info block -->
|
|
||||||
|
|
||||||
<!-- install block -->
|
|
||||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
|
||||||
|
|
||||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
|
||||||
<ul>
|
|
||||||
<li>Скачайте <a href="//github.com/arcan1s/oblikuestrategies/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</li>
|
|
||||||
<li>Извлеките из него файлы и установите приложение. Для глобальной установки наберите:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cd /путь/куда/распакован/архив
|
|
||||||
mkdir build && cd build
|
|
||||||
cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` -DCMAKE_BUILD_TYPE=Release ../
|
|
||||||
make
|
|
||||||
sudo make install
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
Для локальной:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cd /where/your/applet/is/installed
|
|
||||||
mkdir build && cd build
|
|
||||||
cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --localprefix` -DCMAKE_BUILD_TYPE=Release ../
|
|
||||||
make
|
|
||||||
make install
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
</li>
|
|
||||||
<li>Перезапустите plasma, чтобы загрузить апплет:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
kquitapp plasma-desktop && sleep 2 && plasma-desktop
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
Также Вам может потребоваться запустить <code>kbuildsycoca4</code>, чтобы распознать <code>*.desktop</code> файл:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
kbuildsycoca4 &> /dev/null
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
|
||||||
<p>Все было протестировано на последних версиях зависимостей.</p>
|
|
||||||
<ul>
|
|
||||||
<li>kdebase-workspace</li>
|
|
||||||
<li>automoc4 <i>(make)</i></li>
|
|
||||||
<li>cmake <i>(make)</i></li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of install block -->
|
|
||||||
|
|
||||||
<!-- howto block -->
|
|
||||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
|
||||||
<p>Откройте список виджетов Plasma и выберете <code>Oblikue strategies</code>.</p>
|
|
||||||
<!-- end of howto block -->
|
|
||||||
|
|
||||||
<!-- config block -->
|
|
||||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
|
||||||
<p>Клик правой кнопкой по виджету.</p>
|
|
||||||
<!-- end of config block -->
|
|
||||||
|
|
||||||
<!-- gui block -->
|
|
||||||
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс</h2>
|
|
||||||
|
|
||||||
<h3><a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Скриншоты</h3>
|
|
||||||
<div class="thumbnails">
|
|
||||||
{% assign scrdesc = "Виджет" %}
|
|
||||||
{% assign scrname = "oblikuestrategies_widget" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
{% assign scrdesc = "Окно настроек" %}
|
|
||||||
{% assign scrname = "oblikuestrategies_config" %}
|
|
||||||
{% include prj_scr.html %}
|
|
||||||
</div>
|
|
||||||
<!-- end of gui block -->
|
|
||||||
108
ru/projects/oblikuestrategies.md
Normal file
108
ru/projects/oblikuestrategies.md
Normal file
@ -0,0 +1,108 @@
|
|||||||
|
---
|
||||||
|
category: ru
|
||||||
|
hastr: true
|
||||||
|
layout: project
|
||||||
|
title: Oblikue strategies
|
||||||
|
short: oblikuestrategies
|
||||||
|
tags: qt, c++, kde, linux, досуг
|
||||||
|
hasgui: true
|
||||||
|
hasdocs: false
|
||||||
|
developers:
|
||||||
|
- Evgeniy Alekseev
|
||||||
|
license: GPL
|
||||||
|
links:
|
||||||
|
- Страница на <a href="//kde-look.org/content/show.php/oblikue-strategies?content=160503" title="kde-look">kde-look.org</a>
|
||||||
|
- Пакет в <a href="//aur.archlinux.org/packages/kdeplasma-applets-oblikuestrategies" title="AUR">AUR</a>
|
||||||
|
---
|
||||||
|
<!-- info block -->
|
||||||
|
## <a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация
|
||||||
|
|
||||||
|
Плазмоид, написанный на `CPP` который показывает случайные карты из Brian Eno и Peter Schmidt's [Oblique Strategies](//en.wikipedia.org/wiki/Oblique_strategies "Wiki"). Это форк [апплета для GNOME](//gnome-look.org/content/show.php/Oblique+Strategies?content=78405 "gnome-look") с некоторыми дополнительными фичами.
|
||||||
|
|
||||||
|
### <a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики
|
||||||
|
|
||||||
|
{% for devel in page.developers %}
|
||||||
|
* {{ devel }}{% endfor %}
|
||||||
|
|
||||||
|
### <a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия
|
||||||
|
|
||||||
|
* {{ page.license }}
|
||||||
|
|
||||||
|
<!-- end of info block -->
|
||||||
|
|
||||||
|
<!-- install block -->
|
||||||
|
## <a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка
|
||||||
|
|
||||||
|
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция
|
||||||
|
|
||||||
|
* Скачайте [архив](//github.com/arcan1s/oblikuestrategies/releases "GitHub") с актуальной версией исходных файлов.
|
||||||
|
* Извлеките из него файлы и установите приложение. Для глобальной установки наберите:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /путь/куда/распакован/архив
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` -DCMAKE_BUILD_TYPE=Release ../
|
||||||
|
make
|
||||||
|
sudo make install
|
||||||
|
```
|
||||||
|
|
||||||
|
Для локальной:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /where/your/applet/is/installed
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --localprefix` -DCMAKE_BUILD_TYPE=Release ../
|
||||||
|
make
|
||||||
|
make install
|
||||||
|
```
|
||||||
|
|
||||||
|
* Перезапустите plasma, чтобы загрузить апплет:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
kquitapp plasma-desktop && sleep 2 && plasma-desktop
|
||||||
|
```
|
||||||
|
|
||||||
|
Также Вам может потребоваться запустить `kbuildsycoca4`, чтобы распознать `*.desktop` файл:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
kbuildsycoca4 &> /dev/null
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости
|
||||||
|
|
||||||
|
Все было протестировано на последних версиях зависимостей.
|
||||||
|
|
||||||
|
* kdebase-workspace
|
||||||
|
* automoc4 *(make)*
|
||||||
|
* cmake *(make)*
|
||||||
|
|
||||||
|
<!-- end of install block -->
|
||||||
|
|
||||||
|
<!-- howto block -->
|
||||||
|
## <a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование
|
||||||
|
|
||||||
|
Откройте список виджетов Plasma и выберете `Oblikue strategies`.
|
||||||
|
|
||||||
|
<!-- end of howto block -->
|
||||||
|
|
||||||
|
<!-- config block -->
|
||||||
|
## <a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка
|
||||||
|
|
||||||
|
Клик правой кнопкой по виджету.
|
||||||
|
|
||||||
|
<!-- end of config block -->
|
||||||
|
|
||||||
|
<!-- gui block -->
|
||||||
|
## <a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс
|
||||||
|
|
||||||
|
### <a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Скриншоты
|
||||||
|
|
||||||
|
<div class="thumbnails">
|
||||||
|
{% assign scrdesc = "Виджет" %}
|
||||||
|
{% assign scrname = "oblikuestrategies_widget" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
{% assign scrdesc = "Окно настроек" %}
|
||||||
|
{% assign scrname = "oblikuestrategies_config" %}
|
||||||
|
{% include prj_scr.html %}
|
||||||
|
</div>
|
||||||
|
<!-- end of gui block -->
|
||||||
@ -1,170 +0,0 @@
|
|||||||
---
|
|
||||||
category: ru
|
|
||||||
hastr: true
|
|
||||||
layout: project
|
|
||||||
title: queued
|
|
||||||
short: queued
|
|
||||||
tags: linux, shell, демон, система
|
|
||||||
hasgui: false
|
|
||||||
hasdocs: false
|
|
||||||
developers:
|
|
||||||
- Evgeniy Alekseev
|
|
||||||
license: GPLv3
|
|
||||||
links:
|
|
||||||
---
|
|
||||||
<!-- info block -->
|
|
||||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
|
||||||
<p>Демон для запуска задач в очередь вычислений. Был создан, как proof-of-concept.</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
$ queued --help
|
|
||||||
Simple daemon written on BASH for starting jobs to queue of calculations
|
|
||||||
|
|
||||||
Usage: queued [ -c /etc/queued.conf ] [ -v | --version ] [ -h | --help ]
|
|
||||||
Parametrs:
|
|
||||||
-c PATH - path to configuration file. Default is '/etc/queued.conf'
|
|
||||||
|
|
||||||
-v --version - show version and exit
|
|
||||||
-h --help - show this help and exit
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
$ add_queued --help
|
|
||||||
add_queued [ -c /etc/queued.conf ] [ -p NUM ] [ -u USER ] [ -h | --help ] /path/to/script
|
|
||||||
|
|
||||||
Parameters:
|
|
||||||
-c PATH - path to configuration file. Default is '/etc/queued.conf'
|
|
||||||
-p NUM - job priority
|
|
||||||
-u USER - username
|
|
||||||
-h --help - show this help and exit
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
|
||||||
<ul>
|
|
||||||
{% for devel in page.developers %}
|
|
||||||
<li>{{ devel }}</li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
|
||||||
<ul>
|
|
||||||
<li>{{ page.license }}</li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of info block -->
|
|
||||||
|
|
||||||
<!-- install block -->
|
|
||||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
|
||||||
|
|
||||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
|
||||||
<ul>
|
|
||||||
<li>Скачайте <a href="//github.com/arcan1s/queued/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</li>
|
|
||||||
<li>Извлеките из него файлы и установите приложение:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
./install.sh "/путь/к/корню/"
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
Если Вы хотите установить в <code>/</code>, Вы должны запустить это, как root:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
sudo ./install.sh
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
Если путь не указан, пакет будет установлен в <code>/</code>.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
|
||||||
<p>Все было протестировано на последних версиях зависимостей.</p>
|
|
||||||
<ul>
|
|
||||||
<li>Bash (включая awk, grep, sed)</li>
|
|
||||||
<li>systemd <i>(опционально, service-файл)</i></li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of install block -->
|
|
||||||
|
|
||||||
<!-- howto block -->
|
|
||||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
|
||||||
<p>Если Вы хотите запустить демон, просто запустите</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
systemctl start queued
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>Если Вы хотите включить автозагрузку демона, запутите</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
systemctl enable queued
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>Но Вы можете изменить путь к конфигурационному файлу или изменить параметры. Для этого, скопируйте (рекомендуется) исходный конфигурационный файл</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cp /etc/queued.conf /новый/путь/к/queued.conf
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>и отредактируйте его. Затем скопируйте исходный service-файл в <code>/etc</code>:</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cp /usr/lib/systemd/system/queued.service /etc/systemd/system/queued-my-profile.service
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>Замените следующую строку в этом файле:</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
ExecStart=/usr/bin/queued
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>на</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
ExecStart=/usr/bin/queued -c /path/to/new/queued.conf
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<h3><a href="#adding" class="anchor" id="adding"><span class="octicon octicon-link"></span></a>Добавление задачи</h3>
|
|
||||||
<ol>
|
|
||||||
<li>Создайте скрипт с командой (например, с именем <code>script.sh</code>).</li>
|
|
||||||
<li>Создайте файл с приоритетом (<code>script.sh.pr</code>) для данной задачи, если это необходимо.</li>
|
|
||||||
<li>Создайте файл с именем пользователя (<code>script.sh.user</code>) для данной задачи, если это необходимо</li>
|
|
||||||
<li>Скопируйте файлы в <code>$WORKDIR</code></li>
|
|
||||||
</ol>
|
|
||||||
<p>Также Вы можете воспользоваться <code>add_queued</code>.</p>
|
|
||||||
|
|
||||||
<h2><a href="#configuration" class="anchor" id="configuration"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
|
||||||
<p>Все настройки хранятся в <code>/etc/queued.conf</code>. После редактирования, Вы должны перезапустить демон</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
systemctl restart queued
|
|
||||||
{% endhighlight %}
|
|
||||||
<!-- end of howto block -->
|
|
||||||
|
|
||||||
<!-- config block -->
|
|
||||||
<h3><a href="#options" class="anchor" id="options"><span class="octicon octicon-link"></span></a>Опции</h3>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<th>WORKDIR</th>
|
|
||||||
<td>Полный путь к директории с исходными файлами задач. По умолчанию <code>/var/lib/queued/work</code>. Эта директория должна содержать исходные скрипты <code>script-name</code>, файл с приоритетом (если необходимо) <code>script-name.pr</code> и файл с именем пользователя (если необходимо) <code>script-name.user</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>JOBDIR</th>
|
|
||||||
<td>Полный путь к директории с запущенными задачами. По умолчанию <code>/var/lib/queued/job</code>. Все файлы будут перемещены сюда.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>QUEUEFILE</th>
|
|
||||||
<td>Полный путь к файлу с очередью вычислений. По умолчанию <code>/var/lib/queued/queue</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>PRIORITY</th>
|
|
||||||
<td>Стандартный приоритет. По умолчанию <code>0</code>. Чем выше значение, тем выше приоритет задачи.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>SLEEPTIME</th>
|
|
||||||
<td>Интервал обновлений в минутах. По умолчанию <code>5</code>.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>STARTASUSER</th>
|
|
||||||
<td>Стандартное имя пользователя. По умолчанию <code>root</code>. Именно данному пользователю будут принадлежать все созданные файлы.</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
<!-- end of config block -->
|
|
||||||
|
|
||||||
<!-- gui block -->
|
|
||||||
<!-- end of gui block -->
|
|
||||||
154
ru/projects/queued.md
Normal file
154
ru/projects/queued.md
Normal file
@ -0,0 +1,154 @@
|
|||||||
|
---
|
||||||
|
category: ru
|
||||||
|
hastr: true
|
||||||
|
layout: project
|
||||||
|
title: queued
|
||||||
|
short: queued
|
||||||
|
tags: linux, shell, демон, система
|
||||||
|
hasgui: false
|
||||||
|
hasdocs: false
|
||||||
|
developers:
|
||||||
|
- Evgeniy Alekseev
|
||||||
|
license: GPLv3
|
||||||
|
links:
|
||||||
|
---
|
||||||
|
<!-- info block -->
|
||||||
|
## <a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация
|
||||||
|
|
||||||
|
Демон для запуска задач в очередь вычислений. Был создан, как proof-of-concept.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ queued --help
|
||||||
|
Simple daemon written on BASH for starting jobs to queue of calculations
|
||||||
|
|
||||||
|
Usage: queued [ -c /etc/queued.conf ] [ -v | --version ] [ -h | --help ]
|
||||||
|
Parametrs:
|
||||||
|
-c PATH - path to configuration file. Default is '/etc/queued.conf'
|
||||||
|
|
||||||
|
-v --version - show version and exit
|
||||||
|
-h --help - show this help and exit
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ add_queued --help
|
||||||
|
add_queued [ -c /etc/queued.conf ] [ -p NUM ] [ -u USER ] [ -h | --help ] /path/to/script
|
||||||
|
|
||||||
|
Parameters:
|
||||||
|
-c PATH - path to configuration file. Default is '/etc/queued.conf'
|
||||||
|
-p NUM - job priority
|
||||||
|
-u USER - username
|
||||||
|
-h --help - show this help and exit
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики
|
||||||
|
|
||||||
|
{% for devel in page.developers %}
|
||||||
|
* {{ devel }}{% endfor %}
|
||||||
|
|
||||||
|
### <a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия
|
||||||
|
|
||||||
|
* {{ page.license }}
|
||||||
|
|
||||||
|
<!-- end of info block -->
|
||||||
|
|
||||||
|
<!-- install block -->
|
||||||
|
## <a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка
|
||||||
|
|
||||||
|
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция
|
||||||
|
|
||||||
|
* Скачайте [архив](//github.com/arcan1s/queued/releases "GitHub") с актуальной версией исходных файлов.
|
||||||
|
* Извлеките из него файлы и установите приложение:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./install.sh "/путь/к/корню/"
|
||||||
|
```
|
||||||
|
|
||||||
|
Если Вы хотите установить в `/`, Вы должны запустить это, как root:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo ./install.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
Если путь не указан, пакет будет установлен в `/`.
|
||||||
|
|
||||||
|
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости
|
||||||
|
|
||||||
|
Все было протестировано на последних версиях зависимостей.
|
||||||
|
|
||||||
|
* Bash (включая awk, grep, sed)
|
||||||
|
* systemd *(опционально, service-файл)*
|
||||||
|
|
||||||
|
<!-- end of install block -->
|
||||||
|
|
||||||
|
<!-- howto block -->
|
||||||
|
## <a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование
|
||||||
|
|
||||||
|
Если Вы хотите запустить демон, просто запустите
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl start queued
|
||||||
|
```
|
||||||
|
|
||||||
|
Если Вы хотите включить автозагрузку демона, запутите
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl enable queued
|
||||||
|
```
|
||||||
|
|
||||||
|
Но Вы можете изменить путь к конфигурационному файлу или изменить параметры. Для этого, скопируйте (рекомендуется) исходный конфигурационный файл
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp /etc/queued.conf /новый/путь/к/queued.conf
|
||||||
|
```
|
||||||
|
|
||||||
|
и отредактируйте его. Затем скопируйте исходный service-файл в `/etc`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp /usr/lib/systemd/system/queued.service /etc/systemd/system/queued-my-profile.service
|
||||||
|
```
|
||||||
|
|
||||||
|
Замените следующую строку в этом файле:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ExecStart=/usr/bin/queued
|
||||||
|
```
|
||||||
|
|
||||||
|
на
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ExecStart=/usr/bin/queued -c /path/to/new/queued.conf
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#adding" class="anchor" id="adding"><span class="octicon octicon-link"></span></a>Добавление задачи
|
||||||
|
|
||||||
|
1. Создайте скрипт с командой (например, с именем `script.sh`).
|
||||||
|
2. Создайте файл с приоритетом (`script.sh.pr`) для данной задачи, если это необходимо.
|
||||||
|
3. Создайте файл с именем пользователя (`script.sh.user`) для данной задачи, если это необходимо
|
||||||
|
4. Скопируйте файлы в `$WORKDIR`
|
||||||
|
|
||||||
|
Также Вы можете воспользоваться `add_queued`.
|
||||||
|
|
||||||
|
## <a href="#configuration" class="anchor" id="configuration"><span class="octicon octicon-link"></span></a>Настройка
|
||||||
|
|
||||||
|
Все настройки хранятся в `/etc/queued.conf`. После редактирования, Вы должны перезапустить демон
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl restart queued
|
||||||
|
```
|
||||||
|
<!-- end of howto block -->
|
||||||
|
|
||||||
|
<!-- config block -->
|
||||||
|
### <a href="#options" class="anchor" id="options"><span class="octicon octicon-link"></span></a>Опции
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|---------|---------|
|
||||||
|
| WORKDIR | Полный путь к директории с исходными файлами задач. По умолчанию `/var/lib/queued/work`. Эта директория должна содержать исходные скрипты `script-name`, файл с приоритетом (если необходимо) `script-name.pr` и файл с именем пользователя (если необходимо) `script-name.user`. |
|
||||||
|
| JOBDIR | Полный путь к директории с запущенными задачами. По умолчанию `/var/lib/queued/job`. Все файлы будут перемещены сюда. |
|
||||||
|
| QUEUEFILE | Полный путь к файлу с очередью вычислений. По умолчанию `/var/lib/queued/queue`. |
|
||||||
|
| PRIORITY | Стандартный приоритет. По умолчанию `0`. Чем выше значение, тем выше приоритет задачи. |
|
||||||
|
| SLEEPTIME | Интервал обновлений в минутах. По умолчанию `5`. |
|
||||||
|
| STARTASUSER | Стандартное имя пользователя. По умолчанию `root`. Именно данному пользователю будут принадлежать все созданные файлы. |
|
||||||
|
<!-- end of config block -->
|
||||||
|
|
||||||
|
<!-- gui block -->
|
||||||
|
<!-- end of gui block -->
|
||||||
@ -1,161 +0,0 @@
|
|||||||
---
|
|
||||||
category: ru
|
|
||||||
hastr: true
|
|
||||||
layout: project
|
|
||||||
title: Report a Bug
|
|
||||||
short: reportabug
|
|
||||||
tags: qt, c++, библиотека, разработка
|
|
||||||
hasgui: false
|
|
||||||
hasdocs: true
|
|
||||||
developers:
|
|
||||||
- Evgeniy Alekseev
|
|
||||||
license: LGPLv3
|
|
||||||
links:
|
|
||||||
---
|
|
||||||
<!-- info block -->
|
|
||||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
|
||||||
<p>Приложение/библиотека, написанное на Qt, которое позволяет пользователям отправлять багрепорт для проектов, расположенных на GitHub. Оно может работать как через <a href="//github.com" title="GitHub">GitHub</a>, так и через <a href="//gitreports.com" title="GitReports">GitReports</a>. Работает нормально, однако данное приложение было создано as proof-of-concept.</p>
|
|
||||||
|
|
||||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
|
||||||
<ul>
|
|
||||||
{% for devel in page.developers %}
|
|
||||||
<li>{{ devel }}</li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
|
||||||
<ul>
|
|
||||||
<li>{{ page.license }}</li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of info block -->
|
|
||||||
|
|
||||||
<!-- install block -->
|
|
||||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
|
||||||
|
|
||||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
|
||||||
<h4><a href="#singleapp" class="anchor" id="singleapp"><span class="octicon octicon-link"></span></a>Сборка, как отдельное приложение</h4>
|
|
||||||
<ul>
|
|
||||||
<li>Скачайте <a href="//github.com/arcan1s/reportabug/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</li>
|
|
||||||
<li>Извлеките из него файлы и настройте под себя.</li>
|
|
||||||
<li>Установите приложение:
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
cd /path/to/extracted/archive
|
|
||||||
mkdir build && cd build
|
|
||||||
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release -DBUILD_AS_LIBRARY:BOOL=0 ../
|
|
||||||
make
|
|
||||||
sudo make install
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h4><a href="#aslibrary" class="anchor" id="aslibrary"><span class="octicon octicon-link"></span></a>Сборка, как библиотека в проекте</h4>
|
|
||||||
<ul>
|
|
||||||
<li>Скачайте <a href="//github.com/arcan1s/reportabug/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</li>
|
|
||||||
<li>Извлеките из него файлы и настройте под себя.</li>
|
|
||||||
<li>Включите библиотеку в Ваш проект. Например, если Вы используете <code>cmake</code>:
|
|
||||||
|
|
||||||
{% highlight cmake %}
|
|
||||||
add_subdirectory (reportabug)
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
</li>
|
|
||||||
<li>Объявите класс в Вашем приложении, например:
|
|
||||||
|
|
||||||
{% highlight cpp %}
|
|
||||||
Reportabug *reportWindow = new Reportabug(parent=this,
|
|
||||||
debugCmd=false,
|
|
||||||
params=0);
|
|
||||||
reportWindow->showWindow();
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
</li>
|
|
||||||
<li>Слинкуйте Ваше приложение с библиотекой.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h4><a href="#cmakeflags" class="anchor" id="cmakeflags"><span class="octicon octicon-link"></span></a>Доступные флаги cmake</h4>
|
|
||||||
<ul>
|
|
||||||
<li><code>-DBUILD_AS_LIBRARY=0</code> - собирать отдельное приложение, а не библиотеку.</li>
|
|
||||||
<li><code>-DBUILD_DOCS=1</code> - собирать документацию для разработчиков.</li>
|
|
||||||
<li><code>-DBUILD_SHARED_LIBRARY=1</code> - собирать библиотеку общего доступа, а не статическую.</li>
|
|
||||||
<li><code>-DENABLE_GITHUB=0</code> - отключить модуль GitHub.</li>
|
|
||||||
<li><code>-DENABLE_GITREPORT=0</code> - отключить модуль GitReports</li>
|
|
||||||
<li><code>-DOWN_GITHUB_TOKEN=STRING</code> - использовать STRING, как свой GitHub токен.</li>
|
|
||||||
<li><code>-DUSE_QT5=0</code> - использовать Qt4 вместо Qt5.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
|
||||||
<p>Все было протестировано на последних версиях зависимостей.</p>
|
|
||||||
<ul>
|
|
||||||
<li>qt5-base <i>(если используется Qt5)</i> <b>или</b> qt4 <i>(если используется Qt4)</i></li>
|
|
||||||
<li>qt5-network (если используется Qt5)</li>
|
|
||||||
<li>automoc4 <i>(make)</i></li>
|
|
||||||
<li>cmake <i>(make)</i></li>
|
|
||||||
<li>doxygen <i>(make, документация)</i></li>
|
|
||||||
<li>qt5-webkit (если используется Qt5) <b>или</b> qtwebkit (если используется Qt4) <i>(опционально, требуется для модуля GitReports)</i></li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of install block -->
|
|
||||||
|
|
||||||
<!-- howto block -->
|
|
||||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
|
||||||
<h3><a href="#github" class="anchor" id="github"><span class="octicon octicon-link"></span></a>Модуль GitHub</h3>
|
|
||||||
<p>Данный модуль создает тикет, используя <a href="//developer.github.com/v3/issues/" title="Документация">GitHub API</a>. Данный модуль требует авторизации пользователя. Типичный POST запрос выглядит так:</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
curl -X POST -u user:pass -d '{"title":"A new bug","body":"Some error occurs"}' \
|
|
||||||
//api.github.com/repos/owner/repo/issues
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>Для того, чтобы отключить данный модуль, используйте <code>-DENABLE_GITHUB=0</code> флаг cmake.</p>
|
|
||||||
|
|
||||||
<p>Также данный модуль может отправлять запросы, используя токен разработчика. Пожалуйста, посетите <a href="//github.com/settings/applications" title="Настройки">данную страницу</a> и сгенерируйте токен. Требуемые права для токена - <b>public_repo</b> (или <b>repo</b>, если Вы используете для приватных репозиториев).<br>
|
|
||||||
<b>Имейте в виду, что передача токена в открытом виде может скомпрометировать его!</b></p>
|
|
||||||
|
|
||||||
<p>Типичный POST запрос выглядит так:</p>
|
|
||||||
|
|
||||||
{% highlight bash %}
|
|
||||||
curl -X POST -H "Authorization: token token" -d '{"title":"A new bug","body":"Some error occurs"}' \
|
|
||||||
//api.github.com/repos/owner/repo/issues
|
|
||||||
{% endhighlight %}
|
|
||||||
|
|
||||||
<p>Для того, чтобы включить данный модуль, используйте <code>-DOWN_GITHUB_TOKEN=STRING</code> флаг cmake.</p>
|
|
||||||
|
|
||||||
<p>Данный модуль требует наличия в системе <code>QtNetwork</code>.</p>
|
|
||||||
|
|
||||||
<h3><a href="#gitreports" class="anchor" id="gitreports"><span class="octicon octicon-link"></span></a>Модуль GitReports</h3>
|
|
||||||
<p>Данный модуль создает тикет, используя возможности <a href="//gitreports.com/about" title="GitReports">GitReports</a>. Пожалуйста, посетите <a href="//gitreports.com/" title="GitReports">данную страницу</a> и настройте под Ваши репозитории.</p>
|
|
||||||
|
|
||||||
<p>Для того, чтобы отключить данный модуль, используйте <code>-DENABLE_GITREPORT=0</code> флаг cmake. Данный модуль требует наличия в системе <code>QtNetwork</code> и <code>QtWebKit</code>.</p>
|
|
||||||
<!-- end of howto block -->
|
|
||||||
|
|
||||||
<!-- config block -->
|
|
||||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
|
||||||
<p>Для настройки перед компиляцией отредактируйте хидер <code>src/config.h</code>. Также Вы можете подгрузить параметры автоматически, используя массив <code>params</code> (необходимые ключи такие же, как и для хидера).</p>
|
|
||||||
<h3><a href="#mainconfig" class="anchor" id="mainconfig"><span class="octicon octicon-link"></span></a>Основные настройки</h3>
|
|
||||||
<ul>
|
|
||||||
<li><code>OWNER</code> - владелец репозитория.</li>
|
|
||||||
<li><code>PROJECT</code> - имя проекта.</li>
|
|
||||||
<li><code>TAG_BODY</code> - тело тикета по умолчанию. Может быть использовано в обоих модулях.</li>
|
|
||||||
<li><code>TAG_TITLE</code> - имя тикета по умолчанию. Может быть использовано только в модуле GitHub.</li>
|
|
||||||
<li><code>TAG_ASSIGNEE</code> - прикрепить тикет к данному аккаунту. Может быть использовано только в модуле GitHub. Данный тег будет работать, только если пользователь имеет права на запись. Если будет пустым, будет проигнорировано.</li>
|
|
||||||
<li><code>TAG_LABELS</code> - установить данные метки тикету. Метки должны быть разделены запятыми. Может быть использовано только в модуле GitHub. Данный тег будет работать, только если пользователь имеет права на запись. Если будет пустым, будет проигнорировано.</li>
|
|
||||||
<li><code>TAG_MILESTONE</code> - установить данную веху тикету. Может быть использовано только в модуле GitHub. Данный тег будет работать, только если пользователь имеет права на запись. Если будет пустым, будет проигнорировано.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#githubconfig" class="anchor" id="githubconfig"><span class="octicon octicon-link"></span></a>Настройки модуля GitHub</h3>
|
|
||||||
<ul>
|
|
||||||
<li><code>GITHUB_COMBOBOX</code> - текст модуля в ComboBox.</li>
|
|
||||||
<li><code>ISSUES_URL</code> - URL, в большинстве случаев, не редактируйте его. По умолчанию <code>//api.github.com/repos/$OWNER/$PROJECT/issues</code>. Доступные теги <code>$PROJECT</code>, <code>$OWNER</code>.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h3><a href="#gitreportsconfig" class="anchor" id="gitreportsconfig"><span class="octicon octicon-link"></span></a>Настройки модуля GitReports</h3>
|
|
||||||
<ul>
|
|
||||||
<li><code>CAPTCHA_URL</code> - URL капчи, в большинстве случаев, не редактируйте его. По умолчанию <code>//gitreports.com/simple_captcha?code=</code>.</li>
|
|
||||||
<li><code>GITREPORT_COMBOBOX</code> - текст модуля в ComboBox.</li>
|
|
||||||
<li><code>PUBLIC_URL</code> - URL, в большинстве случаев, не редактируйте его. По умолчанию <code>//gitreports.com/issue/$OWNER/$PROJECT</code>. Доступные теги <code>$PROJECT</code>, <code>$OWNER</code>.</li>
|
|
||||||
</ul>
|
|
||||||
<!-- end of config block -->
|
|
||||||
|
|
||||||
<!-- gui block -->
|
|
||||||
<!-- end of gui block -->
|
|
||||||
157
ru/projects/reportabug.md
Normal file
157
ru/projects/reportabug.md
Normal file
@ -0,0 +1,157 @@
|
|||||||
|
---
|
||||||
|
category: ru
|
||||||
|
hastr: true
|
||||||
|
layout: project
|
||||||
|
title: Report a Bug
|
||||||
|
short: reportabug
|
||||||
|
tags: qt, c++, библиотека, разработка
|
||||||
|
hasgui: false
|
||||||
|
hasdocs: true
|
||||||
|
developers:
|
||||||
|
- Evgeniy Alekseev
|
||||||
|
license: LGPLv3
|
||||||
|
links:
|
||||||
|
---
|
||||||
|
<!-- info block -->
|
||||||
|
## <a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация
|
||||||
|
|
||||||
|
Приложение/библиотека, написанное на Qt, которое позволяет пользователям отправлять багрепорт для проектов, расположенных на GitHub. Оно может работать как через [GitHub](//github.com "GitHub"), так и через [GitReports](//gitreports.com "GitReports"). Работает нормально, однако данное приложение было создано as proof-of-concept.
|
||||||
|
|
||||||
|
### <a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики
|
||||||
|
|
||||||
|
{% for devel in page.developers %}
|
||||||
|
* {{ devel }}{% endfor %}
|
||||||
|
|
||||||
|
### <a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия
|
||||||
|
|
||||||
|
* {{ page.license }}
|
||||||
|
|
||||||
|
<!-- end of info block -->
|
||||||
|
|
||||||
|
<!-- install block -->
|
||||||
|
## <a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка
|
||||||
|
|
||||||
|
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция
|
||||||
|
### <a href="#singleapp" class="anchor" id="singleapp"><span class="octicon octicon-link"></span></a>Сборка, как отдельное приложение
|
||||||
|
|
||||||
|
* Скачайте [архив](//github.com/arcan1s/reportabug/releases "GitHub") с актуальной версией исходных файлов.
|
||||||
|
* Извлеките из него файлы и настройте под себя.
|
||||||
|
* Установите приложение:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /path/to/extracted/archive
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release -DBUILD_AS_LIBRARY:BOOL=0 ../
|
||||||
|
make
|
||||||
|
sudo make install
|
||||||
|
```
|
||||||
|
|
||||||
|
### <a href="#aslibrary" class="anchor" id="aslibrary"><span class="octicon octicon-link"></span></a>Сборка, как библиотека в проекте
|
||||||
|
|
||||||
|
* Скачайте [архив](//github.com/arcan1s/reportabug/releases "GitHub") с актуальной версией исходных файлов.
|
||||||
|
* Извлеките из него файлы и настройте под себя.
|
||||||
|
* Включите библиотеку в Ваш проект. Например, если Вы используете `cmake`:
|
||||||
|
|
||||||
|
```cmake
|
||||||
|
add_subdirectory (reportabug)
|
||||||
|
```
|
||||||
|
|
||||||
|
* Объявите класс в Вашем приложении, например:
|
||||||
|
|
||||||
|
```cpp
|
||||||
|
Reportabug *reportWindow = new Reportabug(parent=this, debugCmd=false, params=0);
|
||||||
|
reportWindow->showWindow();
|
||||||
|
```
|
||||||
|
|
||||||
|
* Слинкуйте Ваше приложение с библиотекой.
|
||||||
|
|
||||||
|
### <a href="#cmakeflags" class="anchor" id="cmakeflags"><span class="octicon octicon-link"></span></a>Доступные флаги cmake
|
||||||
|
|
||||||
|
* `-DBUILD_AS_LIBRARY=0` - собирать отдельное приложение, а не библиотеку.
|
||||||
|
* `-DBUILD_DOCS=1` - собирать документацию для разработчиков.
|
||||||
|
* `-DBUILD_SHARED_LIBRARY=1` - собирать библиотеку общего доступа, а не статическую.
|
||||||
|
* `-DENABLE_GITHUB=0` - отключить модуль GitHub.
|
||||||
|
* `-DENABLE_GITREPORT=0` - отключить модуль GitReports
|
||||||
|
* `-DOWN_GITHUB_TOKEN=STRING` - использовать STRING, как свой GitHub токен.
|
||||||
|
* `-DUSE_QT5=0` - использовать Qt4 вместо Qt5.
|
||||||
|
|
||||||
|
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости
|
||||||
|
|
||||||
|
Все было протестировано на последних версиях зависимостей.
|
||||||
|
|
||||||
|
* qt5-base *(если используется Qt5)* **или** qt4 *(если используется Qt4)*
|
||||||
|
* qt5-network (если используется Qt5)
|
||||||
|
* automoc4 *(make)*
|
||||||
|
* cmake *(make)*
|
||||||
|
* doxygen *(make, документация)*
|
||||||
|
* qt5-webkit (если используется Qt5) **или** qtwebkit (если используется Qt4) *(опционально, требуется для модуля GitReports)*
|
||||||
|
|
||||||
|
<!-- end of install block -->
|
||||||
|
|
||||||
|
<!-- howto block -->
|
||||||
|
## <a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование
|
||||||
|
|
||||||
|
### <a href="#github" class="anchor" id="github"><span class="octicon octicon-link"></span></a>Модуль GitHub
|
||||||
|
|
||||||
|
Данный модуль создает тикет, используя [GitHub API](//developer.github.com/v3/issues/ "Документация"). Данный модуль требует авторизации пользователя. Типичный POST запрос выглядит так:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST -u user:pass -d '{"title":"A new bug","body":"Some error occurs"}' \
|
||||||
|
//api.github.com/repos/owner/repo/issues
|
||||||
|
```
|
||||||
|
|
||||||
|
Для того, чтобы отключить данный модуль, используйте `-DENABLE_GITHUB=0` флаг cmake.
|
||||||
|
|
||||||
|
Также данный модуль может отправлять запросы, используя токен разработчика. Пожалуйста, посетите [данную страницу](//github.com/settings/applications "Настройки") и сгенерируйте токен. Требуемые права для токена - **public_repo** (или **repo**, если Вы используете для приватных репозиториев).
|
||||||
|
|
||||||
|
**Имейте в виду, что передача токена в открытом виде может скомпрометировать его!**
|
||||||
|
|
||||||
|
Типичный POST запрос выглядит так:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST -H "Authorization: token token" -d '{"title":"A new bug","body":"Some error occurs"}' \
|
||||||
|
//api.github.com/repos/owner/repo/issues
|
||||||
|
```
|
||||||
|
|
||||||
|
Для того, чтобы включить данный модуль, используйте `-DOWN_GITHUB_TOKEN=STRING` флаг cmake.
|
||||||
|
|
||||||
|
Данный модуль требует наличия в системе `QtNetwork`.
|
||||||
|
|
||||||
|
### <a href="#gitreports" class="anchor" id="gitreports"><span class="octicon octicon-link"></span></a>Модуль GitReports
|
||||||
|
|
||||||
|
Данный модуль создает тикет, используя возможности [GitReports](//gitreports.com/about "GitReports"). Пожалуйста, посетите [данную страницу](//gitreports.com/ "GitReports") и настройте под Ваши репозитории.
|
||||||
|
|
||||||
|
Для того, чтобы отключить данный модуль, используйте `-DENABLE_GITREPORT=0` флаг cmake. Данный модуль требует наличия в системе `QtNetwork` и `QtWebKit`.
|
||||||
|
|
||||||
|
<!-- end of howto block -->
|
||||||
|
|
||||||
|
<!-- config block -->
|
||||||
|
## <a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка
|
||||||
|
|
||||||
|
Для настройки перед компиляцией отредактируйте хидер `src/config.h`. Также Вы можете подгрузить параметры автоматически, используя массив `params` (необходимые ключи такие же, как и для хидера).
|
||||||
|
|
||||||
|
### <a href="#mainconfig" class="anchor" id="mainconfig"><span class="octicon octicon-link"></span></a>Основные настройки
|
||||||
|
|
||||||
|
* `OWNER` - владелец репозитория.
|
||||||
|
* `PROJECT` - имя проекта.
|
||||||
|
* `TAG_BODY` - тело тикета по умолчанию. Может быть использовано в обоих модулях.
|
||||||
|
* `TAG_TITLE` - имя тикета по умолчанию. Может быть использовано только в модуле GitHub.
|
||||||
|
* `TAG_ASSIGNEE` - прикрепить тикет к данному аккаунту. Может быть использовано только в модуле GitHub. Данный тег будет работать, только если пользователь имеет права на запись. Если будет пустым, будет проигнорировано.
|
||||||
|
* `TAG_LABELS` - установить данные метки тикету. Метки должны быть разделены запятыми. Может быть использовано только в модуле GitHub. Данный тег будет работать, только если пользователь имеет права на запись. Если будет пустым, будет проигнорировано.
|
||||||
|
* `TAG_MILESTONE` - установить данную веху тикету. Может быть использовано только в модуле GitHub. Данный тег будет работать, только если пользователь имеет права на запись. Если будет пустым, будет проигнорировано.
|
||||||
|
|
||||||
|
### <a href="#githubconfig" class="anchor" id="githubconfig"><span class="octicon octicon-link"></span></a>Настройки модуля GitHub
|
||||||
|
|
||||||
|
* `GITHUB_COMBOBOX` - текст модуля в ComboBox.
|
||||||
|
* `ISSUES_URL` - URL, в большинстве случаев, не редактируйте его. По умолчанию `//api.github.com/repos/$OWNER/$PROJECT/issues`. Доступные теги `$PROJECT`, `$OWNER`.
|
||||||
|
|
||||||
|
### <a href="#gitreportsconfig" class="anchor" id="gitreportsconfig"><span class="octicon octicon-link"></span></a>Настройки модуля GitReports
|
||||||
|
|
||||||
|
* `CAPTCHA_URL` - URL капчи, в большинстве случаев, не редактируйте его. По умолчанию `//gitreports.com/simple_captcha?code=`.
|
||||||
|
* `GITREPORT_COMBOBOX` - текст модуля в ComboBox.
|
||||||
|
* `PUBLIC_URL` - URL, в большинстве случаев, не редактируйте его. По умолчанию `//gitreports.com/issue/$OWNER/$PROJECT`. Доступные теги `$PROJECT`, `$OWNER`.
|
||||||
|
|
||||||
|
<!-- end of config block -->
|
||||||
|
|
||||||
|
<!-- gui block -->
|
||||||
|
<!-- end of gui block -->
|
||||||
Loading…
Reference in New Issue
Block a user