jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-04-25 22:07:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add terminology tool tips to getting started pages (#26879)

Browse Source
This commit is contained in:
Danny Tsang 2023-04-24 13:09:19 +01:00 committed by GitHub
parent c126e1aa8f
commit e76e3e4a2b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 18 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
source/_data/glossary.yml
View File

@ -97,6 +97,8 @@
Devices have properties such as ID, manufacturer, name, model, hardware version, firmware version, connections, etc.
excerpt: >
A device is a model representing a physical or logical unit that contains entities.
aliases:
- devices
- term: Device tracker
definition: >-
@ -222,6 +224,8 @@
Integrations connect and integrates Home Assistant with your devices,
services, and more.
link: /integrations/
aliases:
- integrations
- term: Lovelace
definition: >-
@ -367,3 +371,5 @@
definition: >-
Zones are areas that can be used for presence detection.
link: /integrations/zone/
aliases:
- zones

28
source/getting-started/automation.markdown
View File

@ -3,32 +3,23 @@ title: "Automating Home Assistant"
description: "A quick intro on getting your first automation going."
---
Once your devices are set up, it's time to put the cherry on the pie: automation. In this guide we're going to create a simple automation rule to turn on the lights when the sun sets. Of course, this assumes that you have set up an integration that provides a light at this point.
Once your {% term devices %} are set up, it's time to put the cherry on the pie: {% term automation %}. In this guide we're going to create a simple automation rule to turn on the lights when the sun sets. Of course, this assumes that you have set up an integration that provides a light at this point.
In the user interface, click **Settings** in the sidebar, then click **Automations & Scenes**. You will now see the automation screen from which you can manage all the automations in Home Assistant.
In the user interface in the sidebar, click **{% my automations title="Settings > Automations & Scenes" %}**. You will now see the automation screen from which you can manage all the automations in Home Assistant.
<p class='img'>
<img src='/images/getting-started/automation-editor.png'>
The automation editor.
</p>
![The automation editor.](/images/getting-started/automation-editor.png)
Click the blue button at the bottom right to create a new automation. A dialog will appear. Choose **Start with an empty automation**. You are presented with a blank automation screen.
Click the blue button at the bottom right to create a new automation. A dialog will appear. Choose **Create new automation**. You are presented with a blank automation screen.
<p class='img'>
<img src='/images/getting-started/new-automation.png'>
The start of a new automation.
</p>
![The start of a new automation.](/images/getting-started/new-automation.png)
The first thing we will do is set a name. Enter "Turn Lights On at Sunset".
The second step is defining what should trigger our automation to run. In this case, we want to use the event of the sun setting to trigger our automation. However, if we would turn on the lights when the sun actually sets, it would be too late as it already gets quite dark while it's setting. So we're going to add an offset.
The second step is defining what should {% term trigger %} our automation to run. In this case, we want to use the event of the sun setting to trigger our automation. However, if we would turn on the lights when the sun actually sets, it would be too late as it already gets quite dark while it's setting. So we're going to add an offset.
In the trigger section, click on the dropdown menu and change the trigger type to **Sun**. It allows us to choose sunrise or sunset, so go ahead and pick **Sunset**. As we discussed, we want our automation to be triggered a little before the sun actually sets, so let's add `-00:30` as the offset. This indicates that the automation will be triggered 30 minutes before the sun actually sets. Neat!
<p class='img'>
<img src='/images/getting-started/new-trigger.png'>
A new automation with a sun trigger filled in.
</p>
![A new automation with a sun trigger filled in.](/images/getting-started/new-trigger.png)
Once we have defined our trigger, scroll down to the action section. Make sure the action type is set to **Call service** and change the service to `light.turn_on`. For this automation we're going to turn on all lights, so let's change the service data to:
@ -36,10 +27,7 @@ Once we have defined our trigger, scroll down to the action section. Make sure t
entity_id: all
```
<p class='img'>
<img src='/images/getting-started/action.png'>
A new automation with the action set up to turn on the lights.
</p>
![A new automation with the action set up to turn on the lights.](/images/getting-started/action.png)
Click the orange button to save the automation. Now wait till it's 30 minutes until the sun sets and see your automation magic!

4
source/getting-started/onboarding.markdown
View File

@ -13,7 +13,7 @@ Next, you can enter a name for your home and set your location and unit system.
![Set your location, time zone, and unit system.](/images/getting-started/location.png)
Once you are done, click **Next**. In this screen, Home Assistant will show any devices that it has discovered on your network. Don't be alarmed if you see fewer items than shown below; you can always manually add devices later.
Once you are done, click **Next**. In this screen, Home Assistant will show any {% term devices %} that it has discovered on your network. Don't be alarmed if you see fewer items than shown below; you can always manually add devices later.
![Discovery of devices on your network.](/images/getting-started/devices.png)
@ -21,7 +21,7 @@ Finally, click **Finish**. Now you're brought to the Home Assistant web interfac
![The Home Assistant user interface.](/images/getting-started/lovelace.png)
From the side bar, click on {% my integrations title="Settings > Devices & Services" %}. On this screen, you will be able to set up integrations with Home Assistant. You might notice a **discovered** section. This section contains integrations that were found on your network and can easily be added with a few clicks. If your integrations are not discovered, click the **Add integration** button (in the lower right of the window) and search for your integration in that list.
From the side bar, click on {% my integrations title="Settings > Devices & Services" %}. On this screen, you will be able to set up {% term integrations %} with Home Assistant.
![The integrations page in the configurations panel shows you all your configured integrations.](/images/getting-started/integrations.png)

4
source/getting-started/presence-detection.markdown
View File

@ -12,7 +12,7 @@ Presence detection detects if people are home, which can be valuable input for a
### Adding presence detection
There are different ways of setting up presence detection. Usually the easiest way to detect presence is by checking which devices are connected to the network. You can do that if you have one of our [supported routers][routers]. By leveraging what your router already knows, you can easily detect if people are at home.
There are different ways of setting up presence detection. Usually the easiest way to detect presence is by checking which {% term devices %} are connected to the network. You can do that if you have one of our [supported routers][routers]. By leveraging what your router already knows, you can easily detect if people are at home.
It's also possible to run an app on your phone to provide detailed location information to your Home Assistant instance. For iOS and Android, we suggest using the [Home Assistant Companion app][companion].
@ -22,7 +22,7 @@ During the setup of Home Assistant Companion on your mobile device, the app will
### Zones
![Map with zones](/images/screenshots/badges-zone.png)
Zones allow you to name areas on a map. These areas can then be used to name the location a tracked user is, or use entering/leaving a zone as an automation [trigger] or [condition]. See [Zones integration](/integrations/zone/) page for more details like creating zones.
{% term Zones %} allow you to name areas on a map. These areas can then be used to name the location a tracked user is, or use entering/leaving a zone as an automation {% term trigger %} or {% term condition %}. See [Zones integration](/integrations/zone/) page for more details like creating zones.
<div class='note'>
The map view will hide all devices that are home.