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-07-22 08:46:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add some hints about script blueprints (#24134)

Browse Source 
Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
Erik Montnemery 2022-09-15 15:46:54 +02:00 committed by GitHub
parent 44ca76635a
commit eb28e8a421
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 18 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
source/_docs/blueprint.markdown
View File

@ -9,14 +9,20 @@ If you're looking on how to use blueprints, see the [automation documentation](/
</div>
An automation blueprint is an automation configuration with certain parts marked as configurable. This allows users to create multiple automations based on the same blueprint, with each having its own configuration.
<div class='note'>
While the tutorial only shows how to create an automation blueprint, scripts also support blueprints in the same way.
</div>
A blueprint is a script or automation configuration with certain parts marked as configurable. This allows users to create multiple scripts or automations based on the same blueprint, with each having its own configuration.
Imagine a blueprint that controls a light based on motion, that allows you to configure the motion sensor to trigger on, and the light to control. It is now possible to create two automations that each have their own configuration for this blueprint and that act completely independent, yet are based on the same automation configuration.
<div class='note'>
This is an advanced feature and requires knowledge of writing [automations in YAML](/docs/automation/yaml/).
This is an advanced feature and requires knowledge of writing [automations](/docs/automation/yaml/) and [scripts](/docs/scripts/) in YAML.
</div>
### [Tutorial: Create a blueprint &raquo;](/docs/blueprint/tutorial/)
### [Tutorial: Create an automation blueprint &raquo;](/docs/blueprint/tutorial/)

12
source/_docs/blueprint/tutorial.markdown
View File

@ -1,9 +1,15 @@
---
title: "Blueprint tutorial"
description: "Tutorial on creating a blueprint."
title: "Automation blueprint tutorial"
description: "Tutorial on creating an automation blueprint."
---
In this tutorial, we're going to create a blueprint that controls a light based on a motion sensor. We will do this by taking an existing automation and converting it to a blueprint.
<div class='note'>
While the tutorial only shows how to create an automation blueprint, scripts also support blueprints in the same way.
</div>
In this tutorial, we're going to create an automation blueprint that controls a light based on a motion sensor. We will do this by taking an existing automation and converting it to a blueprint.
For this tutorial, we use a simple automation. The process for converting a complex automation is not any different.