f-integrations: add glossary reference to config file (#32755)

This commit is contained in:
c0ffeeca7 2024-05-14 15:11:25 +02:00 committed by GitHub
parent 23d49e8fc4
commit 02ee39a27c
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
12 changed files with 20 additions and 19 deletions

View File

@ -65,7 +65,7 @@ For those of us using Docker, the above tutorial may not be sufficient. The foll
#### Set HTTP logger
In your `configuration.yaml` file, add the following to the `logger` integration to ensure that Home Assistant prints failed login attempts to the log.
In your {% term "`configuration.yaml`" %} file, add the following to the `logger` integration to ensure that Home Assistant prints failed login attempts to the log.
```yaml
logger:
@ -161,7 +161,7 @@ server {
}
```
Once that's added to the NGINX configuration, we need to modify the Home Assistant `configuration.yaml` such that the `X-Forwarded-For` header can be parsed. This is done by adding the following to the `http` integration:
Once that's added to the NGINX configuration, we need to modify the Home Assistant {% term "`configuration.yaml`" %} such that the `X-Forwarded-For` header can be parsed. This is done by adding the following to the `http` integration:
```yaml
http:
@ -172,7 +172,7 @@ At this point, once the Let's Encrypt and Home Assistant dockers are restarted,
#### Add the fail2ban sensor
Now that we've correctly set everything up for Docker, we can add our sensors to `configuration.yaml` with the following:
Now that we've correctly set everything up for Docker, we can add our sensors to {% term "`configuration.yaml`" %} with the following:
```yaml
sensor:

View File

@ -18,7 +18,8 @@ When a `state_topic` is not available, the fan will work in optimistic mode. In
Optimistic mode can be forced even if a `state_topic` is available. Try to enable it if you are experiencing incorrect fan operation.
To enable MQTT fans in your installation, add the following to your `configuration.yaml` file:
To enable MQTT fans in your installation, add the following to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry

View File

@ -20,7 +20,7 @@ you have FFmpeg installed on your system.
## Configuration
To set it up, add the following information to your `configuration.yaml` file:
To set it up, add the following information to your {% term "`configuration.yaml`" %} file:
```yaml
ffmpeg:

View File

@ -62,7 +62,7 @@ To use notifications, please see the [getting started with automation page](/get
The `file` sensor platform reads the entries from a plain-text file and shows the found value. Only the last line of the file is used. This is similar to do `$ tail -n 1 sensor.txt` on the command-line. Note that file paths must be added to [allowlist_external_dirs](/integrations/homeassistant/#allowlist_external_dirs).
To enable the `file` sensor, add the following lines to your `configuration.yaml`:
To enable the `file` sensor, add the following lines to your {% term "`configuration.yaml`" %}:
```yaml
# Example configuration.yaml entry
@ -105,7 +105,7 @@ Assuming that the log file contains multiple values formatted as JSON like shown
{"temperature": 22, "humidity": 36}
```
This would require the following entry in the `configuration.yaml` file to extract the temperature:
This would require the following entry in the {% term "`configuration.yaml`" %} file to extract the temperature:
{% raw %}
@ -131,7 +131,7 @@ timestamp,temperature,humidity
1631472949,22,36
```
This would require the following entry in the `configuration.yaml` file to extract the temperature:
This would require the following entry in the {% term "`configuration.yaml`" %} file to extract the temperature:
{% raw %}

View File

@ -215,7 +215,7 @@ This screenshot shows what a FireServiceRota dashboard can look like.
## Debugging
The FireServiceRota integration will log additional information about WebSocket incidents received, response and duty status gathered, and other messages when the log level is set to `debug`. Add the relevant lines below to the `configuration.yaml`:
The FireServiceRota integration will log additional information about WebSocket incidents received, response and duty status gathered, and other messages when the log level is set to `debug`. Add the relevant lines below to the {% term "`configuration.yaml`" %}:
```yaml
logger:

View File

@ -35,7 +35,7 @@ There is currently support for the following device types within Home Assistant:
You will need to upload a [Firmata firmware](https://github.com/firmata/) to your board. Please upload any `StandardFirmata` sketch to your board; please refer to the [Arduino documentation](https://www.arduino.cc/en/Main/Howto) for further information for uploading sketches. Firmata is available in the Arduino Library Manager in the Arduino IDE. You may also use a [Firmata Express](https://github.com/MrYsLab/FirmataExpress).
To integrate Arduino boards with Home Assistant, add the following section to your `configuration.yaml` file:
To integrate Arduino boards with Home Assistant, add the following section to your {% term "`configuration.yaml`" %} file:
<div class='note warning'>
Firmata does not store the last state across power cycles. This means that with every powerup the pins are set to off/low and after every initialization, they will be set to the default that you have configured in YAML.

View File

@ -17,7 +17,7 @@ The sensor exposes the number of filtered files in the folder, total size in byt
## Configuration
To enable the `folder` sensor in your installation, add the following to your `configuration.yaml` file:
To enable the `folder` sensor in your installation, add the following to your {% term "`configuration.yaml`" %} file:
```yaml
sensor:

View File

@ -17,7 +17,7 @@ This sensor requires an API token. Please obtain one at [Foobot API site](https:
## Configuring the Platform
To enable this sensor, add the following lines to your `configuration.yaml` file:
To enable this sensor, add the following lines to your {% term "`configuration.yaml`" %} file:
```yaml
sensor:

View File

@ -47,7 +47,7 @@ https://foursquare.com/oauth2/authenticate?client_id=CLIENT_ID&response_type=tok
and change the `CLIENT_ID` and `YOUR_REGISTERED_REDIRECT_URL` to your actual values.
You will receive an OAuth request landing page, asking you if you want to connect your Foursquare account to your newly created app. Say "Yes".
After that, you will get redirected to your `REDIRECT_URL` with the `access_token` as an HTTP GET variable. Copy everything after the = and paste it in your `configuration.yaml` as the `access_token`.
After that, you will get redirected to your `REDIRECT_URL` with the `access_token` as an HTTP GET variable. Copy everything after the = and paste it in your {% term "`configuration.yaml`" %} as the `access_token`.
### Real-Time API

View File

@ -47,7 +47,7 @@ You need to determine your update URL or your access token.
## Configuration (API V2)
To use the integration in your installation, add the following to your `configuration.yaml` file:
To use the integration in your installation, add the following to your {% term "`configuration.yaml`" %} file:
```yaml
# Example configuration.yaml entry

View File

@ -145,7 +145,7 @@ Theme `day_and_night`: This theme has both a `light` and a `dark` mode section.
As with all configuration, you can either:
- Directly specify the themes inside your `configuration.yaml` file.
- Directly specify the themes inside your {% term "`configuration.yaml`" %} file.
- Put them into a separate file (e.g., `themes.yaml`) and include that in your configuration (`themes: !include themes.yaml`).
- Create a dedicated folder (e.g., `my_themes`) and include all files from within this folder (`themes: !include_dir_merge_named my_themes`).
@ -157,7 +157,7 @@ Check our [community forums](https://community.home-assistant.io/c/projects/them
There are two themes-related services:
- `frontend.reload_themes`: Reloads theme configuration from your `configuration.yaml` file.
- `frontend.reload_themes`: Reloads theme configuration from your {% term "`configuration.yaml`" %} file.
- `frontend.set_theme`: Sets backend-preferred theme name.
### Service `set_theme`
@ -165,14 +165,14 @@ There are two themes-related services:
| Service data attribute | Description |
| ---------------------- | --------------------------------------------------------------------------------------------------- |
| `name` | Name of the theme to set, `default` for the default theme or `none` to restore to the default. |
| `mode` | If the theme should be applied in light or dark mode `light` or `dark` (Optional, default `light`). |
| `mode` | If the theme should be applied in light or dark mode `light` or `dark` (Optional, default `light`). |
If no dark mode backend theme is set, the light mode theme will also be used in dark mode.
The backend theme settings will be saved and restored on a restart of Home Assistant.
### Manual theme selection
When themes are enabled in the `configuration.yaml` file, a new option will show up in the user profile page (accessed by clicking your user account initials at the bottom of the sidebar). You can then choose any installed theme from the dropdown list and it will be applied immediately.
When themes are enabled in the {% term "`configuration.yaml`" %} file, a new option will show up in the user profile page (accessed by clicking your user account initials at the bottom of the sidebar). You can then choose any installed theme from the dropdown list and it will be applied immediately.
This will overrule the theme settings set by the above service calls, and will only be applied to the current device.
<p class='img'>

View File

@ -73,7 +73,7 @@ devices:
### Extended Configuration Sample
The following example `configuration.yaml` has two different FutureNow units with multiple channels:
The following example {% term "`configuration.yaml`" %} has two different FutureNow units with multiple channels:
```yaml
# Example configuration.yaml entry