calendar.md

   1 Attaches a calendar notification to a widget.
   2
   3     lain.widgets.calendar:attach(mywidget)
   4
   5 - Left click: switch to previous month.
   6 - Right click: switch to next month.
   7
   8 Optionally you can call the function with background and foreground colors arguments, both or just one:
   9
  10     lain.widgets.calendar:attach(mytextclock, "#FFFFFF", "#000000")
  11     -- or
  12     lain.widgets.calendar:attach(mytextclock, "#FFFFFF")
  13     -- or
  14     lain.widgets.calendar:attach(mytextclock, nil, "#000000")
  15
  16 Notification will show an icon displaying current day, and formatted output
  17 from ``cal`` with current day highlighted.
  18
  19 Calendar icons are placed in [lain/icons/cal](https://github.com/copycat-killer/lain/tree/master/icons/cal), default set being ``white``.
  20
  21 You can add your own set, and tell lain to use it like this:
  22
  23     lain.widgets.calendar.icons_dir = lain.widgets.icons_dir .. "cal/myicons"
  24
  25 also, you can set notification font size:
  26
  27     lain.widgets.calendar.font_size = 14
  28
  29 default is 12.
  30
  31 Finally, you can call the notification with a key binding like this:
  32
  33     awful.key({ altkey }, "c", function () lain.widgets.calendar:show(7) end),
  34
  35 where ``altkey = "Mod1"`` and ``show`` argument is an optional integer, meaning timeout seconds.