mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-23 17:27:19 +00:00
Docs: fix markdown in related meta data section (#32431)
* Docs: fix markdown in related meta data section * Fix markdown * Update source/_docs/organizing/categories.markdown Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com> --------- Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com>
This commit is contained in:
parent
2dde0f3669
commit
980996f0f5
@ -2,8 +2,8 @@
|
|||||||
title: "Automation Trigger"
|
title: "Automation Trigger"
|
||||||
description: "All the different ways how automations can be triggered."
|
description: "All the different ways how automations can be triggered."
|
||||||
related:
|
related:
|
||||||
- docs: /voice_control/custom_sentences/#adding-a-custom-sentence-to-trigger-an-automation
|
- docs: /voice_control/custom_sentences/#adding-a-custom-sentence-to-trigger-an-automation
|
||||||
title: Adding a custom sentence to trigger an automation
|
title: Adding a custom sentence to trigger an automation
|
||||||
---
|
---
|
||||||
|
|
||||||
Triggers are what starts the processing of an {% term automation %} rule. When _any_ of the automation's triggers becomes true (trigger _fires_), Home Assistant will validate the [conditions](/docs/automation/condition/), if any, and call the [action](/docs/automation/action/).
|
Triggers are what starts the processing of an {% term automation %} rule. When _any_ of the automation's triggers becomes true (trigger _fires_), Home Assistant will validate the [conditions](/docs/automation/condition/), if any, and call the [action](/docs/automation/action/).
|
||||||
|
@ -2,14 +2,14 @@
|
|||||||
title: "Configuration.yaml"
|
title: "Configuration.yaml"
|
||||||
description: "Configuring Home Assistant via text files."
|
description: "Configuring Home Assistant via text files."
|
||||||
related:
|
related:
|
||||||
- docs: /docs/configuration/yaml/
|
- docs: /docs/configuration/yaml/
|
||||||
title: YAML syntax
|
title: YAML syntax
|
||||||
- docs: /docs/configuration/secrets
|
- docs: /docs/configuration/secrets
|
||||||
title: Storing credentials in `secrets.yaml` file
|
title: Storing credentials in `secrets.yaml` file
|
||||||
- docs: /common-tasks/os/#backups
|
- docs: /common-tasks/os/#backups
|
||||||
title: Creating and restoring backups
|
title: Creating and restoring backups
|
||||||
- docs: /integrations/backup
|
- docs: /integrations/backup
|
||||||
title: Creating backups for Home Assistant Container and Core
|
title: Creating backups for Home Assistant Container and Core
|
||||||
---
|
---
|
||||||
|
|
||||||
While you can configure most of Home Assistant directly from the user interface under {% my config %}, some parts need you to edit `configuration.yaml`. This file contains {% term integrations %} to be loaded along with their configurations. Throughout the documentation you will find snippets that you can add to your configuration file to enable specific functionality.
|
While you can configure most of Home Assistant directly from the user interface under {% my config %}, some parts need you to edit `configuration.yaml`. This file contains {% term integrations %} to be loaded along with their configurations. Throughout the documentation you will find snippets that you can add to your configuration file to enable specific functionality.
|
||||||
|
@ -2,10 +2,10 @@
|
|||||||
title: "Storing secrets"
|
title: "Storing secrets"
|
||||||
description: "Storing secrets outside of your configuration.yaml."
|
description: "Storing secrets outside of your configuration.yaml."
|
||||||
related:
|
related:
|
||||||
- docs: /docs/configuration/
|
- docs: /docs/configuration/
|
||||||
title: `configuration.yaml` file
|
title: `configuration.yaml` file
|
||||||
- docs: /docs/configuration/splitting_configuration/
|
- docs: /docs/configuration/splitting_configuration/
|
||||||
title: Splitting the configuration
|
title: Splitting the configuration
|
||||||
---
|
---
|
||||||
|
|
||||||
The `configuration.yaml` file is a plain-text file, thus it is readable by anyone who has access to the file. The file contains passwords and API tokens which need to be redacted if you want to share your configuration. By using `!secret` you can remove any private information from your configuration files. This separation can also help you to keep easier track of your passwords and API keys, as they are all stored at one place and no longer spread across the `configuration.yaml` file or even multiple YAML files if you [split up your configuration](/docs/configuration/splitting_configuration/).
|
The `configuration.yaml` file is a plain-text file, thus it is readable by anyone who has access to the file. The file contains passwords and API tokens which need to be redacted if you want to share your configuration. By using `!secret` you can remove any private information from your configuration files. This separation can also help you to keep easier track of your passwords and API keys, as they are all stored at one place and no longer spread across the `configuration.yaml` file or even multiple YAML files if you [split up your configuration](/docs/configuration/splitting_configuration/).
|
||||||
|
@ -2,12 +2,12 @@
|
|||||||
title: "Splitting up the configuration"
|
title: "Splitting up the configuration"
|
||||||
description: "Splitting the configuration.yaml into several files."
|
description: "Splitting the configuration.yaml into several files."
|
||||||
related:
|
related:
|
||||||
- docs: /docs/configuration/
|
- docs: /docs/configuration/
|
||||||
title: `configuration.yaml` file
|
title: `configuration.yaml` file
|
||||||
- docs: /examples/#example-configurationyaml
|
- docs: /examples/#example-configurationyaml
|
||||||
title: Example configuration files by the community
|
title: Example configuration files by the community
|
||||||
- docs: /docs/configuration/packages
|
- docs: /docs/configuration/packages
|
||||||
title: Using packages to organize configuration files
|
title: Using packages to organize configuration files
|
||||||
---
|
---
|
||||||
|
|
||||||
So you've been using Home Assistant for a while now and your `configuration.yaml` file brings people to tears because it has become so large. Or, you simply want to start off with the distributed approach. Here's how to split the `configuration.yaml` into more manageable (read: human-readable) pieces.
|
So you've been using Home Assistant for a while now and your `configuration.yaml` file brings people to tears because it has become so large. Or, you simply want to start off with the distributed approach. Here's how to split the `configuration.yaml` into more manageable (read: human-readable) pieces.
|
||||||
|
@ -2,18 +2,18 @@
|
|||||||
title: "YAML syntax"
|
title: "YAML syntax"
|
||||||
description: "Details about the YAML syntax used to configure Home Assistant."
|
description: "Details about the YAML syntax used to configure Home Assistant."
|
||||||
related:
|
related:
|
||||||
- docs: /docs/configuration/
|
- docs: /docs/configuration/
|
||||||
title: `configuration.yaml` file
|
title: `configuration.yaml` file
|
||||||
- docs: /docs/configuration/secrets/
|
- docs: /docs/configuration/secrets/
|
||||||
title: Storing private data in separate file
|
title: Storing private data in separate file
|
||||||
- docs: /docs/automation/yaml/
|
- docs: /docs/automation/yaml/
|
||||||
title: Automation.yaml
|
title: Automation.yaml
|
||||||
- docs: /docs/configuration/troubleshooting/
|
- docs: /docs/configuration/troubleshooting/
|
||||||
title: Troubleshooting the configuration files
|
title: Troubleshooting the configuration files
|
||||||
- docs: /docs/configuration/#validating-the-configuration
|
- docs: /docs/configuration/#validating-the-configuration
|
||||||
title: Validating the configuration
|
title: Validating the configuration
|
||||||
- url: https://developers.home-assistant.io/docs/documenting/yaml-style-guide/
|
- url: https://developers.home-assistant.io/docs/documenting/yaml-style-guide/
|
||||||
title: YAML Style Guide for Home Assistant developers
|
title: YAML Style Guide for Home Assistant developers
|
||||||
---
|
---
|
||||||
|
|
||||||
Home Assistant uses the [YAML](https://yaml.org/) syntax for configuration. While most integrations can be configured through the UI, some integrations require you to edit your [`configuration.yaml`](/docs/configuration/) file to specify its settings.
|
Home Assistant uses the [YAML](https://yaml.org/) syntax for configuration. While most integrations can be configured through the UI, some integrations require you to edit your [`configuration.yaml`](/docs/configuration/) file to specify its settings.
|
||||||
|
@ -2,12 +2,12 @@
|
|||||||
title: "I'm locked out!"
|
title: "I'm locked out!"
|
||||||
description: "Options for regaining access"
|
description: "Options for regaining access"
|
||||||
related:
|
related:
|
||||||
- docs: /common-tasks/os/#listing-all-users-from-the-command-line
|
- docs: /common-tasks/os/#listing-all-users-from-the-command-line
|
||||||
title: Listing all user names via command line
|
title: Listing all user names via command line
|
||||||
- url: https://yellow.home-assistant.io/guides/factory-reset/
|
- url: https://yellow.home-assistant.io/guides/factory-reset/
|
||||||
title: Reset the Yellow
|
title: Reset the Yellow
|
||||||
- url: https://green.home-assistant.io/guides/reset/
|
- url: https://green.home-assistant.io/guides/reset/
|
||||||
title: Reset the Green
|
title: Reset the Green
|
||||||
---
|
---
|
||||||
|
|
||||||
The sections below deal with recovering from a situation where you are not able to sign in,
|
The sections below deal with recovering from a situation where you are not able to sign in,
|
||||||
|
@ -2,14 +2,14 @@
|
|||||||
title: "Grouping your assets"
|
title: "Grouping your assets"
|
||||||
description: "Grouping your assets makes it easier to find them and allows you to target groups in automations."
|
description: "Grouping your assets makes it easier to find them and allows you to target groups in automations."
|
||||||
related:
|
related:
|
||||||
- docs: /docs/organizing/areas/
|
- docs: /docs/organizing/areas/
|
||||||
title: Areas
|
title: Areas
|
||||||
- docs: /docs/organizing/floors/
|
- docs: /docs/organizing/floors/
|
||||||
title: Floors
|
title: Floors
|
||||||
- docs: /docs/organizing/labels/
|
- docs: /docs/organizing/labels/
|
||||||
title: Labels
|
title: Labels
|
||||||
- docs: /docs/organizing/categories/
|
- docs: /docs/organizing/categories/
|
||||||
title: Categories
|
title: Categories
|
||||||
---
|
---
|
||||||
|
|
||||||
Once you have more devices, you may want to target entire groups of devices in automations. It also becomes more challenging to find items in lists. There are a few tools to group your assets: [Areas](#areas), [floors](#floors), [labels](#labels), and [categories](#categories).
|
Once you have more devices, you may want to target entire groups of devices in automations. It also becomes more challenging to find items in lists. There are a few tools to group your assets: [Areas](#areas), [floors](#floors), [labels](#labels), and [categories](#categories).
|
||||||
|
@ -2,15 +2,15 @@
|
|||||||
title: "Areas"
|
title: "Areas"
|
||||||
description: "Group your devices and entities in areas and group areas in floors."
|
description: "Group your devices and entities in areas and group areas in floors."
|
||||||
related:
|
related:
|
||||||
- docs: /docs/organizing/areas/
|
- docs: /docs/organizing/areas/
|
||||||
title: Areas
|
title: Areas
|
||||||
- docs: /docs/organizing/
|
- docs: /docs/organizing/
|
||||||
- docs: /docs/organizing/labels/
|
- docs: /docs/organizing/labels/
|
||||||
title: Labels
|
title: Labels
|
||||||
- docs: /docs/organizing/categories/
|
- docs: /docs/organizing/categories/
|
||||||
title: Categories
|
title: Categories
|
||||||
- docs: /docs/configuration/templating/#areas
|
- docs: /docs/configuration/templating/#areas
|
||||||
title: Using areas in template
|
title: Using areas in template
|
||||||
---
|
---
|
||||||
|
|
||||||
An area in Home Assistant is a logical grouping of {% term devices %} and {% term entities %} that are meant to match areas (or rooms) in the physical world of your home. For example, the "Living room" area groups devices and entities in your living room. Areas allow you to target an entire group of devices with a service call. For example, turning off all the lights in the living room.
|
An area in Home Assistant is a logical grouping of {% term devices %} and {% term entities %} that are meant to match areas (or rooms) in the physical world of your home. For example, the "Living room" area groups devices and entities in your living room. Areas allow you to target an entire group of devices with a service call. For example, turning off all the lights in the living room.
|
||||||
|
@ -2,12 +2,12 @@
|
|||||||
title: "Categories"
|
title: "Categories"
|
||||||
description: "Use categories to group and filter your table items"
|
description: "Use categories to group and filter your table items"
|
||||||
related:
|
related:
|
||||||
- docs: /docs/organizing/areas/
|
- docs: /docs/organizing/areas/
|
||||||
title: Areas
|
title: Areas
|
||||||
- docs: /docs/organizing/floors/
|
- docs: /docs/organizing/floors/
|
||||||
title: Floors
|
title: Floors
|
||||||
- docs: /docs/organizing/labels/
|
- docs: /docs/organizing/labels/
|
||||||
title: Labels
|
title: Labels
|
||||||
---
|
---
|
||||||
|
|
||||||
Categories let you group and filter items in a table. Like labels, categories allow grouping irrespective of the items physical location. For example, on the automations page, you can create the categories “Notifications” or “NFC tags” to view your automations grouped or filtered. These categories group automations on the automation page, but have no effect anywhere else. Categories are unique for each table. The automations page can have different categories than the scene, scripts, or helpers settings page.
|
Categories let you group and filter items in a table. Like labels, categories allow grouping irrespective of the items physical location. For example, on the automations page, you can create the categories “Notifications” or “NFC tags” to view your automations grouped or filtered. These categories group automations on the automation page, but have no effect anywhere else. Categories are unique for each table. The automations page can have different categories than the scene, scripts, or helpers settings page.
|
||||||
|
@ -2,18 +2,18 @@
|
|||||||
title: "Filtering your assets"
|
title: "Filtering your assets"
|
||||||
description: "Filter for items in tables."
|
description: "Filter for items in tables."
|
||||||
related:
|
related:
|
||||||
- docs: /docs/organizing/floors/
|
- docs: /docs/organizing/floors/
|
||||||
title: Floors
|
title: Floors
|
||||||
- docs: /docs/organizing/labels/
|
- docs: /docs/organizing/labels/
|
||||||
title: Labels
|
title: Labels
|
||||||
- docs: /docs/organizing/areas/
|
- docs: /docs/organizing/areas/
|
||||||
title: Areas
|
title: Areas
|
||||||
- docs: /docs/organizing/categories/
|
- docs: /docs/organizing/categories/
|
||||||
title: Categories
|
title: Categories
|
||||||
- docs: /docs/organizing/
|
- docs: /docs/organizing/
|
||||||
title: Grouping your assets
|
title: Grouping your assets
|
||||||
- docs: /common-tasks/general/
|
- docs: /common-tasks/general/
|
||||||
title: Enabling or disabling entities and automations
|
title: Enabling or disabling entities and automations
|
||||||
---
|
---
|
||||||
|
|
||||||
When working with tables, you can select multiple elements to apply an action on multiple items at once. If you have [grouped](/docs/organizing/) your assets by assigning them to floors, areas, labels, or directories you can also filter your data accordingly.
|
When working with tables, you can select multiple elements to apply an action on multiple items at once. If you have [grouped](/docs/organizing/) your assets by assigning them to floors, areas, labels, or directories you can also filter your data accordingly.
|
||||||
|
@ -2,15 +2,15 @@
|
|||||||
title: "Floors"
|
title: "Floors"
|
||||||
description: "Group your areas per floor"
|
description: "Group your areas per floor"
|
||||||
related:
|
related:
|
||||||
- docs: /docs/organizing/areas/
|
- docs: /docs/organizing/areas/
|
||||||
title: Areas
|
title: Areas
|
||||||
- docs: /docs/organizing/
|
- docs: /docs/organizing/
|
||||||
- docs: /docs/organizing/labels/
|
- docs: /docs/organizing/labels/
|
||||||
title: Labels
|
title: Labels
|
||||||
- docs: /docs/configuration/templating/#floors
|
- docs: /docs/configuration/templating/#floors
|
||||||
title: Using floors in templates
|
title: Using floors in templates
|
||||||
- docs: /voice_control/aliases/
|
- docs: /voice_control/aliases/
|
||||||
title: Using floor alias for voice assistants
|
title: Using floor alias for voice assistants
|
||||||
---
|
---
|
||||||
|
|
||||||
A floor in Home Assistant is a logical grouping of areas meant to match your home's physical floors. Devices and entities
|
A floor in Home Assistant is a logical grouping of areas meant to match your home's physical floors. Devices and entities
|
||||||
|
@ -2,14 +2,14 @@
|
|||||||
title: "Labels"
|
title: "Labels"
|
||||||
description: "Label your areas, devices, entities, automations, scripts, and helpers. Then, filter by label or run an automation on all entities with that label."
|
description: "Label your areas, devices, entities, automations, scripts, and helpers. Then, filter by label or run an automation on all entities with that label."
|
||||||
related:
|
related:
|
||||||
- docs: /docs/organizing/areas/
|
- docs: /docs/organizing/areas/
|
||||||
title: Areas
|
title: Areas
|
||||||
- docs: /docs/organizing/floors/
|
- docs: /docs/organizing/floors/
|
||||||
title: Floors
|
title: Floors
|
||||||
- docs: /docs/organizing/categories/
|
- docs: /docs/organizing/categories/
|
||||||
title: Categories
|
title: Categories
|
||||||
- docs: /docs/configuration/templating/#labels
|
- docs: /docs/configuration/templating/#labels
|
||||||
title: Using labels in templates
|
title: Using labels in templates
|
||||||
---
|
---
|
||||||
|
|
||||||
Labels in Home Assistant allow grouping elements irrespective of their physical location or type. Labels can be assigned to areas, devices, entities, automations, scenes, scripts, and helpers. Labels can be used in automations and scripts as a target for actions and services. Labels can also be used to filter data. For example, you can filter the list of devices to show only devices with the label `heavy energy usage` or turn these devices off when there is not a lot of solar energy available.
|
Labels in Home Assistant allow grouping elements irrespective of their physical location or type. Labels can be assigned to areas, devices, entities, automations, scenes, scripts, and helpers. Labels can be used in automations and scripts as a target for actions and services. Labels can also be used to filter data. For example, you can filter the list of devices to show only devices with the label `heavy energy usage` or turn these devices off when there is not a lot of solar energy available.
|
||||||
|
@ -2,8 +2,8 @@
|
|||||||
title: "check_config"
|
title: "check_config"
|
||||||
description: "Script to perform a check of the current configuration"
|
description: "Script to perform a check of the current configuration"
|
||||||
related:
|
related:
|
||||||
- docs: /docs/configuration/#validating-the-configuration
|
- docs: /docs/configuration/#validating-the-configuration
|
||||||
title: Validating the configuration
|
title: Validating the configuration
|
||||||
---
|
---
|
||||||
|
|
||||||
Test any changes to your `configuration.yaml` file before launching Home Assistant. This script allows you to test changes without the need to restart Home Assistant.
|
Test any changes to your `configuration.yaml` file before launching Home Assistant. This script allows you to test changes without the need to restart Home Assistant.
|
||||||
|
@ -2,12 +2,12 @@
|
|||||||
title: "General troubleshooting"
|
title: "General troubleshooting"
|
||||||
description: "General troubleshooting information"
|
description: "General troubleshooting information"
|
||||||
related:
|
related:
|
||||||
- docs: /docs/configuration/#editing-configurationyaml
|
- docs: /docs/configuration/#editing-configurationyaml
|
||||||
title: Editing your configuration
|
title: Editing your configuration
|
||||||
- docs: /integrations/recovery_mode/
|
- docs: /integrations/recovery_mode/
|
||||||
title: Recovery mode integration
|
title: Recovery mode integration
|
||||||
- docs: /docs/locked_out/
|
- docs: /docs/locked_out/
|
||||||
title: Resetting your password
|
title: Resetting your password
|
||||||
---
|
---
|
||||||
|
|
||||||
This page provides some information about more generic troubleshooting topics.
|
This page provides some information about more generic troubleshooting topics.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user