Merge branch 'current' into wifi_hidden_docs

Author: bdraco

Makefile

@@ -27,7 +27,6 @@ check-links: anchors
 anchors: repo-data
 	$(PAGEFIND) -s pagefind-bootstrap
 	hugo --environment anchors
-	python3 script/md_anchors.py
 
 repo-data: directories
 	mkdir -p data/automations
@@ -54,7 +53,6 @@ convert-branch-in-place:
 netlify: repo-data
 	$(PAGEFIND) -s pagefind-bootstrap
 	hugo --environment anchors
-	python3 script/md_anchors.py
 	hugo --minify
 	$(PAGEFIND)
 	# rerun hugo to incorporate generated index

content/changelog/2025.10.0.md

@@ -159,7 +159,7 @@ If you manage multiple devices, the dashboard will feel noticeably faster and mo
 
 ## Device Onboarding Improvements
 
-Getting your ESPHome devices online has never been easier. This release brings major improvements to the initial setup experience, particularly for ESP32-IDF devices and the [Made for ESPHome](https://esphome.io/guides/made_for_esphome/) program.
+Getting your ESPHome devices online has never been easier. This release brings major improvements to the initial setup experience, particularly for ESP32-IDF devices and the [Made for ESPHome](/guides/made_for_esphome/) program.
 
 ### Captive Portal for ESP-IDF
 
@@ -179,9 +179,9 @@ This brings ESP-IDF up to feature parity with Arduino for onboarding, and since
 
 **Why passive scanning matters:** Many home automation systems and BLE scanners only support passive scanning (not active scanning). Making the device name visible to passive scanners means your devices show up in more scanning apps and are easier to identify during setup.
 
-These improvements directly support the [Made for ESPHome program](https://esphome.io/guides/made_for_esphome/), which requires Improv provisioning via BLE for Wi-Fi projects to ensure a consistent, high-quality setup experience across all ESPHome-compatible products.
+These improvements directly support the [Made for ESPHome program](/guides/made_for_esphome/), which requires Improv provisioning via BLE for Wi-Fi projects to ensure a consistent, high-quality setup experience across all ESPHome-compatible products.
 
-The Made for ESPHome program requires Improv BLE provisioning for Wi-Fi projects. See the [certification requirements](https://esphome.io/guides/made_for_esphome/) for details.
+The Made for ESPHome program requires Improv BLE provisioning for Wi-Fi projects. See the [certification requirements](/guides/made_for_esphome/) for details.
 
 ## Home Assistant Action Responses
 

content/changelog/2025.11.0.md

@@ -142,13 +142,13 @@ Added `ignore_not_found` option (default `true`) to allow disabling `CONFIG_SPIR
 
 **7 New Sensor/Device Components:**
 
-- [HDC2010](https://esphome.io/components/sensor/hdc2010.html) ([#6674](https://github.com/esphome/esphome/pull/6674)) - Texas Instruments temperature and humidity sensor
-- [MCP3221](https://esphome.io/components/sensor/mcp3221.html) ([#7764](https://github.com/esphome/esphome/pull/7764)) - I2C A-D converter with configurable reference voltage
-- [HLK-FM22X](https://esphome.io/components/hlk_fm22x.html) ([#8059](https://github.com/esphome/esphome/pull/8059)) - Face recognition module family
-- [BH1900NUX](https://esphome.io/components/sensor/bh1900nux.html) ([#8631](https://github.com/esphome/esphome/pull/8631)) - Rohm Semiconductor temperature sensor
-- [RX8130](https://esphome.io/components/time/rx8130.html) ([#10511](https://github.com/esphome/esphome/pull/10511)) - Epson RTC chip (used in M5Stack devices)
-- [BLE NUS Logger](https://esphome.io/components/logger.html#ble-logging) ([#9846](https://github.com/esphome/esphome/pull/9846)) - Logging over BLE for nRF52 platform
-- [TinyUSB](https://esphome.io/components/tinyusb.html) ([#11678](https://github.com/esphome/esphome/pull/11678)) - USB device functionality foundation for ESP32-S2/S3
+- [HDC2010](/components/sensor/hdc2010) ([#6674](https://github.com/esphome/esphome/pull/6674)) - Texas Instruments temperature and humidity sensor
+- [MCP3221](/components/sensor/mcp3221) ([#7764](https://github.com/esphome/esphome/pull/7764)) - I2C A-D converter with configurable reference voltage
+- [HLK-FM22X](/components/hlk_fm22x) ([#8059](https://github.com/esphome/esphome/pull/8059)) - Face recognition module family
+- [BH1900NUX](/components/sensor/bh1900nux) ([#8631](https://github.com/esphome/esphome/pull/8631)) - Rohm Semiconductor temperature sensor
+- [RX8130](/components/time/rx8130) ([#10511](https://github.com/esphome/esphome/pull/10511)) - Epson RTC chip (used in M5Stack devices)
+- [BLE NUS Logger](/components/ble_nus) ([#9846](https://github.com/esphome/esphome/pull/9846)) - Logging over BLE for nRF52 platform
+- [TinyUSB](/components/tinyusb) ([#11678](https://github.com/esphome/esphome/pull/11678)) - USB device functionality foundation for ESP32-S2/S3
 
 **Extended Hardware Support:**
 
@@ -518,6 +518,22 @@ The 2025.11 release blog posts include comprehensive migration examples for comm
 
 <!-- markdownlint-disable MD013 -->
 
+## Release 2025.11.2 - November 27
+
+<details>
+<summary></summary>
+
+- [nextion] Do not set alternative baud rate when not specified or `<= 0` [esphome#12097](https://github.com/esphome/esphome/pull/12097) by [@edwardtfn](https://github.com/edwardtfn)
+- [esp32] Fix platformio flash size print [esphome#12099](https://github.com/esphome/esphome/pull/12099) by [@swoboda1337](https://github.com/swoboda1337)
+- [script] Fix script.wait hanging when triggered from on_boot [esphome#12102](https://github.com/esphome/esphome/pull/12102) by [@bdraco](https://github.com/bdraco)
+- [lvgl] Allow multiple widgets per grid cell [esphome#12091](https://github.com/esphome/esphome/pull/12091) by [@clydebarrow](https://github.com/clydebarrow) (new-feature)
+- [lvgl] Fix position of errors in widget config [esphome#12111](https://github.com/esphome/esphome/pull/12111) by [@clydebarrow](https://github.com/clydebarrow)
+- [esp32] Fix hosted update when there is no wifi [esphome#12123](https://github.com/esphome/esphome/pull/12123) by [@swoboda1337](https://github.com/swoboda1337)
+- [wifi] Restore blocking setup until connected for RP2040 [esphome#12142](https://github.com/esphome/esphome/pull/12142) by [@clydebarrow](https://github.com/clydebarrow)
+- [scheduler] Fix use-after-move crash in heap operations [esphome#12124](https://github.com/esphome/esphome/pull/12124) by [@bdraco](https://github.com/bdraco)
+
+</details>
+
 ## Release 2025.11.1 - November 24
 
 <details>

content/components/climate/thermostat.md

@@ -301,13 +301,13 @@ These should be used to control the fan only, if available.
 These are triggered when the humidity control action is changed by the thermostat controller. It can trigger actions
 to activate humidification **or** dehumidification.
 
-- **humidity_control_dehumidify_action** (*Optional*, [Action](#config-action)): The action to call when
+- **humidity_control_dehumidify_action** (*Optional*, [Action](/automations/actions#config-action)): The action to call when
   dehumidification is required.
 
-- **humidity_control_humidify_action** (*Optional*, [Action](#config-action)): The action to call when
+- **humidity_control_humidify_action** (*Optional*, [Action](/automations/actions#config-action)): The action to call when
   humidification is required.
 
-- **humidity_control_off_action** (*Optional*, [Action](#config-action)): The action to call when
+- **humidity_control_off_action** (*Optional*, [Action](/automations/actions#config-action)): The action to call when
   (de)humidification should stop. This action is **required** when either of the above actions are configured.
 
 ## Advanced Configuration/Behavior
@@ -562,7 +562,7 @@ the range of allowed temperature values in the thermostat component. See {{< doc
   before calling the idle [action](/automations/actions#all-actions). Defaults to 0.5 °C.
 
 - **humidity_hysteresis** (*Optional*, float): The maximum humidity differential (above/below the set point)
-  before calling the respective humidity control [action](#config-action). Defaults to 1%.
+  before calling the respective humidity control [action](/automations/actions#config-action). Defaults to 1%.
 
 > [!NOTE]
 >

content/components/lvgl/_index.md

@@ -147,15 +147,15 @@ The following configuration variables apply to the main `lvgl` component, in ord
 - **widgets** (*Optional*, list): A list of {{< docref "/components/lvgl/widgets" >}} to be drawn on the root display. May not be used if `pages` (below) is configured.
 - **pages** (*Optional*, list): A list of page IDs. Each page acts as a parent for widgets placed on it. May not be used with `widgets` (above). Options for each page:
   - **skip** (*Optional*, boolean): Option to skip this page when navigating between them with [`lvgl.page.next`, `lvgl.page.previous`](#lvgl-page-next-previous-action).
-  - **layout** (*Optional*): See [Layouts](#lvgl-layouts) for details. Defaults to `NONE`.
+  - **layout** (*Optional*): See [Layouts](/components/lvgl/layouts#lvgl-layouts) for details. Defaults to `NONE`.
   - **widgets** (*Optional*, list): A list of {{< docref "/components/lvgl/widgets" >}} to be drawn on the page.
   - All other options from [Style properties](#lvgl-styling) to be applied to this page.
 - **page_wrap** (*Optional*, boolean): Wrap from the last to the first page when navigating between them with [`lvgl.page.next`, `lvgl.page.previous`](#lvgl-page-next-previous-action). Defaults to `true`.
 - **top_layer** (*Optional*, list): A special kind of *Always on Top* page, which acts as a parent for widgets placed on it. It's shown above all the pages, which may be useful for widgets which always need to be visible.
-  - **layout** (*Optional*): See [Layouts](#lvgl-layouts) for details. Defaults to `NONE`.
+  - **layout** (*Optional*): See [Layouts](/components/lvgl/layouts#lvgl-layouts) for details. Defaults to `NONE`.
   - **widgets** (*Optional*, list): A list of {{< docref "/components/lvgl/widgets" >}} to be drawn on the page.
   - All other options from [Style properties](#lvgl-styling) to be applied to this page.
-- **layout** (*Optional*): See [Layouts](#lvgl-layouts) for details. Defaults to `NONE`.
+- **layout** (*Optional*): See [Layouts](/components/lvgl/layouts#lvgl-layouts) for details. Defaults to `NONE`.
 - All other options from [Style properties](#lvgl-styling) to be applied to all widgets directly.
 
 **Example:**
@@ -832,11 +832,11 @@ This [trigger](/components/lvgl/widgets#lvgl-automation-triggers) is triggered a
 
 ### `on_draw_start`
 
-This [trigger](#lvgl-automation-triggers) is executed before each LVGL drawing operation.
+This [trigger](/components/lvgl/widgets#lvgl-automation-triggers) is executed before each LVGL drawing operation.
 
 ### `on_draw_end`
 
-This [trigger](#lvgl-automation-triggers) is executed after LVGL has completed drawing all updated screen elements. It
+This [trigger](/components/lvgl/widgets#lvgl-automation-triggers) is executed after LVGL has completed drawing all updated screen elements. It
 may be used for example to trigger an update of a display component like an e-paper screen that requires the buffer
 to be sent to the display for it to be updated.
 

content/components/lvgl/layouts.md

@@ -14,12 +14,12 @@ The layout configuration options are applied to any parent widget or page, influ
 The position and size calculated by the layout override the *normal* `x`, `y`, `width`, and `height` settings of the
 children.
 
-Check out [Flex layout positioning](#lvgl-cookbook-flex), [Grid layout positioning](#lvgl-cookbook-grid)
-and [Weather forecast panel](#lvgl-cookbook-weather) in the Cookbook for examples which demonstrate how to automate
+Check out [Flex layout positioning](/cookbook/lvgl#lvgl-cookbook-flex), [Grid layout positioning](/cookbook/lvgl#lvgl-cookbook-grid)
+and [Weather forecast panel](/cookbook/lvgl#lvgl-cookbook-weather) in the Cookbook for examples which demonstrate how to automate
 widget positioning, potentially reducing the size of your device's YAML configuration, and saving you from lots of
 manual calculations.
 
-The `hidden`, `ignore_layout` and `floating` [flags](#lvgl-widget-flags) can be used on widgets to ignore them in layout
+The `hidden`, `ignore_layout` and `floating` [flags](/components/lvgl/widgets#lvgl-widget-flags) can be used on widgets to ignore them in layout
 calculations.
 
 ### Configuration variables
@@ -188,9 +188,9 @@ placement:
 - **grid_cell_row_pos** (*Optional*, int16): Position of the widget, in which row to appear (0 based count).
 - **grid_cell_column_pos** (*Optional*, int16): Position of the widget, in which column to appear (0 based count).
 - **grid_cell_x_align** (*Optional*, string): How to align the widget horizontally within the cell. Can also be applied
-  through [Style properties](#lvgl-styling). Possible options below.
+  through [Style properties](/components/lvgl#lvgl-styling). Possible options below.
 - **grid_cell_y_align** (*Optional*, string): How to align the widget vertically within the cell. Can also be applied
-  through [Style properties](#lvgl-styling). Possible options below.
+  through [Style properties](/components/lvgl#lvgl-styling). Possible options below.
 - **grid_cell_row_span** (*Optional*, int16): How many rows to span across the widget. Defaults to `1`.
 - **grid_cell_column_span** (*Optional*, int16): How many columns to span across the widget. Defaults to `1`.
 

content/components/lvgl/widgets.md

@@ -22,7 +22,7 @@ The properties below are common to all widgets.
 > [!NOTE]
 > By default, the `x` and `y` coordinates are measured from the *top left corner* of the parent's content area. [Important](/components/lvgl#lvgl-styling): content area starts *after the padding* thus if the parent has a non-zero padding value, position will be shifted with that. Percentage values are calculated from the parent's content area size.
 >
-> If specifying `align`, `x` and `y` can be used as an offset to the calculated position (can also be negative). They are ignored if [Layouts](/components/lvgl#lvgl-layouts) are used on the parent.
+> If specifying `align`, `x` and `y` can be used as an offset to the calculated position (can also be negative). They are ignored if [Layouts](/components/lvgl/layouts#lvgl-layouts) are used on the parent.
 
 - **height** (*Optional*): Height of the widget in pixels or a percentage, or `SIZE_CONTENT`.
 - **width** (*Optional*): Width of the widget in pixels or a percentage, or `SIZE_CONTENT`.
@@ -49,7 +49,7 @@ The properties below are common to all widgets.
 {{< img src="lvgl_align.png" alt="Image" class="align-center" >}}
 
 - **group** (*Optional*, string): The name of the group of widgets which will interact with a {{< docref "/components/sensor/rotary_encoder" >}}. In every group there is always one focused widget which receives the encoder actions. You need to associate an input device with a group. An input device can send key events to only one group but a group can receive data from more than one input device. If no group is specified for a widget or an encoder, an unnamed default group will be assigned, so in most cases where only one encoder is used it will not be necessary to explicitly specify a group.
-- **layout** (*Optional*): See [Layouts](/components/lvgl#lvgl-layouts) for details. Defaults to `NONE`.
+- **layout** (*Optional*): See [Layouts](/components/lvgl/layouts#lvgl-layouts) for details. Defaults to `NONE`.
 - **styles** (*Optional*, [ID](/guides/configuration-types#id)): The ID of a *style definition* from the main component configuration to override the theme styles.
 - **theme** (*Optional*, list): A list of styles to apply to the widget and children. Same configuration option as at the main component.
 - **widgets** (*Optional*, list): A list of LVGL widgets to be drawn as children of this widget. Same configuration option as at the main component.
@@ -808,7 +808,7 @@ it is invisible. It has a default width and height of 100%.
 
 **Configuration variables:**
 
-- Style options from [Style properties](#lvgl-styling).
+- Style options from [Style properties](/components/lvgl#lvgl-styling).
 
 **Triggers:**
 
@@ -1040,7 +1040,7 @@ A label is the basic widget type that is used to display text.
 
 **Configuration variables:**
 
-- **long_mode** (*Optional*, list): By default, the width and height of the label is set to `SIZE_CONTENT`. Therefore, the size of the label is automatically expanded to the text size. Otherwise, if the `width` or `height` are explicitly set (or set by [Layouts](/components/lvgl#lvgl-layouts)), the lines wider than the label's width can be manipulated according to the long mode policies below. These policies can be applied if the height of the text is greater than the height of the label.
+- **long_mode** (*Optional*, list): By default, the width and height of the label is set to `SIZE_CONTENT`. Therefore, the size of the label is automatically expanded to the text size. Otherwise, if the `width` or `height` are explicitly set (or set by [Layouts](/components/lvgl/layouts#lvgl-layouts)), the lines wider than the label's width can be manipulated according to the long mode policies below. These policies can be applied if the height of the text is greater than the height of the label.
   - `WRAP`  : Wrap lines which are too long. If the height is `SIZE_CONTENT`, the label's height will be expanded, otherwise the text will be clipped (default).
   - `DOT`  : Replaces the last 3 characters from bottom right corner of the label with dots.
   - `SCROLL`  : If the text is wider than the label, scroll the text horizontally back and forth. If it's higher, scroll vertically. Text will scroll in only one direction; horizontal scrolling has higher precedence.

content/components/openthread.md

@@ -64,7 +64,7 @@ openthread:
 - **mesh_local_prefix** (ipv6network): Used to build Mesh-Local IPv6 addresses (ML-EIDs), which are unique to each Thread device within the network partition
 - **use_address** (*Optional*, string): Manually override what address to use to connect
   to the ESP. Defaults to auto-generated value.
-- **poll_period** (*Optional*, [Time](#config-time)): When Poll_Period is set on an MTD device, the parent router will enqueue any messages and wait for the child to submit a poll data request
+- **poll_period** (*Optional*, [Time](/guides/configuration-types#config-time)): When Poll_Period is set on an MTD device, the parent router will enqueue any messages and wait for the child to submit a poll data request
 
 > [!NOTE]
 > esphome.ota does not work when poll_period > 0, instead use http_request.ota, timeout and watchdog_timeout need to be tested to find the correct values.  Values greater than 100sec may be required.

content/components/ota/esphome.md

@@ -31,7 +31,7 @@ ota:
 - **password** (*Optional*, string): The password to use for updates.
 
 > [!IMPORTANT]
-> Always use strong, unique passwords for OTA updates. See the [Security Best Practices](/guides/security_best_practices#ota-password-protection) guide for more information.
+> Always use strong, unique passwords for OTA updates. See the [Security Best Practices](/guides/security_best_practices#3-ota-password-protection) guide for more information.
 
 - **port** (*Optional*, int): The port to use for OTA updates. Defaults: