Add Italian translation file

README.md

@@ -1,8 +1,33 @@
 # Safe Eyes
+
+[![GitHub version](https://badge.fury.io/gh/slgobinath%2FSafeEyes.svg)](https://badge.fury.io/gh/slgobinath%2FSafeEyes)
+[![PyPI version](https://badge.fury.io/py/safeeyes.svg)](https://badge.fury.io/py/safeeyes)
+[![Translation status](https://hosted.weblate.org/widgets/safe-eyes/-/translations/svg-badge.svg)](https://hosted.weblate.org/engage/safe-eyes/?utm_source=widget)
+
+
 Protect your eyes from eye strain using this simple and beautiful, yet extensible break reminder. A Free and Open Source Linux alternative to EyeLeo.
 
 Visit to the official site: http://slgobinath.github.io/SafeEyes/ for more details.
 
+## Safe Eyes command-line arguements
+```
+usage: safeeyes [-h] [-a | -d | -e | -q | -s | -t] [--debug] [--version]
+
+Safe Eyes protects your eyes from eye strain (asthenopia) by reminding you to
+take breaks while you're working long hours at the computer.
+
+optional arguments:
+  -h, --help        show this help message and exit
+  -a, --about       show the about dialog
+  -d, --disable     disable the currently running safeeyes instance
+  -e, --enable      enable the currently running safeeyes instance
+  -q, --quit        quit the running safeeyes instance and exit
+  -s, --settings    show the settings dialog
+  -t, --take-break  take a break now
+  --debug           start safeeyes in debug mode
+  --version         show program's version number and exit
+```
+
 ## Installation guide
 Safe Eyes is available in Ubuntu PPA, Arch AUR and Python PyPI. You can choose any installation source and install on any Linux system with Python 3. To see how to install Safe Eyes, visit [Getting Started](http://slgobinath.github.io/SafeEyes/#introduction)
 
@@ -15,7 +40,7 @@ Ensure to meet the following dependencies when compiling from source:
 - python3-psutil
 - xprintidle (optional)
 
-## Writing Plug-in for Safe Eyes
+## Writing Safe Eyes plug-in
 A plugin is a combination of two files: `plugin.py` and `config.json`. These two files must be placed in a directory: `~/.config/safeeyes/plugins/<plugin-id>`. Optionally a plugin also can have an image file `icon.png` which is used to represent the plugin in the Settings dialog.
 
 For example, a Weather plugin may have the following file structure:
@@ -30,7 +55,7 @@ For example, a Weather plugin may have the following file structure:
                 └── plugin.py
 ```
 
-The `icon.png` must be `24x24` pixels size. If `icon.png` is not available, the default gear icon <img src="https://github.com/slgobinath/SafeEyes/raw/safeeyes-2.0.0/safeeyes/resource/ic_plugin.png" width="16" height="16"/> will be shown in the Settings dialog.
+The `icon.png` must be `24x24` pixels size. If `icon.png` is not available, the default gear icon <img src="https://github.com/slgobinath/SafeEyes/raw/master/safeeyes/resource/ic_plugin.png" width="16" height="16"/> will be shown in the Settings dialog.
 
 A sample `config.json` is provided below:
 ```json
@@ -68,9 +93,93 @@ A sample `config.json` is provided below:
 The `meta` properties must provide the name of the plugin, a short description and the current version of the plugin.
 
 The `dependencies` property defines various dependency constraints of the plugin. The dependencies can be Python modules, commandline tools, desktop environments or Safe Eyes resources. The `operating_systems` property is reserved for operating system dependency but not checked for at the moment.
-If a dependency is not available, the Safe Eyes will not load the plugin. The Settings dialog will show a warning symbol <img src="https://github.com/slgobinath/SafeEyes/raw/safeeyes-2.0.0/safeeyes/resource/ic_warning.png" width="16" height="16"> and a message to install/check the missing dependencies. Dependencies are checked in the order of *Desktop Environment*, *Python Modules*, *Commandline Tools* and *Resources*. If a dependency is not available, Safe Eyes will stop looking for the rest.
+If a dependency is not available, the Safe Eyes will not load the plugin. The Settings dialog will show a warning symbol <img src="https://github.com/slgobinath/SafeEyes/raw/master/safeeyes/resource/ic_warning.png" width="16" height="16"> and a message to install/check the missing dependencies. Dependencies are checked in the order of *Desktop Environment*, *Python Modules*, *Commandline Tools* and *Resources*. If a dependency is not available, Safe Eyes will stop looking for the rest.
 
 The configurations related to the plugin must be defined in `settings`. Each setting must have an `id`, `label`, `type` and a default value matching the `type`. Safe Eyes 2.0.0 supports only the following types: `INT`, `TEXT` and `BOOL`. According to the types, Settings dialog will show a *Spin*, *Text Field* or *Switch Button* as the input field.
+
+The optional `break_override_allowed` property lets users to override the status of plugins by enable or disable based on break.
+
+The `plugin.py` can have the following **optional** functions:
+
+```python
+def on_init(context, safeeyes_config, plugin_config):
+    """
+    Executes after loading the plugin for the first time and after every changes in configuration.
+    """
+    pass
+
+def on_start():
+    """
+    Executes when Safe Eyes is enabled.
+    """
+    pass
+
+def on_stop():
+    """
+    Executes when Safe Eyes is disabled.
+    """
+    pass
+
+def enable():
+    """
+    Executes after plugin.py is loaded as a module.
+    """
+    pass
+
+def disable():
+    """
+    Executes after disabling the plugin at the runtime.
+    """
+    pass
+
+def update_next_break(date_time):
+    """
+    Update the next break time.
+    """
+    pass
+
+def on_pre_break(break_obj):
+    """
+    Executes before on_start_break break.
+    """
+    pass
+
+def on_start_break(break_obj):
+    """
+    Executes when starting a break.
+    """
+    pass
+
+def on_countdown(countdown, seconds):
+    """
+    Keep track of seconds passed from the beginning of break.
+    """
+    pass
+
+def on_stop_break():
+    """
+    Executes at the end of breaks.
+    """
+    pass
+
+def on_exit():
+    """
+    Executes before Safe Eyes exits
+    """
+    pass
+
+def get_widget_title(break_obj):
+    """
+    Return the widget title.
+    """
+    return 'Widget Title'
+
+def get_widget_content(break_obj):
+    """
+    Return the widget content.
+    """
+    return 'Widget Content'
+```
 ## License
 
 GNU General Public License v3

safeeyes/config/locale/it/LC_MESSAGES/safeeyes.po

@@ -0,0 +1,309 @@
+# SAFE EYES ENGLISH TRANSLATION.
+# Copyright (C) 2017 Gobinath
+# Gobinath slgobinath@gmail.com, 2017.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: \n"
+"POT-Creation-Date: \n"
+"PO-Revision-Date: \n"
+"Language-Team: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"X-Generator: Poedit 1.8.7.1\n"
+"Last-Translator: \n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Language: it\n"
+
+# Short Breaks
+msgid "Tightly close your eyes"
+msgstr ""
+
+msgid "Roll your eyes a few times to each side"
+msgstr ""
+
+msgid "Rotate your eyes in clockwise direction"
+msgstr ""
+
+msgid "Rotate your eyes in counterclockwise direction"
+msgstr ""
+
+msgid "Blink your eyes"
+msgstr ""
+
+msgid "Focus on a point in the far distance"
+msgstr ""
+
+msgid "Have some water"
+msgstr ""
+
+# Long Breaks
+msgid "Walk for a while"
+msgstr ""
+
+msgid "Lean back at your seat and relax"
+msgstr ""
+
+# Commandline Arguments
+msgid "show the about dialog"
+msgstr ""
+
+msgid "disable the currently running safeeyes instance"
+msgstr ""
+
+msgid "enable the currently running safeeyes instance"
+msgstr ""
+
+msgid "quit the running safeeyes instance and exit"
+msgstr ""
+
+msgid "show the settings dialog"
+msgstr ""
+
+msgid "start safeeyes in debug mode"
+msgstr ""
+
+# AboutDialog
+msgid "Close"
+msgstr ""
+
+msgid "description"
+msgstr ""
+
+msgid "License"
+msgstr ""
+
+# BreakScreen
+msgid "Skip"
+msgstr ""
+
+msgid "Postpone"
+msgstr ""
+
+# Settings dialog
+msgid "Break duration (in seconds)"
+msgstr ""
+
+msgid "Interval between two breaks (in minutes)"
+msgstr ""
+
+msgid "Time to prepare for a break (in seconds)"
+msgstr ""
+
+msgid "Keyboard shortcuts disabled period (in seconds)"
+msgstr ""
+
+msgid "Postpone duration (in minutes)"
+msgstr ""
+
+msgid "Strict break (No way to skip breaks)"
+msgstr ""
+
+msgid "Allow postponing breaks"
+msgstr ""
+
+msgid "Persist the internal state"
+msgstr ""
+
+msgid "Long break interval must be a multiple of short break interval"
+msgstr ""
+
+msgid "Options"
+msgstr ""
+
+msgid "Short Breaks"
+msgstr ""
+
+msgid "Long Breaks"
+msgstr ""
+
+msgid "Break"
+msgstr ""
+
+msgid "Breaks"
+msgstr ""
+
+msgid "Plugins"
+msgstr ""
+
+msgid "Type"
+msgstr ""
+
+msgid "Short"
+msgstr ""
+
+msgid "Long"
+msgstr ""
+
+msgid "Image"
+msgstr ""
+
+msgid "Select"
+msgstr ""
+
+msgid "Please select an image"
+msgstr ""
+
+msgid "Duration"
+msgstr ""
+
+msgid "Override"
+msgstr ""
+
+msgid "Time (in seconds)"
+msgstr ""
+
+msgid "Break Settings"
+msgstr ""
+
+msgid "Plugin Settings"
+msgstr ""
+
+msgid "Plugin does not support %s desktop environment"
+msgstr ""
+
+msgid "Please install the Python module '%s'"
+msgstr ""
+
+msgid "Please install the command-line tool '%s'"
+msgstr ""
+
+msgid "Please add the resource %(resource)s to %(config_resource)s directory"
+msgstr ""
+
+msgid "New Break"
+msgstr ""
+
+msgid "Remove"
+msgstr ""
+
+msgid "Discard"
+msgstr ""
+
+msgid "Save"
+msgstr ""
+
+# plugin/audiblealert
+msgid "Audible Alert"
+msgstr ""
+
+msgid "Play an audible alert at the end of breaks"
+msgstr ""
+
+# plugin/donotdisturb
+msgid "Do Not Disturb"
+msgstr ""
+
+msgid "Skip the break if the active window is in fullscreen mode"
+msgstr ""
+
+msgid "Do not interrupt these windows anytime"
+msgstr ""
+
+msgid "Interrupt these windows regardless of their state"
+msgstr ""
+
+msgid "Switch the interruptible windows to normal mode"
+msgstr ""
+
+# plugin/healthstats
+msgid "Health Statistics"
+msgstr ""
+
+msgid "Show statistics based on how you use Safe Eyes"
+msgstr ""
+
+# plugin/notification
+msgid "Notification"
+msgstr ""
+
+msgid "Show a system notification before breaks"
+msgstr ""
+
+msgid "Ready for a short break in %s seconds"
+msgstr ""
+
+msgid "Ready for a long break in %s seconds"
+msgstr ""
+
+# plugin/screensaver
+msgid "Screensaver"
+msgstr ""
+
+msgid "Lock the screen after long breaks by starting screensaver"
+msgstr ""
+
+msgid "Custom screensaver command"
+msgstr ""
+
+msgid "Minimum seconds to skip without screensaver"
+msgstr ""
+
+# plugin/smartpause
+msgid "Smart Pause"
+msgstr ""
+
+msgid "Pause Safe Eyes if the system is idle"
+msgstr ""
+
+msgid "Minimum idle time to pause Safe Eyes"
+msgstr ""
+
+#: plugins/trayicon
+msgid "Tray Icon"
+msgstr ""
+
+msgid "Show a tray icon in the notification area"
+msgstr ""
+
+msgid "Show next break time in tray icon"
+msgstr ""
+
+msgid "About"
+msgstr ""
+
+msgid "Disable Safe Eyes"
+msgstr ""
+
+msgid "Disabled until %s"
+msgstr ""
+
+msgid "Disabled until restart"
+msgstr ""
+
+msgid "Enable Safe Eyes"
+msgstr ""
+
+msgid "For %d Hour"
+msgid_plural "For %d Hours"
+msgstr[0] ""
+msgstr[1] ""
+
+msgid "For %d Minute"
+msgid_plural "For %d Minutes"
+msgstr[0] ""
+msgstr[1] ""
+
+msgid "For %d Second"
+msgid_plural "For %d Seconds"
+msgstr[0] ""
+msgstr[1] ""
+
+msgid "Next break at %s"
+msgstr ""
+
+msgid "No Breaks Available"
+msgstr ""
+
+msgid "Settings"
+msgstr ""
+
+msgid "Take a break now"
+msgstr ""
+
+msgid "Until restart"
+msgstr ""
+
+msgid "Quit"
+msgstr ""