mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-17 14:26:51 +00:00
Update configuration describtion style (#3991)
This commit is contained in:
parent
7d2980bbe6
commit
d40b9ff36f
@ -26,7 +26,10 @@ binary_sensor:
|
|||||||
- 'coreos-512mb-nyc3-01'
|
- 'coreos-512mb-nyc3-01'
|
||||||
```
|
```
|
||||||
|
|
||||||
Configuration variables:
|
{% configuration %}
|
||||||
|
droplets:
|
||||||
- **droplets** (*Required*): List of droplets you want to control.
|
description: List of droplets you want to monitor.
|
||||||
|
required: true
|
||||||
|
type: list
|
||||||
|
{% endconfiguration %}
|
||||||
|
|
||||||
|
@ -25,9 +25,13 @@ binary_sensor:
|
|||||||
- platform: iss
|
- platform: iss
|
||||||
```
|
```
|
||||||
|
|
||||||
Configuration variables:
|
{% configuration %}
|
||||||
|
show_on_map:
|
||||||
- **show_on_map** (*Optional*): Option to show the position of the ISS on the map. Defaults to `False`.
|
description: Option to show the position of the ISS on the map.
|
||||||
|
required: optionsl
|
||||||
|
default: false
|
||||||
|
type: string
|
||||||
|
{% endconfiguration %}
|
||||||
|
|
||||||
<p class='note warning'>
|
<p class='note warning'>
|
||||||
If you set `show_on_map` `True` then the location attributes are named `latitude` and `longitude`. The default name of the location attributes is `lat` and `long` to avoid showing them on the map.
|
If you set `show_on_map` `True` then the location attributes are named `latitude` and `longitude`. The default name of the location attributes is `lat` and `long` to avoid showing them on the map.
|
||||||
|
@ -25,7 +25,7 @@ binary_sensor:
|
|||||||
```
|
```
|
||||||
|
|
||||||
{% configuration %}
|
{% configuration %}
|
||||||
name:
|
name:
|
||||||
description: Name to use in the frontend.
|
description: Name to use in the frontend.
|
||||||
required: false
|
required: false
|
||||||
type: string
|
type: string
|
||||||
|
@ -26,6 +26,10 @@ digital_ocean:
|
|||||||
access_token: YOUR_API_KEY
|
access_token: YOUR_API_KEY
|
||||||
```
|
```
|
||||||
|
|
||||||
Configuration variables:
|
{% configuration %}
|
||||||
|
access_token:
|
||||||
|
description: Your Digital Ocean API access token.
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
{% endconfiguration %}
|
||||||
|
|
||||||
- **access_token** (*Required*): Your Digital Ocean API access token.
|
|
||||||
|
@ -24,12 +24,27 @@ sensor:
|
|||||||
- platform: random
|
- platform: random
|
||||||
```
|
```
|
||||||
|
|
||||||
Configuration variables:
|
{% configuration %}
|
||||||
|
name:
|
||||||
- **name** (*Optional*): Name of the sensor to use in the frontend. Defaults to `Random Sensor`.
|
description: Name to use in the frontend.
|
||||||
- **minimum** (*Optional*): Lower limit for the values. Defaults to `0`.
|
required: false
|
||||||
- **maximum** (*Optional*): Upper limit for the values. Defaults to `20`.
|
type: string
|
||||||
- **unit_of_measurement** (*Optional*): Defines the units of measurement of the sensor, if any.
|
default: Random Sensor
|
||||||
|
minimum:
|
||||||
|
description: Lower limit for the values.
|
||||||
|
required: false
|
||||||
|
type: string
|
||||||
|
default: 0
|
||||||
|
maximum:
|
||||||
|
description: Upper limit for the values.
|
||||||
|
required: false
|
||||||
|
type: int
|
||||||
|
default: 20
|
||||||
|
unit_of_measurement:
|
||||||
|
description: Defines the units of measurement of the sensor, if any.
|
||||||
|
required: false
|
||||||
|
type: string
|
||||||
|
{% endconfiguration %}
|
||||||
|
|
||||||
See the [entity component options][entity-docs] to control how often the main component polls the random sensor. The default is 30 seconds.
|
See the [entity component options][entity-docs] to control how often the main component polls the random sensor. The default is 30 seconds.
|
||||||
|
|
||||||
|
@ -26,7 +26,10 @@ switch:
|
|||||||
- 'coreos-512mb-nyc3-01'
|
- 'coreos-512mb-nyc3-01'
|
||||||
```
|
```
|
||||||
|
|
||||||
Configuration variables:
|
{% configuration %}
|
||||||
|
droplets:
|
||||||
- **droplets** (*Required*): List of droplets you want to control.
|
description: List of droplets you want to control.
|
||||||
|
required: true
|
||||||
|
type: list
|
||||||
|
{% endconfiguration %}
|
||||||
|
|
||||||
|
@ -22,10 +22,17 @@ weather:
|
|||||||
- platform: bom
|
- platform: bom
|
||||||
```
|
```
|
||||||
|
|
||||||
Configuration variables:
|
{% configuration %}
|
||||||
|
name:
|
||||||
- **name** (*Optional*): The name you would like to give to the weather station.
|
description: The name you would like to give to the weather station.
|
||||||
- **station** (*Optional*): The station ID string; defaults to the closest station. See the [`sensor.bom` docs](/components/sensor.bom/) for details on how to find the ID of a station.
|
required: optional
|
||||||
|
type: string
|
||||||
|
station:
|
||||||
|
description: "The station ID string. See the [`sensor.bom` docs](/components/sensor.bom/) for details on how to find the ID of a station."
|
||||||
|
required: optional
|
||||||
|
default: The closest station
|
||||||
|
type: string
|
||||||
|
{% endconfiguration %}
|
||||||
|
|
||||||
<p class='note'>
|
<p class='note'>
|
||||||
This platform is an alternative to the [`bom`](/components/sensor.bom/) sensor.
|
This platform is an alternative to the [`bom`](/components/sensor.bom/) sensor.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user