openhab tutorial half complete

Author: 2bndy5

README.rst

@@ -11,13 +11,14 @@ Introduction
 .. image:: https://codecov.io/gh/2bndy5/CircuitPython_Homie/branch/main/graph/badge.svg?token=FOEW7PBQG8
     :target: https://codecov.io/gh/2bndy5/CircuitPython_Homie
     :alt: Test Code Coverage
+.. image:: https://static.pepy.tech/personalized-badge/circuitpython-homie?period=total&units=international_system&left_color=grey&right_color=blue&left_text=PyPI%20Downloads
+    :target: https://pepy.tech/project/circuitpython-homie
 
 Homie v4 specifications for MQTT implemented in CircuitPython
 
 .. image:: https://homieiot.github.io/img/works-with-homie.svg
     :alt: Works with MQTT Homie
     :target: https://homieiot.github.io/
-    :width: 50%
 
 Dependencies
 ------------

circuitpython_homie/__init__.py

@@ -404,10 +404,11 @@ def set_property(self, prop: HomieProperty, value, multi_node: bool = False):
 
         :param prop: the instance object representing the device node's property.
         :param value: The new value for the property. The data type passed here will
-            depend on type of `HomieProperty` (specified by the ``prop`` parameter) for
-            which it is being applied.
+            depend on the type of `HomieProperty` (specified by the ``prop`` parameter)
+            for which it is being applied.
 
-            .. seealso:: The :doc:`recipes` have validators implemented accordingly.
+            .. seealso:: The :doc:`recipes` have derivatives of the `HomieProperty`
+                class with validators implemented accordingly.
         :param multi_node: Set this to `True` if the property is associated with
             multiple device `nodes`. By default, only the first node found in
             association is updated on the MQTT broker.

circuitpython_homie/recipes.py

@@ -243,7 +243,7 @@ class PropertyBool(HomieProperty):
     |param_intro|
 
     - `datatype` attribute is set to :python:`"boolean"` |param_immutable|
-    - ``init_value`` is set to :python:`"false"` |param_mutable|
+    - ``init_value`` is set to `False` |param_mutable|
     """
 
     def __init__(

docs/_static/extra_css.css

@@ -3,31 +3,32 @@
   float: right;
 }
 
-.code.homie-attr::before {
+code.literal.homie-attr::before {
   content: "$";
 }
 
-.code.homie-attr {
+code.literal.homie-attr {
   color: var(--md-code-hl-special-color);
 }
 
-.code.homie-val {
+code.literal.homie-val {
   color: var(--md-code-hl-keyword-color);
 }
 
-.code.homie-dev,
-.code.homie-node,
-.code.homie-prop {
+code.literal.homie-dev,
+code.literal.homie-node,
+code.literal.homie-prop {
   color: var(--md-code-hl-string-color);
 }
 
-.topic-list li::marker {
+.topic-list > ul li::marker {
   content: "/";
 }
 
 *:root {
   --md-admonition-seealso-color: hsl(278, 100%, 63%);
-  --md-eye--icon: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 0 24 24" width="24px"><path d="M0 0h24v24H0z" fill="none"/><path d="M12 4.5C7 4.5 2.73 7.61 1 12c1.73 4.39 6 7.5 11 7.5s9.27-3.11 11-7.5c-1.73-4.39-6-7.5-11-7.5zM12 17c-2.76 0-5-2.24-5-5s2.24-5 5-5 5 2.24 5 5-2.24 5-5 5zm0-8c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3-1.34-3-3-3z"/></svg>');
+  --md-admonition-icon--seealso: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 0 24 24" width="24px"><path d="M0 0h24v24H0z" fill="none"/><path d="M12 4.5C7 4.5 2.73 7.61 1 12c1.73 4.39 6 7.5 11 7.5s9.27-3.11 11-7.5c-1.73-4.39-6-7.5-11-7.5zM12 17c-2.76 0-5-2.24-5-5s2.24-5 5-5 5 2.24 5 5-2.24 5-5 5zm0-8c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3-1.34-3-3-3z"/></svg>');
+  --md-admonition-icon--tip: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 0 24 24" width="24px"><path d="M0 0h24v24H0V0z" fill="none"/><path d="M5 13.18v2.81c0 .73.4 1.41 1.04 1.76l5 2.73c.6.33 1.32.33 1.92 0l5-2.73c.64-.35 1.04-1.03 1.04-1.76v-2.81l-6.04 3.3c-.6.33-1.32.33-1.92 0L5 13.18zm6.04-9.66l-8.43 4.6c-.69.38-.69 1.38 0 1.76l8.43 4.6c.6.33 1.32.33 1.92 0L21 10.09V16c0 .55.45 1 1 1s1-.45 1-1V9.59c0-.37-.2-.7-.52-.88l-9.52-5.19c-.6-.32-1.32-.32-1.92 0z"/></svg>');
 }
 
 .admonition.seealso .admonition-title {
@@ -40,5 +41,40 @@
 
 .md-typeset .admonition.seealso :is(.admonition-title, summary)::before {
   background-color: var(--md-admonition-seealso-color);
-  mask-image: var(--md-eye--icon);
+  mask-image: var(--md-admonition-icon--seealso);
+}
+
+[data-md-color-scheme="default"] img.only-dark {
+  display: none;
+}
+
+[data-md-color-scheme="slate"] img.only-light {
+  display: none;
+}
+
+code.oh,
+a:hover code.oh,
+a code.oh {
+  border-radius: 12px;
+  padding: 2px 7px;
+  color: white;
+  font-size: 0.8rem;
+}
+
+code.oh-red,
+a code.oh-red {
+  background-color: hsl(14, 100%, 50%);
+}
+
+code.oh-green {
+  background-color: hsl(130, 65%, 57%);
+}
+
+code.oh-blue,
+a code.oh-blue {
+  background-color: hsl(207, 90%, 62%);
+}
+
+a:hover code.oh-blue {
+  background-color: hsl(207, 63%, 40%);
 }