Merge pull request #310 from utix/calendar/improvement

Calendar/improvement

calendar-widget/README.md

@@ -4,11 +4,21 @@ Calendar widget for Awesome WM - slightly improved version of the `wibox.widget.
 
 ## Features
 
+
+### Customization
+
+| Name | Default | Description |
+|---|---|---|
+| theme     | `naughty` | The theme to use          |
+| placement | `top`     | The position of the popup |
+| radius    |  8        | The popup radius          |
+| start_sunday | false  | Start the week on Sunday  |
+
  - themes:
 
     | Name | Screenshot |
     |---|---|
-    | nord (default) | ![nord_theme](./nord.png) |
+    | nord           | ![nord_theme](./nord.png) |
     | outrun         | ![outrun_theme](./outrun.png) |
     | light          | ![outrun_theme](./light.png) |
     | dark           | ![outrun_theme](./dark.png) |
@@ -28,6 +38,10 @@ Calendar widget for Awesome WM - slightly improved version of the `wibox.widget.
 
   ![calendar_bottom_right](./calendar_bottom_right.png)
 
+ - setup first day of week
+
+   By setting `start_sunday` to true:
+   ![calendar_start_sunday](./calendar_start_sunday.png)
 
  - mouse support:
     move to the next and previous month. Using mouse buttons or scroll wheel.
@@ -36,7 +50,7 @@ Calendar widget for Awesome WM - slightly improved version of the `wibox.widget.
     Usually these are configured as follows. If you want to use other mouse buttons, you can find their number using `xev`.
 
     | number | button        |
-    |--------|--------|
+    |--------|---------------|
     | 4      | scroll up     |
     | 5      | scroll down   |
     | 1      | left click    |
@@ -62,6 +76,7 @@ local cw = calendar_widget()
 local cw = calendar_widget({
     theme = 'outrun',
     placement = 'bottom_right',
+    start_sunday = true,
     radius = 8,
 -- with customized next/previous (see table above)
     previous_month_button = 1,

calendar-widget/calendar.lua

@@ -97,6 +97,7 @@ local function worker(user_args)
     local radius = args.radius or 8
     local next_month_button = args.next_month_button or 4
     local previous_month_button = args.previous_month_button or 5
+    local start_sunday = args.start_sunday or false
 
     local styles = {}
     local function rounded_shape(size)
@@ -184,6 +185,7 @@ local function worker(user_args)
         font = beautiful.get_font(),
         fn_embed = decorate_cell,
         long_weekdays = true,
+        start_sunday = start_sunday,
         widget = wibox.widget.calendar.month
     }