diff --git a/CODEOWNERS b/CODEOWNERS index 6bfca80443b..7d112dedd4c 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -33,11 +33,12 @@ source/_integrations/airvisual.markdown @bachya source/_integrations/airvisual_pro.markdown @bachya source/_integrations/airzone.markdown @Noltari source/_integrations/airzone_cloud.markdown @Noltari -source/_integrations/aladdin_connect.markdown @mkmer +source/_integrations/aladdin_connect.markdown @swcloudgenie source/_integrations/alarm_control_panel.markdown @home-assistant/core source/_integrations/alert.markdown @home-assistant/core @frenck source/_integrations/alexa.markdown @home-assistant/cloud @ochlocracy @jbouwh source/_integrations/alexa.smart_home.markdown @home-assistant/cloud @ochlocracy @jbouwh +source/_integrations/amazon_polly.markdown @jschlyter source/_integrations/amberelectric.markdown @madpilot source/_integrations/ambient_network.markdown @thomaskistler source/_integrations/ambient_station.markdown @bachya @@ -62,6 +63,7 @@ source/_integrations/apprise.markdown @caronc source/_integrations/aprilaire.markdown @chamberlain2007 source/_integrations/aprs.markdown @PhilRW source/_integrations/apsystems.markdown @mawoka-myblock @SonnenladenGmbH +source/_integrations/aquacell.markdown @Jordi1990 source/_integrations/aranet.markdown @aschmitz @thecode @anrijs source/_integrations/arcam_fmj.markdown @elupus source/_integrations/arris_tg2492lg.markdown @vanbalken @@ -83,6 +85,7 @@ source/_integrations/automation.markdown @home-assistant/core source/_integrations/avea.markdown @pattyland source/_integrations/awair.markdown @ahayworth @danielsjf source/_integrations/axis.markdown @Kane610 +source/_integrations/azure_data_explorer.markdown @kaareseras source/_integrations/azure_devops.markdown @timmo001 source/_integrations/azure_event_hub.markdown @eavanvalkenburg source/_integrations/azure_service_bus.markdown @hfurubotten @@ -95,7 +98,7 @@ source/_integrations/beewi_smartclim.markdown @alemuro source/_integrations/bge.markdown @tronikos source/_integrations/binary_sensor.markdown @home-assistant/core source/_integrations/bizkaibus.markdown @UgaitzEtxebarria -source/_integrations/blebox.markdown @bbx-a @riokuu @swistakm +source/_integrations/blebox.markdown @bbx-a @swistakm source/_integrations/blink.markdown @fronzbot @mkmer source/_integrations/bliss_automation.markdown @starkillerOG source/_integrations/bloc_blinds.markdown @starkillerOG @@ -216,7 +219,7 @@ source/_integrations/elmax.markdown @albertogeniola source/_integrations/elv.markdown @majuss source/_integrations/elvia.markdown @ludeeus source/_integrations/emby.markdown @mezz64 -source/_integrations/emoncms.markdown @borpin +source/_integrations/emoncms.markdown @borpin @alexandrecuer source/_integrations/emonitor.markdown @bdraco source/_integrations/emulated_hue.markdown @bdraco @Tho85 source/_integrations/emulated_kasa.markdown @kbickar @@ -359,7 +362,7 @@ source/_integrations/hurrican_shutters_wholesale.markdown @starkillerOG source/_integrations/husqvarna_automower.markdown @Thomas55555 source/_integrations/huum.markdown @frwickst source/_integrations/hvv_departures.markdown @vigonotion -source/_integrations/hydrawise.markdown @dknowles2 @ptcryan +source/_integrations/hydrawise.markdown @dknowles2 @thomaskistler @ptcryan source/_integrations/hyperion.markdown @dermotduffy source/_integrations/ialarm.markdown @RyuzakiKK source/_integrations/iammeter.markdown @lewei50 @@ -374,7 +377,7 @@ source/_integrations/image_upload.markdown @home-assistant/core source/_integrations/imap.markdown @jbouwh source/_integrations/imgw_pib.markdown @bieniu source/_integrations/improv_ble.markdown @emontnemery -source/_integrations/incomfort.markdown @zxdavb +source/_integrations/incomfort.markdown @jbouwh source/_integrations/indianamichiganpower.markdown @tronikos source/_integrations/influxdb.markdown @mdegat01 source/_integrations/inkbird.markdown @bdraco @@ -399,6 +402,7 @@ source/_integrations/isal.markdown @bdraco source/_integrations/islamic_prayer_times.markdown @engrbm87 @cpfair source/_integrations/ismartwindow.markdown @starkillerOG source/_integrations/iss.markdown @DurgNomis-drol +source/_integrations/ista_ecotrend.markdown @tr4nt0r source/_integrations/isy994.markdown @bdraco @shbatm source/_integrations/izone.markdown @Swamp-Ig source/_integrations/jellyfin.markdown @j-stienstra @ctalkington @@ -417,6 +421,7 @@ source/_integrations/keyboard_remote.markdown @bendavid @lanrat source/_integrations/keymitt_ble.markdown @spycle source/_integrations/kitchen_sink.markdown @home-assistant/core source/_integrations/kmtronic.markdown @dgomes +source/_integrations/knocki.markdown @joostlek @jgatto1 source/_integrations/knx.markdown @Julius2342 @farmio @marvin-w source/_integrations/kodi.markdown @OnFreund source/_integrations/konnected.markdown @heythisisnate @@ -468,12 +473,14 @@ source/_integrations/martec.markdown @starkillerOG source/_integrations/mastodon.markdown @fabaff source/_integrations/matrix.markdown @PaarthShah source/_integrations/matter.markdown @home-assistant/matter +source/_integrations/mealie.markdown @joostlek source/_integrations/meater.markdown @Sotolotl @emontnemery source/_integrations/medcom_ble.markdown @elafargue source/_integrations/media_extractor.markdown @joostlek source/_integrations/media_player.markdown @home-assistant/core source/_integrations/media_source.markdown @hunterjm source/_integrations/mediaroom.markdown @dgomes +source/_integrations/melcloud.markdown @erwindouna source/_integrations/melissa.markdown @kennedyshead source/_integrations/melnor.markdown @vanstinator source/_integrations/met.markdown @danielhiversen @@ -512,7 +519,7 @@ source/_integrations/mysensors.markdown @MartinHjelmare @functionpointer source/_integrations/mystrom.markdown @fabaff source/_integrations/myuplink.markdown @pajzo @astrandb source/_integrations/nam.markdown @bieniu -source/_integrations/nanoleaf.markdown @milanmeu +source/_integrations/nanoleaf.markdown @milanmeu @joostlek source/_integrations/neato.markdown @Santobert source/_integrations/nederlandse_spoorwegen.markdown @YarmoM source/_integrations/ness_alarm.markdown @nickw444 @@ -559,6 +566,7 @@ source/_integrations/onboarding.markdown @home-assistant/core source/_integrations/oncue.markdown @bdraco @peterager source/_integrations/ondilo_ico.markdown @JeromeHXP source/_integrations/onewire.markdown @garbled1 @epenet +source/_integrations/onkyo.markdown @arturpragacz source/_integrations/onvif.markdown @hunterjm source/_integrations/open_meteo.markdown @frenck source/_integrations/openai_conversation.markdown @balloob @@ -622,6 +630,7 @@ source/_integrations/pushbullet.markdown @engrbm87 source/_integrations/pushover.markdown @engrbm87 source/_integrations/pvoutput.markdown @frenck source/_integrations/pvpc_hourly_pricing.markdown @azogue +source/_integrations/pyload.markdown @tr4nt0r source/_integrations/qbittorrent.markdown @geoffreylagaisse @finder39 source/_integrations/qingping.markdown @bdraco source/_integrations/qld_bushfire.markdown @exxamalte @@ -665,7 +674,7 @@ source/_integrations/ring.markdown @sdb9696 source/_integrations/risco.markdown @OnFreund source/_integrations/rituals_perfume_genie.markdown @milanmeu @frenck source/_integrations/rmvtransport.markdown @cgtobi -source/_integrations/roborock.markdown @humbertogontijo @Lash-L +source/_integrations/roborock.markdown @Lash-L source/_integrations/roku.markdown @ctalkington source/_integrations/romy.markdown @xeniter source/_integrations/roomba.markdown @pschmitt @cyr-ius @shenxn @Xitee1 @Orhideous @@ -743,7 +752,7 @@ source/_integrations/snmp.markdown @nmaggioni source/_integrations/snooz.markdown @AustinBrunkhorst source/_integrations/solaredge.markdown @frenck @bdraco source/_integrations/solaredge_local.markdown @drobtravels @scheric -source/_integrations/solarlog.markdown @Ernst79 +source/_integrations/solarlog.markdown @Ernst79 @dontinelli source/_integrations/solax.markdown @squishykid source/_integrations/soma.markdown @ratsept @sebfortier2288 source/_integrations/somfy.markdown @imicknl @vlebourl @tetienne @nyroDev @tronix117 @@ -826,9 +835,9 @@ source/_integrations/todoist.markdown @boralyl source/_integrations/tolo.markdown @MatthiasLohr source/_integrations/tomorrowio.markdown @raman325 @lymanepp source/_integrations/totalconnect.markdown @austinmroczek -source/_integrations/tplink.markdown @rytilahti @thegardenmonkey @bdraco @sdb9696 +source/_integrations/tplink.markdown @rytilahti @bdraco @sdb9696 source/_integrations/tplink_omada.markdown @MarkGodwin -source/_integrations/tplink_tapo.markdown @rytilahti @thegardenmonkey @bdraco @sdb9696 +source/_integrations/tplink_tapo.markdown @rytilahti @bdraco @sdb9696 source/_integrations/traccar.markdown @ludeeus source/_integrations/traccar_server.markdown @ludeeus source/_integrations/tractive.markdown @Danielhiversen @zhulik @bieniu @@ -848,7 +857,6 @@ source/_integrations/ukraine_alarm.markdown @PaulAnnekov source/_integrations/unifi.markdown @Kane610 source/_integrations/unifi_direct.markdown @tofuSCHNITZEL source/_integrations/unifiled.markdown @florisvdk -source/_integrations/unifiprotect.markdown @bdraco source/_integrations/upb.markdown @gwww source/_integrations/upc_connect.markdown @pvizeli @fabaff source/_integrations/upcloud.markdown @scop diff --git a/Gemfile.lock b/Gemfile.lock index 7090555883f..b8c402b3013 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -88,7 +88,7 @@ GEM prism (0.30.0) public_suffix (6.0.0) racc (1.8.0) - rack (3.1.4) + rack (3.1.6) rack-protection (4.0.0) base64 (>= 0.1.0) rack (>= 3.0.0, < 4) @@ -130,9 +130,8 @@ GEM ruby2_keywords (0.0.5) safe_yaml (1.0.5) sass (3.4.25) - sass-embedded (1.77.5) + sass-embedded (1.77.5-x86_64-linux-gnu) google-protobuf (>= 3.25, < 5.0) - rake (>= 13) sass-globbing (1.1.5) sass (>= 3.1) sassc (2.1.0-x86_64-linux) @@ -143,7 +142,7 @@ GEM rack-protection (= 4.0.0) rack-session (>= 2.0.0, < 3) tilt (~> 2.0) - sorbet-runtime (0.5.11460) + sorbet-runtime (0.5.11471) stringex (2.8.6) strscan (3.1.0) terminal-table (3.0.2) diff --git a/_config.yml b/_config.yml index fa7a68b274f..deb6e67b8f7 100644 --- a/_config.yml +++ b/_config.yml @@ -107,9 +107,9 @@ social: # Home Assistant release details current_major_version: 2024 -current_minor_version: 6 -current_patch_version: 4 -date_released: 2024-06-21 +current_minor_version: 7 +current_patch_version: 0 +date_released: 2024-07-03 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. diff --git a/plugins/icon.rb b/plugins/icon.rb new file mode 100644 index 00000000000..268bd6a7354 --- /dev/null +++ b/plugins/icon.rb @@ -0,0 +1,32 @@ +module Jekyll + module HomeAssistant + class Icon < Liquid::Tag + + def initialize(tag_name, args, tokens) + super + if args.strip =~ SYNTAX + @icon = Regexp.last_match(1).downcase + else + raise SyntaxError, <<~MSG + Syntax error in tag 'icon' while parsing the following options: + + #{args} + + Valid syntax: + {% icon ":" %} + MSG + end + end + + def render(_context) + "" + end + + private + + SYNTAX = %r!^"([a-z0-9]+(?:-[a-z0-9]+)*:[a-z0-9]+(?:-[a-z0-9]+)*)"$!.freeze + end + end +end + +Liquid::Template.register_tag('icon', Jekyll::HomeAssistant::Icon) diff --git a/sass/homeassistant/_overrides.scss b/sass/homeassistant/_overrides.scss index 879811d10b1..efa5eefd6e7 100644 --- a/sass/homeassistant/_overrides.scss +++ b/sass/homeassistant/_overrides.scss @@ -286,11 +286,12 @@ header .breadcrumbs { .links { margin-top: 12px; margin-right: -8px; + margin-bottom: -8px; font-size: .9rem; text-align: right; a { - background: #e8edf0; + background: #e8edf0; font-family: $heading-font; text-decoration: none; font-weight: 650; @@ -363,7 +364,7 @@ a.material-card:hover { border-radius: 24px; margin: 8px 0; transition: box-shadow .33s; - + &::before { content: " "; position: absolute; @@ -401,7 +402,13 @@ a.material-card:hover { } } +/* not contained inside frontpage class */ +.hero { + display: flex; +} + .frontpage { + .material-card { margin-bottom: 24px; } @@ -483,11 +490,11 @@ a.material-card:hover { border: none; .caption { - padding: 16px 12px 12px; + padding: 8px 12px 12px; background-color: rgba(0, 0, 0, 0.54); color: white; - border-bottom-left-radius: 8px; - border-bottom-right-radius: 8px; + border-bottom-left-radius: 16px; + border-bottom-right-radius: 16px; display: flex; justify-content: space-between; align-items: center; @@ -495,9 +502,12 @@ a.material-card:hover { .title { font-size: 20px; font-weight: 400; + line-height: 1.2em; } .subtitle { + margin-top: 4px; + line-height: 1.4em; font-size: 12px; font-weight: initial; } @@ -532,26 +542,37 @@ a.material-card:hover { margin-top: 24px; } - .sponsored-by { - img { - border: 0; - border-radius: 0; - box-shadow: none; - margin: 15px; - max-width: 40%; - max-height: 80px; + .seen-press { + display: grid; + grid-template-columns: repeat(auto-fill, minmax(240px, 1fr)); + column-gap: 24px; + row-gap: 24px; + margin: 48px 0; + + h2 { + grid-column: 1/-1; + margin: 0; + text-align: center; } - } - - .seen-press { + a { + aspect-ratio: 1; + } img { border: 0; box-shadow: none; - margin: 15px; - max-width: 40%; - max-height: 70px; + margin: 24px; + width: calc(100% - 48px); + max-height: 128px; + border-radius: 0; + } + + .material-card { + height: 100%; + align-content: center; + text-align: center; + margin: 0; } .square { @@ -562,6 +583,18 @@ a.material-card:hover { border-radius: 50%; } } + + .sponsored-by { + text-align: center; + + img { + border: 0; + border-radius: 0; + box-shadow: none; + margin: 24px; + max-height: 160px; + } + } } @media screen and (max-width: 700px) { @@ -620,7 +653,6 @@ article.page, article.listing { font-size: 1.125em; line-height: 1.6; - overflow: hidden; img, table { @@ -681,6 +713,7 @@ article.listing { overflow-wrap: break-word; &.btn { + font-size: 1.1em; text-decoration: none; transition: box-shadow .33; @@ -728,8 +761,8 @@ article.listing { &>li.toc-entry:first-child{ padding-top: 0; - } - + } + &>li.toc-entry { list-style-type: none; } @@ -895,7 +928,7 @@ div.config-vars { .config-vars-label { padding-bottom: 4px; position: relative; - + a.title-link { text-decoration: none; } @@ -1052,4 +1085,4 @@ a.my { position: fixed; width: 100%; z-index: 999; -} \ No newline at end of file +} diff --git a/sass/homeassistant/base/_sidebar.scss b/sass/homeassistant/base/_sidebar.scss index d4af6318959..f0ad38166e1 100644 --- a/sass/homeassistant/base/_sidebar.scss +++ b/sass/homeassistant/base/_sidebar.scss @@ -44,6 +44,8 @@ @media only screen and (max-width: $lap-end) { #sidebar { + max-height: fit-content; + .grid { position: initial; width: 100%; diff --git a/sass/homeassistant/homepage/_features.scss b/sass/homeassistant/homepage/_features.scss index ad044177616..bc8e51dfbcc 100644 --- a/sass/homeassistant/homepage/_features.scss +++ b/sass/homeassistant/homepage/_features.scss @@ -26,11 +26,11 @@ } .card-content { - padding-left: 24px; + padding-bottom: 24px; p:last-of-type, ul { - margin-bottom: 12px; + margin-bottom: 32px; } } } diff --git a/sass/homeassistant/homepage/_hero_unit.scss b/sass/homeassistant/homepage/_hero_unit.scss index 757132ffc61..400531e805d 100644 --- a/sass/homeassistant/homepage/_hero_unit.scss +++ b/sass/homeassistant/homepage/_hero_unit.scss @@ -8,7 +8,7 @@ padding-bottom: 0; margin-top: -88px; margin-bottom: 24px; - padding-top: 88px; + padding-top: 88px; overflow: hidden; border-bottom: 1px solid rgba(0, 0, 0, 0.1); max-height: 1080px; @@ -62,7 +62,7 @@ background-color: $link-color; font-size: 2rem; font-weight: 700; - padding: 8px 24px; + padding: 8px 20px 8px 28px; margin-bottom: 16px; } } @@ -84,7 +84,7 @@ // animation-duration: 3s; // animation-iteration-count: infinite; // animation-direction: alternate; - + @media only screen and (max-height: 720px) { border-bottom: 0; margin-bottom: -8px; @@ -114,7 +114,7 @@ .lead { font-size: 1.15rem; } - + .hero-buttons a { &.primary { font-size: 1.25rem; @@ -123,15 +123,19 @@ } } -@media only screen and (max-width: $palm-end) { +@media only screen and (max-width: 760px) { .hero { - + .flex { + flex-direction: column; + } + #HAdemo { display: none; } - + #HAdemoScreenshot { display: block; } + } -} \ No newline at end of file +} diff --git a/sass/homeassistant/pages/_getting_started.scss b/sass/homeassistant/pages/_getting_started.scss index c088c200a13..3428bc24524 100644 --- a/sass/homeassistant/pages/_getting_started.scss +++ b/sass/homeassistant/pages/_getting_started.scss @@ -126,19 +126,32 @@ .button { display: flex; + align-items: center; padding-right: 20px; + border-radius: 32px; + &:not(:first-child) { margin-top: 12px; } - &.accent { - background-color: #34b155; + iconify-icon.external-link { + padding-top: 4px; } + svg { - fill: white; + fill: $link-color; height: 24px; min-width: 24px; } + + &.accent { + background-color: #34b155; + color: white; + + svg { + fill: white; + } + } } } } diff --git a/sass/homeassistant/pages/_landingpage.scss b/sass/homeassistant/pages/_landingpage.scss index 5309612b7ba..645bfbeaf60 100644 --- a/sass/homeassistant/pages/_landingpage.scss +++ b/sass/homeassistant/pages/_landingpage.scss @@ -11,6 +11,13 @@ $ha__primary_color: #03a9f4; } } + footer { + .grid-wrapper { + max-width: 1100px !important; + padding: 0 25px !important; + } + } + .grid-wrapper { max-width: 1500px; padding: 0; diff --git a/source/_docs/automation/troubleshooting.markdown b/source/_docs/automation/troubleshooting.markdown index 458a88dc5b2..5e53c3e88bc 100644 --- a/source/_docs/automation/troubleshooting.markdown +++ b/source/_docs/automation/troubleshooting.markdown @@ -19,7 +19,7 @@ Testing with complex triggers, conditions, and variables can be difficult. Note ### Running individual actions or conditions -In the automation editor UI, each {% term condition %} and {% term action %} can be tested individually. Select the three dots menu, then the **Test** button. +In the automation editor UI, each {% term condition %} and {% term action %} can be tested individually. Select the three dots {% icon "mdi:dots-vertical" %} menu, then the **Test** button. - Testing a condition will highlight it to show whether the condition passed at the moment it was tested. If all conditions pass, then the automation will run when triggered. Testing building blocks like an **and** condition will report whether the whole block registers as true or false, or you can test individual conditions within the building block. diff --git a/source/_docs/automation/using_blueprints.markdown b/source/_docs/automation/using_blueprints.markdown index ff924b5f73b..3dd95e1ed79 100644 --- a/source/_docs/automation/using_blueprints.markdown +++ b/source/_docs/automation/using_blueprints.markdown @@ -43,14 +43,14 @@ The blueprint can now be used for creating automations. ## Editing an imported blueprint -If you want, you can tweak an imported Blueprint by "taking control" of this blueprint. Home Assistant then converts the blueprint automation into a regular, stand-alone, automation, allowing you to make any tweak you want, without having to fully re-invent the wheel. +You can tweak an imported blueprint by "taking control" of this blueprint. Home Assistant then converts the blueprint automation into a regular automation, allowing you to make any tweak without having to fully re-invent the wheel. To edit an imported blueprint, follow these steps: 1. Go to **{% my blueprints title="Settings > Automations & Scenes > Blueprints" %}**. 2. Select the blueprint from the list. 3. Select the three dots menu and select **Take control**. - + ![Screencast showing how to take control of a blueprint](/images/blueprints/blueprint_take_control.webp) 4. Under **Take control of automation?**, select **OK** @@ -59,19 +59,27 @@ To edit an imported blueprint, follow these steps: ## Re-importing a blueprint Blueprints created by the community may go through multiple revisions. Sometimes a user creates a blueprint, -the community provides feedback, and new functionality is added. +the community provides feedback, new functionality is added. -The quickest way to get these changes is by re-importing the blueprint. This will overwrite the blueprint you currently have. +The quickest way to get these changes, is by re-importing the blueprint. This will overwrite the blueprint you currently have. -1. **Before you do this**: If the re-imported blueprint is not compatible, it can break your automations. - - In this case, you will need to manually adjust your automations. -2. Go to **{% my blueprints title="Settings > Automations & Scenes > Blueprints" %}**. -3. On the blueprint that you want to re-import, select the three-dot menu, and select **Re-import blueprint**. +{% caution %} + +**Before you do this**: If the re-imported blueprint is not compatible, it can break your automations. + +- In this case, you will need to manually adjust your automations. + +{% endcaution%} + +### To re-import a blueprint + +1. Go to **{% my blueprints title="Settings > Automations & Scenes > Blueprints" %}**. +2. On the blueprint that you want to re-import, select the three-dot menu, and select **Re-import blueprint**. ## Updating an imported blueprint in YAML Blueprints created by the community may go through multiple revisions. Sometimes a user creates a blueprint, -the community provides feedback, and new functionality is added. +the community provides feedback, new functionality is added. If you do not want to [re-import the blueprint](/docs/automation/using_blueprints/#re-importing-a-blueprint) for some reason, you can manually edit its YAML content to keep it up to date: diff --git a/source/_docs/backend/database.markdown b/source/_docs/backend/database.markdown index 53acac2ad04..743d26c0ed8 100644 --- a/source/_docs/backend/database.markdown +++ b/source/_docs/backend/database.markdown @@ -5,7 +5,7 @@ description: "Details about the database used by Home Assistant." Home Assistant uses databases to store {% term events %} and parameters for history and tracking. The default database used is [SQLite](https://www.sqlite.org/). -The database file is stored in your [configuration directory](/getting-started/configuration/) (e.g., `/home-assistant_v2.db`); however, other databases can be used. If you prefer to run a database server (e.g., PostgreSQL), use the [`recorder`](/integrations/recorder/) integration. +The database file is stored in your [configuration directory](/docs/configuration/#to-find-the-configuration-directory) (e.g., `/home-assistant_v2.db`); however, other databases can be used. If you prefer to run a database server (e.g., PostgreSQL), use the [`recorder`](/integrations/recorder/) integration. To work with SQLite database manually from the command-line, you will need an [installation](https://www.sqlitetutorial.net/download-install-sqlite/) of `sqlite3`. Alternatively [DB Browser for SQLite](https://sqlitebrowser.org/) provides a viewer for exploring the database data and an editor for executing SQL commands. First load your database with `sqlite3`: diff --git a/source/_docs/configuration.markdown b/source/_docs/configuration.markdown index 4f08b345dad..b73bfb1378f 100644 --- a/source/_docs/configuration.markdown +++ b/source/_docs/configuration.markdown @@ -70,6 +70,12 @@ To set up file access, follow the steps for your [installation method](/installa - {% term "Home Assistant Core" %}: the `configuration.yaml` is in the config folder passed to the `hass` command (default is `~/.homeassistant`). 3. Once you located the config folder, you can edit your `configuration.yaml` file. +{% note %} + +If you have watched any videos about setting up Home Assistant using `configuration.yaml` (particularly ones that are old), you might notice your default configuration file is much smaller than what the videos show. Don't be concerned, you haven't done anything wrong. Many items in the default configuration files shown in those old videos are now included in the `default_config:` line that you see in your configuration file. Refer to the [default config integration](/integrations/default_config/) for more information on what's included in that line. + +{% endnote %} + ## Validating the configuration After changing configuration or automation files, you can check if the configuration is valid. A configuration check is also applied automatically when you reload the configuration or when you restart Home Assistant. @@ -85,7 +91,7 @@ The method for running a configuration check depends on your [installation type] For configuration changes to become effective, the configuration must be reloaded. Most integrations in Home Assistant (that do not interact with {% term devices %} or {% term services %}) can reload changes made to their configuration in `configuration.yaml` without needing to restart Home Assistant. -1. Under **Settings**, select the three dots menu (top right), select **Restart Home Assistant** > **Quick reload**. +1. Under **Settings**, select the three dots menu (top right) {% icon "mdi:dots-vertical" %}, select **Restart Home Assistant** > **Quick reload**. ![Settings, three dot menu, restart Home Assistant](/images/docs/configuration/settings_restart_ha.png) diff --git a/source/_docs/organizing/categories.markdown b/source/_docs/organizing/categories.markdown index a40b429d7cc..2afe900b642 100644 --- a/source/_docs/organizing/categories.markdown +++ b/source/_docs/organizing/categories.markdown @@ -31,7 +31,7 @@ Follow these steps to create a new category. 1. Go to {% my automations title="**Settings** > **Automations & Scenes**" %} and open the respective tab. 2. To assign a category to a single item: - - Find the item in the list and select the three dots menu. + - Find the item in the list and select the three dots {% icon "mdi:dots-vertical" %} menu. - Select **Assign category** and select the category from the list. - If the category is not in the list, select **Add new category** and make a new one. 3. To assign a category to multiple items: diff --git a/source/_docs/organizing/floors.markdown b/source/_docs/organizing/floors.markdown index f2be3664f8f..bb62473b88b 100644 --- a/source/_docs/organizing/floors.markdown +++ b/source/_docs/organizing/floors.markdown @@ -44,7 +44,7 @@ Follow these steps to create a new floor. Follow these steps to delete a floor. Areas that are assigned to a floor will become unassigned. Automations and scripts or voice assistants that used a floor as a target will no longer work as they no longer have a target. 1. Go to {% my areas title="**Settings** > **Areas, labels & zones**" %}. -2. Next to the floor, select the three dots menu and select **Delete floor**. +2. Next to the floor, select the three dots {% icon "mdi:dots-vertical" %} menu and select **Delete floor**. ![Screenshot showing the dialog to delete a floor](/images/organizing/floor_delete.png) diff --git a/source/_docs/organizing/labels.markdown b/source/_docs/organizing/labels.markdown index e2db75cf2ce..da948036c15 100644 --- a/source/_docs/organizing/labels.markdown +++ b/source/_docs/organizing/labels.markdown @@ -51,7 +51,7 @@ Follow these steps to apply a label - Go to {% my automations title="**Settings** > **Automations & Scenes**" %} and open the respective tab. - Select the Multiselect icon button. - From the list, select all the list entries to which you want to apply a label. - - In the top right corner, select the three dots menu, then select **Add label**. Then, select the labels from the list. + - In the top right corner, select the three dots {% icon "mdi:dots-vertical" %} menu, then select **Add label**. Then, select the labels from the list. ## Deleting a label @@ -59,7 +59,7 @@ Follow these steps to delete a label. It will be removed from all the list entri If you used this label in automations or script as targets, you need to adjust those. 1. Go to {% my labels title="**Settings** > **Areas, labels & zones**" %} and on top, select the **Labels** tab. -2. In the list of labels, find the label you want to delete and select the three dots menu. +2. In the list of labels, find the label you want to delete and select the three dots {% icon "mdi:dots-vertical" %} menu. 3. Select **Delete**. 4. If you used this label in automations or script as targets, you need to adjust those. @@ -70,6 +70,6 @@ If you used this label in automations or script as targets, you need to adjust t - Or, go to {% my automations title="**Settings** > **Automations & Scenes**" %} and open the respective tab. 2. Select the Multiselect icon button. - From the list, select all the items from which you want to remove a label. - - In the top right corner, select the three dots menu, then select **Add label**. + - In the top right corner, select the three dots {% icon "mdi:dots-vertical" %} menu, then select **Add label**. - Then, deselect the checkbox for the label you want to remove. diff --git a/source/_docs/troubleshooting_general.markdown b/source/_docs/troubleshooting_general.markdown index 81bdf45a291..07139cc1a30 100644 --- a/source/_docs/troubleshooting_general.markdown +++ b/source/_docs/troubleshooting_general.markdown @@ -53,7 +53,7 @@ Typically, updates are shown at the top of the **Settings** page. If you don't s ### Resolution -1. On the **System** page, in the top-right corner, select the three dots menu and select **Check for updates**. +1. On the **System** page, in the top-right corner, select the three dots {% icon "mdi:dots-vertical" %} menu and select **Check for updates**. 2. Go to {% my updates title="**System** > **Updates**" %}. - Select the update notification. - - Select the cogwheel, then set **Visible** to active. + - Select the cogwheel {% icon "mdi:cog-outline" %}, then set **Visible** to active. diff --git a/source/_faq/python.markdown b/source/_faq/python.markdown deleted file mode 100644 index d46767dd774..00000000000 --- a/source/_faq/python.markdown +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: "Python 2" -description: "Support for Python 2" -ha_category: Common ---- - - -There will be no support for Python 2.x. Python 2 will be EOL in [2020](https://www.python.org/dev/peps/pep-0373/#id2) and it doesn't make any sense to support a release which was planned to be retired in 2015. diff --git a/source/_includes/asides/about.html b/source/_includes/asides/about.html index a6322ca06ac..094a972b38a 100644 --- a/source/_includes/asides/about.html +++ b/source/_includes/asides/about.html @@ -1,13 +1,13 @@
-

