Merge pull request #5706 from sjabby/patch-15

Update lovelace docs - picture-entity

source/_lovelace/picture-entity.markdown

@@ -10,8 +10,6 @@ sharing: true
 footer: true
 ---
 
-### Entity picture
-
 A very useful card for controling entities. By default you will get `more-info-dialog` but using `tap_action` you can directly control entities that have `on`/`off` states. It allows you to generate a very nice looking card with a big touch area, highly recommended for mobile dashboards on small screens.
 
 You can use different image combination to get a more realistic view for images with lights. The image setup also allows enough flexibility to get your garage picture with the door opened and closed.
@@ -23,30 +21,80 @@ You can also use `camera` domain entities to use that as `camera_image`.
 Screenshot of the picture entity card.
 </p>
 
-**Options**
+{% linkable_title Options %}
 
-| Name | Type | Default | Description
-| ---- | ---- | ------- | -----------
-| type | string | **Required** | `picture-entity`
-| entity | string | **Required** | Entity id to control via picture.
-| camera_image | string | Optional | camera domain entity_id 'camera.demo_camera'
-| image | string | Optional| URL of an image.
-| state_image | object | Optional | See `state_image` object structure.
-| name | string | Optional | Custom name for entity
-| show_info | boolean | Optional | Set to false to hide infobar
-| tap_action | string | dialog | Set to `toggle` for turning entity on/off without opening a dialog
+{% configuration %}
+type:
+  required: true
+  description: picture-entity
+  type: string
+entity:
+  required: true
+  description: Entity id to control via picture.
+  type: string
+camera_image:
+  required: false
+  description: "Camera domain entity_id 'camera.demo_camera'"
+  type: string
+  default: None
+image:
+  required: false
+  description: URL of an image.
+  type: string
+  default: None
+state_image:
+  required: false
+  description: "See `state_image` object structure."
+  type: object
+  default: None
+name:
+  required: false
+  description: Custom name for entity
+  type: string
+  default: None
+show_info:
+  required: false
+  description: Set to false to hide infobar
+  type: boolean
+  default: True
+tap_action:
+  required: false
+  description: "Set to `toggle` for turning entity on/off without opening a dialog"
+  type: string
+  default: dialog
+{% endconfiguration %}
 
 `state_image` object structure
 
-| Name | Type | Default | Description
-| ---- | ---- | ------- | -----------
-| on | string | Optional | URL of an image used for on state.
-| off | string | Optional | URL of an image used for off state.
-| home | string | Optional | URL of an image used for home state.
-| not_home | string | Optional | URL of an image used for not_home state.
-| ... | string | Optional | Any state that is supported by the entity works
+{% configuration %}
+"on":
+  required: true
+  description: URL of an image used for on state.
+  type: string
+  default: None
+"off":
+  required: true
+  description: URL of an image used for off state.
+  type: string
+  default: None
+home:
+  required: false
+  description: URL of an image used for home state.
+  type: string
+  default: None
+not_home:
+  required: false
+  description: URL of an image used for not_home state.
+  type: string
+  default: None
+any:
+  required: false
+  description: Any state that is supported by the entity works
+  type: object
+  default: None
+{% endconfiguration %}
 
-**Examples**
+{% linkable_title Examples %}
 
 Basic example: