Merge branch 'master' of https://github.com/streetturtle/awesome-wm-widgets

weather-widget/README.md

@@ -1,17 +1,47 @@
 # Weather widget
 
-![Weather Widget](./weather-widget.png)
+![Weather Widget]({{'/assets/img/screenshots/weather-widget.png' | relative_url }}){:.center-image}
 
 Note that widget uses the Arc icon theme, so it should be [installed](https://github.com/horst3180/arc-icon-theme#installation) first under **/usr/share/icons/Arc/** folder.
 
 ## Installation
 
- - install lua socket
-```bash
-$ sudo apt-get install lua-socket
-```
+1. Install lua socket - to make HTTP calls to get the weather information.
+
+    ```bash
+    $ sudo apt-get install lua-socket
+    ```
+
+1. Download json parser for lua from [github.com/rxi/json.lua](https://github.com/rxi/json.lua) and place it under **~/.config/awesome/** (don't forget to star a repo <i class="fa fa-github-alt"></i> ):
+
+    ```bash
+    wget -P ~/.config/awesome/ https://raw.githubusercontent.com/rxi/json.lua/master/json.lua
+    ```
+
+1. Clone this repo under **~/.config/awesome/**:
+
+    ```bash
+    git clone https://github.com/streetturtle/awesome-wm-widgets.git ~/.config/awesome/
+    ```
+
+1.  Get Open Weather Map app id here: [openweathermap.org/appid](https://openweathermap.org/appid) and place it in  **~/.config/awesome/awesome-wm-widgets/secrets.lua**, or directly in the widget. Don't forget to set also your city.
+
+1. Require weather widget at the beginning of **rc.lua**:
+
+    ```lua
+    local weather_widget = require("awesome-wm-widgets.weather-widget.weather")
+    ```
+
+1. Add widget to the tasklist:
+
+    ```lua
+    s.mytasklist, -- Middle widget
+        { -- Right widgets
+            layout = wibox.layout.fixed.horizontal,
+            ...
+            weather_widget,
+            ...
+    ```
 
- - download json parser for lua: https://github.com/rxi/json.lua
- - get Open Weather Map app id here: https://openweathermap.org/appid
 
 You can read how it works in more details [here](http://pavelmakhov.com/2017/02/weather-widget-for-awesome-wm)