About Home Assistant

+

{% icon "mdi:about-circle-outline" %} About Home Assistant

- Home Assistant is part of the Open Home Foundation . + Home Assistant is part of the Open Home Foundation {% icon "tabler:external-link" %}.

diff --git a/source/_includes/asides/categories.html b/source/_includes/asides/categories.html index c19f1a18244..fd4c789636f 100644 --- a/source/_includes/asides/categories.html +++ b/source/_includes/asides/categories.html @@ -1,5 +1,5 @@
-

Categories

+

{% icon "mdi:category" %} Categories

-

Integration owners

+

{% icon "mdi:person-heart" %} Integration owners

{% if page.ha_codeowners %} {% assign ha_project = false %} {% for codeowner in page.ha_codeowners %} diff --git a/source/_includes/asides/dashboards_navigation.html b/source/_includes/asides/dashboards_navigation.html index 9646fc9df9d..5fe1de05479 100644 --- a/source/_includes/asides/dashboards_navigation.html +++ b/source/_includes/asides/dashboards_navigation.html @@ -2,7 +2,7 @@ {% assign elements = site.dashboards | sort_natural: 'title' %}
-

Dashboards

+

Dashboards

-

View types

+

View types

-

Card types

+

{% icon "mdi:card-multiple-outline" %} Card types

