Using blueprints: tiny style tweaks (#27968)

This commit is contained in:
c0ffeeca7 2023-06-26 13:40:58 +02:00 committed by GitHub
parent aba79152b5
commit dfb109679f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1,5 +1,5 @@
---
title: "Using Automation Blueprints"
title: "Using automation blueprints"
description: "How to create automations based off blueprints."
---
@ -9,31 +9,35 @@ Quick links:
- [Blueprints in the Home Assistant forums][blueprint-forums]
## Blueprint Automations
## Blueprint automations
Automations based on a blueprint only need to be configured to be used. What needs to be configured differs on each blueprint.
Automations based on a blueprint need to be configured. What needs to be configured differs on each blueprint.
To create your first automation based on a blueprint, go to **{% my blueprints title="Settings > Automations & Scenes > Blueprints" %}**. Find the blueprint that you want to use and select **Create Automation**.
1. To create your first automation based on a blueprint, go to **{% my blueprints title="Settings > Automations & Scenes > Blueprints" %}**.
1. Find the blueprint that you want to use and select **Create Automation**.
- This opens the automation editor with the blueprint selected.
1. Give it a name and configure the blueprint.
1. Select the blue **Save Automation** button in the bottom right corner.
This will open the automation editor with the blueprint selected. Give it a name and configure the blueprint and click on the blue button "Save Automation" in the bottom right.
Done! If you want to revisit the configuration values, you can find it by going to **Settings** and then **{% my blueprints %}**.
Done! If you want to revisit the configuration values, go to **{% my blueprints title="Settings > Automations & Scenes > Blueprints" %}**.
## Importing blueprints
Home Assistant can import blueprints from the Home Assistant forums, GitHub and GitHub gists.
Home Assistant can import blueprints from the Home Assistant forums, GitHub, and GitHub gists.
To do this, first [find a blueprint you want to import][blueprint-forums]. If you just want to practice importing, you can use this URL:
1. To import a blueprint, first [find a blueprint you want to import][blueprint-forums].
- If you just want to practice importing, you can use this URL:
```text
https://github.com/home-assistant/core/blob/dev/homeassistant/components/automation/blueprints/motion_light.yaml
```
```text
https://github.com/home-assistant/core/blob/dev/homeassistant/components/automation/blueprints/motion_light.yaml
```
Go to **{% my config %}** and then **{% my blueprints %}**. Click on the blue "{% my blueprint_import blueprint="https://github.com/home-assistant/core/blob/master/homeassistant/components/automation/blueprints/motion_light.yaml" %} button in the bottom right.
A new dialog will pop-up asking you for the URL. Enter the URL and click on "preview blueprint".
This will load the blueprint and show a preview in the import dialog. You can change the name and finish the import.
1. Go to **{% my blueprints title="Settings > Automations & Scenes > Blueprints" %}**.
1. Select the blue **{% my blueprint_import blueprint="https://github.com/home-assistant/core/blob/master/homeassistant/components/automation/blueprints/motion_light.yaml" %}** button in the bottom right.
- A new dialog will pop-up asking you for the URL.
1. Enter the URL and select **Preview**.
- This will load the blueprint and show a preview in the import dialog.
- You can change the name and finish the import.
The blueprint can now be used for creating automations.
@ -46,11 +50,11 @@ While there's no built-in functionality to update a blueprint you've already imp
its YAML content to keep it up to date:
1. Navigate to the blueprints directory (`blueprints/automation/`).
The location of this directory depends on the installation method and it's
The location of this directory depends on the installation method. It's
similar to how you find [`configuration.yaml`](/docs/configuration/#editing-configurationyaml).
1. Next, you must find the blueprint to update. The path name of a blueprint consists of:
- The username of the user that created it, which depends from where you imported the blueprint,
the forum or GitHub.
- The username of the user that created it. The name depends on the source of the blueprint:
the forum, or GitHub.
- The name of the YAML file. For the forum it's the title of the topic in the URL, for GitHub
it's the name of the YAML file.
1. Open the YAML file with your editor and update its contents.
@ -71,7 +75,7 @@ The Home Assistant Community forums have a specific tag for blueprints. This tag
Using blueprints is nice and easy, but what if you could create that one missing
blueprint that our community definitely needs?
Learn more about blueprint by [reading our tutorial on creating a blueprint](/docs/blueprint/tutorial/).
Learn more about blueprints by [reading our tutorial on creating a blueprint](/docs/blueprint/tutorial/).
## Troubleshooting missing automations