Tipboard got open-sourced!1.4.0

1 files changed, 97 insertions, 0 deletions

diff --git a/doc/tile__big_value.rst b/doc/tile__big_value.rst
new file mode 100644
index 0000000..dbdcad2
--- /dev/null
+++ b/doc/tile__big_value.rst
@@ -0,0 +1,97 @@
+=============
+``big_value``
+=============
+
+.. image:: img/smaller/big-value.png
+
+**Description**
+
+This is a variation of ``simple_percentage`` tile. It has slightly different
+footer (four possible values instead of just two; values are displayed on the
+right side of the label instead of below), and the main value (``big_value``)
+is little bit bigger.
+
+**Content**
+
+::
+
+  data = {
+      "title": "<title>",
+      "description": "<description>",
+      "big-value": "<value>",
+      "upper-left-label": "<label>",
+      "upper-left-value": "<value>",
+      "lower-left-label": "<label>",
+      "lower-left-value": "<value>",
+      "upper-right-label": "<label>",
+      "upper-right-value": "<value>",
+      "lower-right-label": "<label>",
+      "lower-right-value": "<value>"
+  }
+
+where:
+
+.. describe:: title, description
+
+   Title and description (subtitle) for the tile.
+
+.. describe:: big_value
+
+   Main value, which treated as a string, so it can contain symbols like ``%`` etc.
+
+.. describe:: upper-left-value, lower-left-value, upper-right-value, lower-right-value
+
+   Smaller, bottom-left and bottom-right values.
+
+.. describe:: upper-left-label, lower-left-label, upper-right-label, lower-right-label
+
+   Labels for above values.
+
+
+Example::
+
+  curl http://localhost:7272/api/v0.1/<api_key>/push
+       -X POST
+       -d "tile=big_value"
+       -d "key=<tile_id>"
+       -d 'data={"title": "Tickets",
+                 "description": "number of blockers",
+                 "big-value": "314",
+                 "upper-left-label": "critical:",
+                 "upper-left-value": "1020",
+                 "lower-left-label": "major:",
+                 "lower-left-value": "8609",
+                 "upper-right-label": "minor:",
+                 "upper-right-value": "7532",
+                 "lower-right-label": "all:",
+                 "lower-right-value": "19 853"}'
+
+**Configuration**
+
+::
+
+  value = {
+      "big_value_color": "<color>",
+      "fading_background": <BOOLEAN>
+  }
+
+where:
+
+.. describe:: big_value_color
+
+   Background color for ``big_value`` in a hexadecimal form or color name (e.g.
+   ``#94C140`` or ``green``).
+
+.. describe:: fading_background
+
+   Turns on/off background pulsation for ``big_value`` (may be useful for
+   alerts etc.).
+
+   .. versionadded:: 1.3.0
+
+
+Example::
+
+    curl http://localhost:7272/api/v0.1/<api_key>/tileconfig/<tile_id>
+         -X POST
+         -d 'value={"big_value_color": "green", "fading_background": true}'