-

Advanced

+

{% icon "mdi:cog" %} Advanced

diff --git a/source/_includes/asides/docs_navigation.html b/source/_includes/asides/docs_navigation.html index ae54ccd30f8..81dcd8d61be 100644 --- a/source/_includes/asides/docs_navigation.html +++ b/source/_includes/asides/docs_navigation.html @@ -8,7 +8,7 @@ {% active_link /docs/glossary/ Glossary %}
  • - Getting started + {% icon "mdi:rocket-launch-outline" %} Getting started
    • {% active_link /installation Installation %}
    • {% active_link /getting-started Getting started & onboarding %}
    • @@ -23,7 +23,7 @@
  • - {% active_link /docs/frontend/ Frontend %} + {% icon "mdi:view-dashboard" %} {% active_link /docs/frontend/ Frontend %}
    • {% active_link /dashboards Dashboards, views, cards %}
    • {% active_link /docs/organizing/ Organizing: areas, floors, labels, categories, ... %}
    • @@ -31,7 +31,7 @@
  • - Configuration + {% icon "mdi:cog" %} Configuration
    • {% active_link /docs/configuration/ Configuration.yaml %}
    • {% active_link /docs/configuration/yaml/ YAML syntax%}
    • @@ -52,7 +52,7 @@
  • - {% active_link /docs/energy/ Home Energy Management %} + {% icon "mdi:solar-power-variant" %} {% active_link /docs/energy/ Home Energy Management %}
    • {% active_link /docs/energy/electricity-grid/ Electricity grid %}
    • {% active_link /docs/energy/solar-panels/ Solar panels %}
    • @@ -61,7 +61,7 @@
  • - Advanced configuration + {% icon "fa-solid:cogs" %} Advanced configuration
    • {% active_link /docs/configuration/remote/ Remote access %}
    • @@ -80,7 +80,7 @@
  • - {% active_link /docs/authentication/ Authentication %} + {% icon "mdi:account-security" %} {% active_link /docs/authentication/ Authentication %}
    • {% active_link /docs/authentication/providers/ Auth providers %} @@ -95,7 +95,7 @@
  • - Core objects + {% icon "clarity:objects-solid" %} Core objects
    • {% active_link /docs/configuration/events/ Events %}
    • @@ -122,7 +122,7 @@
  • - {% active_link /docs/blueprint/ Blueprints %} + {% icon "carbon:floorplan" %} {% active_link /docs/blueprint/ Blueprints %}
    • {% active_link /docs/blueprint/tutorial/ Tutorial %}
    • {% active_link /docs/blueprint/schema/ Blueprint schema %}
    • @@ -130,26 +130,26 @@
  • - {% active_link /docs/backend/ Backend %} + {% icon "mdi:database" %} {% active_link /docs/backend/ Backend %}
    • {% active_link /docs/backend/database/ Database %}
  • - {% active_link /docs/scripts/ Scripts %} + {% icon "mdi:script-text" %} {% active_link /docs/scripts/ Scripts %}
    • {% active_link /docs/scripts/service-calls/ Service calls %}
    • {% active_link /docs/scripts/conditions/ Conditions %}
  • - {% active_link /docs/scene/ Scenes %} + {% icon "mdi:script-text" %} {% active_link /docs/scene/ Scenes %}
    • {% active_link /docs/scene/editor/ Editor %}
  • - {% active_link /docs/tools/ Tools and helpers %} + {% icon "mdi:palette" %} {% active_link /docs/tools/ Tools and helpers %}
    • {% active_link /docs/tools/dev-tools/ Developer tools %}
    • {% active_link /docs/tools/quick-bar/ Quick bar %}
    • @@ -158,7 +158,7 @@
  • - {% active_link /integrations/mqtt MQTT %} + {% icon "simple-icons:mqtt" %} {% active_link /integrations/mqtt MQTT %}
    • {% active_link /integrations/mqtt/#broker-configuration Broker %}
    • {% active_link /integrations/mqtt/#advanced-broker-configuration Certificate %}
    • @@ -172,7 +172,7 @@
  • - Hardware + {% icon "bitcoin-icons:node-hardware-filled" %} Hardware
    • Home Assistant Green diff --git a/source/_includes/asides/getting_started_navigation.html b/source/_includes/asides/getting_started_navigation.html index 7275af0ced5..f7b18da8835 100644 --- a/source/_includes/asides/getting_started_navigation.html +++ b/source/_includes/asides/getting_started_navigation.html @@ -1,6 +1,6 @@
      -

      Getting started

      +

      {% icon "mdi:rocket-launch-outline" %} Getting started

      diff --git a/source/_includes/asides/help_navigation.html b/source/_includes/asides/help_navigation.html index 3c8e24b5055..da16646999d 100644 --- a/source/_includes/asides/help_navigation.html +++ b/source/_includes/asides/help_navigation.html @@ -6,7 +6,7 @@
    • Developer documentation - + {% icon "tabler:external-link" %}
    • diff --git a/source/_includes/asides/recent_posts.html b/source/_includes/asides/recent_posts.html index 2930091aa8e..447879aead4 100644 --- a/source/_includes/asides/recent_posts.html +++ b/source/_includes/asides/recent_posts.html @@ -1,5 +1,5 @@
      -

      Recent Posts

      +

      {% icon "mdi:newspaper-variant-multiple" %} Recent Posts

        {% for post in site.posts limit: site.recent_posts %} {% if post.url != page.url %} diff --git a/source/_includes/asides/voice_navigation.html b/source/_includes/asides/voice_navigation.html index 6f436975713..56a328ecbd0 100644 --- a/source/_includes/asides/voice_navigation.html +++ b/source/_includes/asides/voice_navigation.html @@ -2,7 +2,7 @@ {% assign elements = site.dashboards | sort_natural: 'title' %}
        -

        Devices

        +

        Devices

        -

        {% active_link /voice_control/ Voice assistants %}

        +

        {% icon "mdi:comment-processing-outline" %} {% active_link /voice_control/ Voice assistants %}

        -

        Projects

        +

        {% icon "mdi:checkbox-marked" %} Projects

        -

        Troubleshooting

        +

        {% icon "mdi:account-help" %} Troubleshooting

      \ No newline at end of file diff --git a/source/_includes/dashboard/edit_dashboard.md b/source/_includes/dashboard/edit_dashboard.md index 0e5d9dd0bb1..42da726cd25 100644 --- a/source/_includes/dashboard/edit_dashboard.md +++ b/source/_includes/dashboard/edit_dashboard.md @@ -8,5 +8,5 @@ To add the {{ title | downcase }} to your user interface: - If this is your first time editing a dashboard, the **Edit dashboard** dialog appears. - By editing the dashboard, you are taking over control of this dashboard. - This means that it is no longer automatically updated when new dashboard elements become available. - - To continue, in the dialog, select the three dots menu, then select **Take control**. + - To continue, in the dialog, select the three dots {% icon "mdi:dots-vertical" %} menu, then select **Take control**. 2. [Add a card](/dashboards/cards/#adding-cards-to-your-dashboard) to your dashboard. diff --git a/source/_includes/feedback.html b/source/_includes/feedback.html index 46bac253ca1..6014e030f85 100644 --- a/source/_includes/feedback.html +++ b/source/_includes/feedback.html @@ -1,6 +1,6 @@ {% unless page.feedback == false or page.layout == "landingpage" %}