add migration notes

_posts/2014-09-04-migration-to-v2.html

@@ -0,0 +1,38 @@
+---
+category: en
+type: paper
+hastr: true
+layout: paper
+tags: awesome-widgets, pytextmonitor
+title: Migration Awesome Widgets (ex-PyTextMonitor) to version 2.0
+short: migration-to-v2
+description: <figure class="img"><img src="/resources/papers/broken-computer.jpg" alt="broken-computer"></figure>Some significant changes occur in the version 2.0 (really, I didn't do anything which can break your desktop!) and user API was rewritten. This paper should help to migrate from older PyTextMonitor versions (<1.11.0) to new one (>2.0).
+---
+<h2><a href="#new" class="anchor" id="new"><span class="octicon octicon-link"></span></a>New features</h2>
+<p>Firstly, a series of new features, including:</p>
+
+<ul>
+  <li>New widget - <b>Desktop panel</b>. It shows desktop list and select the active one. It can switch to the selected desktop by mouse clicking. Also it may set selected panels hidden.</li>
+  <li>New tags - <code>hddfreemb</code>, <code>hddfreegb</code>, <code>memusedmb</code>, <code>memusedgb</code>, <code>memfreemb</code>, <code>memfreegb</code>, <code>swapfreemb</code>, <code>swapfreegb</code>. And there are new tags related to new features - <code>desktop</code>, <code>ndesktop</code>, <code>tdesktops</code>.</li>
+  <li>New graphical tooltip - battery. It is twin colour (the colour depends on AC status).</li>
+</ul>
+
+<h2><a href="#changes" class="anchor" id="changes"><span class="octicon octicon-link"></span></a>Significant changes</h2>
+<p>Secondly, there are some changes because of which the old settings <b>will not</b> more work. They are:</p>
+
+<ul>
+  <li>The main widget was rewritten to <code>С++</code>, so the project was renamed to <b>Awesome Widgets</b>, and the main widget was done to <b>Awesome Widget</b></li>
+  <li>Configuration of battery and AC files <b>was moved to DataEngine</b>.</li>
+  <li><b>The labels was removed</b>. Now the widget is a single label. You may set up text in the special browser.</li>
+  <li>All tags should be framed by <code>$</code> <b>on both sides</b>. This changes was caused by code optimization, it allows me to reduce one of the classes to over9000 times.</li>
+  <li>According to fields combining several tags were renamed:
+  <ul>
+    <li><code>custom</code> (time) -&gt; <code>ctime</code></li>
+    <li><code>custom</code> (uptime) -&gt; <code>cuptime</code></li>
+    <li><code>time</code> (player) -&gt; <code>duration</code></li>
+  </ul>
+  </li>
+  <li>According to removal of the label, tooltip <b>should be configured separately</b>.</li>
+</ul>
+
+<p>On any issues related to the migration, feel free to leave a comment here.</p>

projects/awesome-widgets.html

@@ -17,6 +17,7 @@ links:
     - Plasmoid page on <a href="http://kde-look.org/content/show.php/Py+Text+Monitor?content=157124" title="kde-look">kde-look.org</a>
     - DataEngine page on <a href="http://kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773" title="kde-look">kde-look.org</a>
     - Archlinux <a href="https://aur.archlinux.org/packages/kdeplasma-applets-awesome-widgets" title="AUR">AUR package</a>
+    - <a href="/en/2014/09/04/migration-to-v2/" title="Migration">Migration to version 2.0</a>
 ---
 <!-- info block -->
 <h2><a href="#information" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information</h2>

ru/_posts/2014-09-04-migration-to-v2.html

@@ -0,0 +1,38 @@
+---
+category: ru
+type: paper
+hastr: true
+layout: paper
+tags: awesome-widgets, pytextmonitor
+title: Миграция Awesome Widgets (ex-PyTextMonitor) на версию 2.0
+short: migration-to-v2
+description: <figure class="img"><img src="/resources/papers/broken-computer.jpg" alt="broken-computer"></figure>В версии 2.0 произошел ряд значительных изменений (совершенно случайно, само по себе, я тут не при чем) и было полностью переписано пользовательское API. Данная статья призвана облегчить миграцию со старых версий PyTextMonitor (<1.11.0) на новую (>2.0).
+---
+<h2><a href="#new" class="anchor" id="new"><span class="octicon octicon-link"></span></a>Новые фичи</h2>
+<p>Во-первых, это ряд нововведений, среди которых:</p>
+
+<ul>
+  <li>Новый виджет - <b>Desktop panel</b>. Показывает список рабочих столов, выделяя активный. Умеет переключаться между ними по клику. Также умеет скрывать выбранные панели по хоткею.</li>
+  <li>Новые теги - <code>hddfreemb</code>, <code>hddfreegb</code>, <code>memusedmb</code>, <code>memusedgb</code>, <code>memfreemb</code>, <code>memfreegb</code>, <code>swapfreemb</code>, <code>swapfreegb</code>. А также новые теги, связанные с новыми возможностями - <code>desktop</code>, <code>ndesktop</code>, <code>tdesktops</code>.</li>
+  <li>Новый графический тултип - батарея. Двухцветный, в зависимости от статуса адаптора питания.</li>
+</ul>
+
+<h2><a href="#changes" class="anchor" id="changes"><span class="octicon octicon-link"></span></a>Значительные изменения</h2>
+<p>Во-вторых, и это главное - произошел ряд изменений, из-за которых старые настройки <b>не будут</b> более работать. Среди пользовательских следует выделить:</p>
+
+<ul>
+  <li>Переписка основного виджета на <code>С++</code>, что вызвало переименование проекта в <b>Awesome Widgets</b>, а главного виджета в <b>Awesome Widget</b></li>
+  <li>Настройки файлов батареи и адаптора питания <b>вынесены в DataEngine</b>.</li>
+  <li><b>Убраны поля</b>. Теперь виджет представляет собой монолитное поле. Текст настраивается в специальном браузере.</li>
+  <li>Все теги теперь должны обрамляться знаком <code>$</code> <b>с двух сторон</b>. Это изменение связано с оптимизацией кода и позволило сократить один из вспомогательных классов в over9000 раз.</li>
+  <li>В связи с объединением полей, несколько тегов были переименованы:
+  <ul>
+    <li><code>custom</code> (время) -&gt; <code>ctime</code></li>
+    <li><code>custom</code> (время работы) -&gt; <code>cuptime</code></li>
+    <li><code>time</code> (плеер) -&gt; <code>duration</code></li>
+  </ul>
+  </li>
+  <li>В связи с удалением отдельных полей, тултип теперь <b>настраивается отдельно</b>.</li>
+</ul>
+
+<p>По любым проблемам, связанным с миграцией, не стесняйтесь оставлять здесь комментарий.</p>

ru/projects/awesome-widgets.html

@@ -18,6 +18,7 @@ links:
     - Страница плазмоида на <a href="http://kde-look.org/content/show.php/Py+Text+Monitor?content=157124" title="kde-look">kde-look.org</a>
     - Страница DataEngine на <a href="http://kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773" title="kde-look">kde-look.org</a>
     - Пакет в <a href="https://aur.archlinux.org/packages/kdeplasma-applets-awesome-widgets" title="AUR">AUR</a>
+    - <a href="/ru/2014/09/04/migration-to-v2/" title="Миграция">Миграция на версию 2.0</a>
 ---
 <!-- info block -->
 <h2><a href="#information" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>