Update lunarphase with keyboard controls, add custom keyboard snippets

docs/modules/lunarphase.md

@@ -1,19 +1,43 @@
 # Lunar Phase
 
-Displays the phase of the Moon as ASCII art from [Wttr.in](http://wttr.in). The width of the column in which the lunar phase is displayed needs to be large enough for the ASCII graphic to fit or multiple columns must be allocated.
+Displays the phase of the Moon as ASCII art from [Wttr.in](http://wttr.in).
 
 ## Configuration
 
 ```yaml
 lunarphase:
   enabled: true
+  language: 'en'
   position:
     top: 3
     left: 5
     height: 2
     width: 2
-  language: 'en'
-  refreshInterval: 5h
+  title: 'Phase of the Moon'
+  timeout: 30
+```
+
+The width of the column in which the lunar phase is displayed needs to be
+large enough for the ASCII graphic to fit or multiple columns must be allocated.
+For example:
+
+```yaml
+grid:
+    columns: [74, 12]
+    rows: [14, 14]
+```
+
+The default `wtf` settings for opening a URL in a browser on Linux is
+to open the URL with `xdg-open`. However, `xdg-open` depends on the KDE
+`konqueror` web browser on many systems. An alternate configuration on Linux
+systems where `xdg-open` fails or is unavailable may be necessary. One such
+configuration uses the Gnome `gio` utility. To use `gio` to open URLs, add
+the following to your `wtf` YAML configuration:
+
+```yaml
+openUrlUtil:
+    - 'gio'
+    - 'open'
 ```
 
 ## Screenshots
@@ -23,5 +47,73 @@ lunarphase:
   <img class="screenshot" src="/assets/modules/lunarphase-fr.png" width="640" height="448" alt="lunarphase french screenshot" />
 </p>
 
+## Keyboard
+
+To use module keyboard controls, first press the number of the module
+displayed in the title of the module widget to give focus to that module.
+To leave module keyboard control mode, press `Esc`.
+
+When using keyboard controls to change the lunar phase day, the
+`lunarphase` module widget title will be updated to reflect the currently
+configured lunar phase day but the module widget will not automatically refresh.
+After selecting the desired day using keyboard controls, refresh the module
+widget by pressing `r`. For example, to display next week's lunar phase,
+press `Up Arrow` or `N` then press `r`. To view the lunar phase 2 days
+previous to the current day, press `Left Arrow` or `p` twice then press `r`.
+
+The following keyboard controls are supported in the `lunarphase` module:
+
+<table>
+  {% include "keyboard/table_header.md" %}
+
+  <tbody>
+    {% include "keyboard/foreslash.md" %}
+
+    {% set return="Open selected day lunar phase at nineplanets.org in the browser" %}
+    {% include "keyboard/return.md" %}
+
+    {% include "keyboard/spacer.md" %}
+
+    {% set n="Display next day lunar phase" %}
+    {% include "keyboard/n.md" %}
+
+    {% set p="Display previous day lunar phase" %}
+    {% include "keyboard/p.md" %}
+
+    {% set t="Display today's lunar phase" %}
+    {% include "keyboard/t.md" %}
+
+    {% set N="Display next week lunar phase" %}
+    {% include "keyboard/N.md" %}
+
+    {% set P="Display previous week lunar phase" %}
+    {% include "keyboard/P.md" %}
+
+    {% set o="Open selected day lunar phase at nineplanets.org in the browser" %}
+    {% include "keyboard/o.md" %}
+
+    {% include "keyboard/r.md" %}
+
+    {% include "keyboard/spacer.md" %}
+
+    {% set arrowBack="Show the previous day lunar phase" %}
+    {% include "keyboard/arrowBack.md" %}
+
+    {% set arrowFore="Show the next day lunar phase" %}
+    {% include "keyboard/arrowFore.md" %}
+
+    {% set customArrowDown="Show previous week lunar phase" %}
+    {% include "keyboard/customArrowDown.md" %}
+
+    {% set customArrowUp="Show next week lunar phase" %}
+    {% include "keyboard/customArrowUp.md" %}
+
+    {% include "keyboard/spacer.md" %}
+
+    {% set customCtrlD="Toggle disable/enable widget display" %}
+    {% include "keyboard/customCtrlD.md" %}
+  </tbody>
+</table>
+
 {% set src="lunarphase" %}
 {% include "src_path.md" %}

snippets/keyboard/N.md

@@ -0,0 +1,4 @@
+<tr>
+    <td><code>N</code></td>
+    <td>{{ N }}</td>
+</tr>

snippets/keyboard/P.md

@@ -0,0 +1,4 @@
+<tr>
+    <td><code>P</code></td>
+    <td>{{ P }}</td>
+</tr>

snippets/keyboard/arrowBack.md

@@ -1,6 +1,6 @@
 <tr>
-        <td>
-            <code>←</code>
-        </td>
-        <td>{{ arrowback }}{{ arrowBack }}</td>
-    </tr>
+    <td>
+        <code>←</code>
+    </td>
+    <td>{{ arrowBack }}</td>
+</tr>

snippets/keyboard/arrowFore.md

@@ -1,6 +1,6 @@
 <tr>
-        <td>
-            <code>→</code>
-        </td>
-        <td>{{ arrowfore }}{{ arrowFore }}</td>
-    </tr>
+    <td>
+        <code>→</code>
+    </td>
+    <td>{{ arrowFore }}</td>
+</tr>

snippets/keyboard/customArrowDown.md

@@ -0,0 +1,4 @@
+<tr>
+    <td><code>↓</code></td>
+    <td>{{ customArrowDown }}</td>
+</tr>

snippets/keyboard/customArrowUp.md

@@ -0,0 +1,4 @@
+<tr>
+    <td><code>↑</code></td>
+    <td>{{ customArrowUp }}</td>
+</tr>

snippets/keyboard/customCtrlD.md

@@ -0,0 +1,4 @@
+<tr>
+    <td><code>Ctrl-d</code></td>
+    <td>{{ customCtrlD }}</td>
+</tr>