From b9de47d5a3be2e3c59a2e11db238eb740c8b8de8 Mon Sep 17 00:00:00 2001 From: streetturtle Date: Sat, 20 Jan 2018 21:24:07 -0500 Subject: update readme --- translate-widget/README.MD | 80 ++++++++++++++++++++++++---------------------- 1 file changed, 42 insertions(+), 38 deletions(-) (limited to 'translate-widget/README.MD') diff --git a/translate-widget/README.MD b/translate-widget/README.MD index 53f4586..6dbb3b1 100644 --- a/translate-widget/README.MD +++ b/translate-widget/README.MD @@ -1,5 +1,3 @@ -in progress... - # Translate Widget ![demo](./demo.gif) @@ -8,42 +6,48 @@ This widget is based on the [Yandex.Translate API](https://tech.yandex.com/trans ## Installation -1. Get an [https://translate.yandex.com/developers/keys](API key) -1. - -Create a translate prompt: - -```lua -s.translateprompt = awful.widget.prompt() -``` - -Add it to the left widgets of the wibox, just after `mypromptbox`: - -```lua --- Add widgets to the wibox -s.mywibox:setup { - layout = wibox.layout.align.horizontal, - { -- Left widgets - layout = wibox.layout.fixed.horizontal, - mylauncher, - s.mytaglist, - s.mypromptbox, - s.translateprompt, - }, -``` - -Add a shortcut to run this prompt: - -```lua -awful.key({ modkey }, "c", function() - awful.prompt.run { - prompt = "trnslt: ", - textbox = awful.screen.focused().translateprompt.widget, - exe_callback = function(text) - translate.translate(text) - end - } -``` +1. Get an [API key](https://translate.yandex.com/developers/keys) and paste it **secrets.lua** +1. Require widget and secrets in **rc.lua**: + + ```lua + local secrets = require("awesome-wm-widgets.secrets") + local translate = require("awesome-wm-widgets.translate-widget.translate") + ``` + +1. Create a translate prompt (just under `mypromptbox`): + + ```lua + s.mypromptbox = awful.widget.prompt() + s.translateprompt = awful.widget.prompt() + ``` + +1. Add it to the left widgets of the wibox, just after `mypromptbox`: + + ```lua + -- Add widgets to the wibox + s.mywibox:setup { + layout = wibox.layout.align.horizontal, + { -- Left widgets + layout = wibox.layout.fixed.horizontal, + mylauncher, + s.mytaglist, + s.mypromptbox, + s.translateprompt, + }, + ``` + +1. Add a shortcut to run this prompt (note that we pass an API key from secrets.lua in method call): + + ```lua + awful.key({ modkey }, "c", function() + awful.prompt.run { + prompt = "trnslt: ", + textbox = awful.screen.focused().translateprompt.widget, + exe_callback = function(text) + translate.translate(text, secrets.translate_widget_api_key) + end + } + ``` ## Controls -- cgit v1.2.3