Add html help and man-page

README.md

@@ -1,13 +1,11 @@
 # Rackman
 Утилита, позволяющая измерять растояния в пикселях, миллиметрах, дюймах и пунктах Adobe на экране вашего монитора. 
 Представляет собой два окна:
-  1. **главное** (*Master*), содержащее численную информацию и меню;
-  2. **дочернее** (*Slave*), представляющее собой некий измерительный инструмент.
+1. **главное** (*Master*), содержащее численную информацию и меню;
+2. **дочернее** (*Slave*), представляющее собой некий измерительный инструмент.
 
 Написана на Python и GTK.
 
-![Главное окно](https://leto13f.storage.yandex.net/rdisk/83da2574401a797cf1e9fc55a4f6b157efea66d656a67be37ff4bdd29933046f/inf/nCP3UpOegGpBSReEjv4i7VzLOqy08WIEkBBDGuVYljZk6YkOrnd-QXg3YkeK7wS23szsVPkUIpyKN_V2YqrWhA==?uid=84330535&filename=master_1.9.0.png&disposition=inline&hash=&limit=0&content_type=image%2Fpng&tknv=v2&rtoken=5ab844437887d2e4a2555aab636f2d71&force_default=yes&ycrid=na-12b166efaf52cf94cf0fc3e3c8d4d1e2-downloader10g)
-
 ## Размеры
 Rackman позволяет измерять высоту и ширину объектов на экране.
 
@@ -70,3 +68,11 @@ https://github.com/msva/mva-overlay/blob/master/x11-misc/rackman/rackman-9999.eb
 - Изменение цвета и прозрачности с клавиатуры работает только для Master-окна (окно должно быть в фокусе)
 - Центральные прерывистые линии могут быть несколько размазаны при чётных высоте или ширине окна. Это особенности рендринга gtk и cairo линий располагающихся "между пикселей"
 - Размеры по вертикали для производных единиц (все кроме px) могут быть несколько меньше реальных (~0.5mm)
+
+## License
+MIT License
+
+## Authors
+(C) 2015-2016 Николай Волков <[email protected]>
+
+<https://github.com/FRiMN/Rackman>

doc/man/ru/rackman

@@ -0,0 +1,107 @@
+.TH RACKMAN 1 2016-04-17 1.11.0 ""
+.SH Rackman
+.PP
+Утилита, позволяющая измерять растояния в пикселях, миллиметрах, дюймах
+и пунктах Adobe на экране вашего монитора.
+Представляет собой два окна: 1.
+\f[B]главное\f[] (\f[I]Master\f[]), содержащее численную информацию и
+меню; 2.
+\f[B]дочернее\f[] (\f[I]Slave\f[]), представляющее собой некий
+измерительный инструмент.
+.PP
+Написана на Python и GTK.
+.SS Размеры
+.PP
+Rackman позволяет измерять высоту и ширину объектов на экране.
+.PP
+[IMAGE: Измерение
+высоты (https://img-fotki.yandex.ru/get/4512/84330535.0/0_ac93c_9af2e4be_orig)]
+.SS Диагональ
+.PP
+Rackman позволяет измерять длину диагонали.
+.SS Углы
+.PP
+Rackman позволяет измерять горизональные и вертикальные углы.
+.PP
+[IMAGE: Измерение
+углов (https://img-fotki.yandex.ru/get/6302/84330535.0/0_ac7db_66af0cdf_orig)]
+.SS Центры
+.PP
+Rackman позволяет визуально отслеживать центрирование.
+.PP
+[IMAGE: Центровка (https://img-fotki.yandex.ru/get/1/84330535.0/0_ac842_121e24fb_orig)]
+.SS Управление дочерним окном измерения (Slave)
+.IP \[bu] 2
+Попиксельное изменение ширины и высоты окна
+.IP \[bu] 2
+←, ↑, →, ↓
+.IP \[bu] 2
+Попиксельное перемещение окна
+.IP \[bu] 2
+Ctrl + ←, ↑, →, ↓
+.IP \[bu] 2
+Быстрое изменение размеров и перемещение окна
+.IP \[bu] 2
+Shift + ←, ↑, →, ↓
+.IP \[bu] 2
+Shift + Ctrl + ←, ↑, →, ↓
+.IP \[bu] 2
+используйте нативные методы вашего DE.
+.SS Установка и запуск
+.SS Stand\-alone версия
+.IP
+.nf
+\f[C]
+#\ скачивание\ последней\ версии
+$\ wget\ https://github.com/FRiMN/Rackman/archive/master.zip
+#\ распаковка
+$\ unzip\ master.zip
+#\ переход\ в\ директорию
+$\ cd\ ./Rackman\-master/
+#\ установка\ прав\ на\ чтение\ и\ выполнение\ всем\ и\ на\ запись\ пользователю
+$\ chmod\ u=rwx,g=rx,o=rx\ rackman.py
+#\ запуск\ Rackman
+$\ ./rackman.py
+\f[]
+.fi
+.SS Установка из репозиториев (только для Ubuntu)
+.IP
+.nf
+\f[C]
+$\ sudo\ add\-apt\-repository\ ppa:freezemandix/rackman
+$\ sudo\ apt\-get\ update
+$\ sudo\ apt\-get\ install\ rackman
+\f[]
+.fi
+.SS ebuild для Gentoo
+.PP
+https://github.com/msva/mva\-overlay/blob/master/x11\-misc/rackman/rackman\-9999.ebuild
+.SS Известные баги и особенности
+.IP \[bu] 2
+Измеритель \[en] обычное окно, со всеми вытекающими (например: нельзя
+померить в местах недоступных для размещения окон)
+.IP \[bu] 2
+Быстрое перемещение и изменение размера окна измерения полностью зависит
+от натроек вашего DE
+.IP \[bu] 2
+Если в вашем DE есть умное поведение окон (прилипание и т.п.), то оно
+будет применяться и к измерителю, что не всегда удобно
+.IP \[bu] 2
+Изменение цвета и прозрачности с клавиатуры работает только для
+Master\-окна (окно должно быть в фокусе)
+.IP \[bu] 2
+Центральные прерывистые линии могут быть несколько размазаны при чётных
+высоте или ширине окна.
+Это особенности рендринга gtk и cairo линий располагающихся \[lq]между
+пикселей\[rq]
+.IP \[bu] 2
+Размеры по вертикали для производных единиц (все кроме px) могут быть
+несколько меньше реальных (~0.5mm)
+.SS License
+.PP
+MIT License
+.SS Authors
+.IP "(c)" 4
+2015\-2016 Николай Волков <[email protected]>
+.PP
+<https://github.com/FRiMN/Rackman>

rackman.py

@@ -2,12 +2,12 @@
 # -*- coding: utf-8 -*-
 
 # This software uses semantic versioning (SemVer v2.0.0).
-# Copyright: (c) 2015 by Nik Volkov.
+# Copyright: (c) 2015-2016 by Nik Volkov.
 # License: MIT, see LICENSE for more details.
 
 
-#import pygtk
-#pygtk.require('2.4')
+import pygtk
+pygtk.require('2.0')
 import gtk
 import cairo
 import math
@@ -17,7 +17,7 @@
 
 
 
-__version__ = '1.10.0'
+__version__ = '1.11.1'
 
 
 
@@ -187,6 +187,7 @@ def generate_menu(self):
     items.append( ('/{}'.format(    _('_Tools') ),                    None,               None,                   0,  '<Branch>') )
     items.append( ('/{}/{}'.format( _('Tools'), _('Rotate') ),        '<ctrl>R',          self.size_change,       1,  '<Item>') )
     items.append( ('/{}/{}'.format( _('Tools'), _('Fix 100%') ),      '<ctrl>F',          self.fix_percent,       2,  '<Item>') )
+    items.append( ('/{}/{}'.format( _('Tools'), _('Help') ),          '<ctrl>H',          self.open_help,         3,  '<Item>') )
 
     return items
 
@@ -296,6 +297,20 @@ def __init__(self):
         self.window.show()
 
 
+    def open_help(self, ret, widget):
+        import webbrowser
+        urls = (
+            os.path.realpath('./doc/html/ru/index.html'),
+            '/usr/share/doc/rackman/html/ru/index.html',
+        )
+        for url in urls:
+            print 'Try open {}'.format(url)
+            if os.path.isfile(url):
+                print '\t ...open in webbrowser'
+                webbrowser.open(url)
+                break
+
+
     def color_change(self, ret, widget):
         color_name = widget.name.split('/')[-1]
         color_context = widget.name.split('/')[-2]

setup.py

@@ -20,12 +20,14 @@
                             ('/usr/share/rackman', ['rackman.conf']),
                             ('/usr/share/locale/ru/LC_MESSAGES', ['./locale/ru/LC_MESSAGES/rackman.mo']),
                             ('/usr/share/locale/en/LC_MESSAGES', ['./locale/en/LC_MESSAGES/rackman.mo']),
+                            ('/usr/share/doc/rackman/html/ru', ['./doc/html/ru/index.html']),
+                            ('/usr/share/man/ru/man1', ['./doc/man/ru/rackman.1.gz']),
                         ],
       obsoletes     =   [
                             'Rackman',
                         ],
       requires      =   [
-                            'PyGTK (>=2.4)',
+                            'PyGTK (>=2.0)',
                         ],
       scripts       =   [
                             'rackman'