diff options
Diffstat (limited to 'stackoverflow-widget/README.md')
-rw-r--r-- | stackoverflow-widget/README.md | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/stackoverflow-widget/README.md b/stackoverflow-widget/README.md new file mode 100644 index 0000000..c906bf1 --- /dev/null +++ b/stackoverflow-widget/README.md @@ -0,0 +1,46 @@ +# Stackoverflow widget + +When clicked, widget shows latest questions from stackoverflow.com with a given tag(s). + +![screenshot](./screenshot.png) + +## Customization + +It is possible to customize widget by providing a table with all or some of the following config parameters: + +| Name | Default | Description | +|---|---|---| +| `icon`| `/.config/awesome/awesome-wm-widgets/stackoverflow-widget/so-icon.svg| Path to the icon| +| `limit` | 5 | Number of items to show in the widget +| `tagged` | awesome-wm | Tag, or comma-separated tags | + +## Installation + +1. Clone this repo (if not cloned yet) under **~/.config/awesome/**: + + ```bash + git clone https://github.com/streetturtle/awesome-wm-widgets.git ~/.config/awesome/ + ``` + +1. Require widget at the top of the **rc.lua**: + + ```lua + local stackoverflow_widget = require("awesome-wm-widgets.stackoverflow-widget.stackoverflow") + ``` + +1. Add widget to the tasklist: + + ```lua + s.mytasklist, -- Middle widget + { -- Right widgets + layout = wibox.layout.fixed.horizontal, + ... + --default + stackoverflow_widget(), + --customized + stackoverflow_widget({ + limit = 10 + }) + ... + ``` + |