docs: add new top-level docs builder that builds docs for a single chip

docs/en/api-reference/storage/nvs_flash.rst

@@ -31,8 +31,8 @@ You can find two code examples in the :example:`storage` directory of ESP-IDF ex
 API Reference
 -------------
 
-.. include:: /_build/inc/nvs_flash.inc
+.. include-build-file:: inc/nvs_flash.inc
 
-.. include:: /_build/inc/nvs.inc
+.. include-build-file:: inc/nvs.inc
 
 

docs/en/api-reference/storage/sdmmc.rst

@@ -100,6 +100,6 @@ Most applications need to use the protocol layer only in one task. For this reas
 API Reference
 -------------
 
-.. include:: /_build/inc/sdmmc_cmd.inc
+.. include-build-file:: inc/sdmmc_cmd.inc
 
-.. include:: /_build/inc/sdmmc_types.inc
+.. include-build-file:: inc/sdmmc_types.inc

docs/en/api-reference/storage/spi_flash.rst

@@ -31,18 +31,18 @@ In a single core environment (:ref:`CONFIG_FREERTOS_UNICORE` enabled), you need
 API Reference - SPI Flash
 -------------------------
 
-.. include:: /_build/inc/esp_flash_spi_init.inc
-.. include:: /_build/inc/esp_flash.inc
-.. include:: /_build/inc/spi_flash_types.inc
+.. include-build-file:: inc/esp_flash_spi_init.inc
+.. include-build-file:: inc/esp_flash.inc
+.. include-build-file:: inc/spi_flash_types.inc
 
 API Reference - Partition Table
 -------------------------------
 
-.. include:: /_build/inc/esp_partition.inc
+.. include-build-file:: inc/esp_partition.inc
 
 API Reference - Flash Encrypt
 -----------------------------
 
-.. include:: /_build/inc/esp_flash_encrypt.inc
+.. include-build-file:: inc/esp_flash_encrypt.inc
 
 

docs/en/api-reference/storage/spiffs.rst

@@ -145,4 +145,4 @@ An example of using SPIFFS is provided in the :example:`storage/spiffs` director
 High-level API Reference
 ------------------------
 
-.. include:: /_build/inc/esp_spiffs.inc
+.. include-build-file:: inc/esp_spiffs.inc

docs/en/api-reference/storage/vfs.rst

@@ -10,7 +10,7 @@ Application Example
 API Reference
 -------------
 
-.. include:: /_build/inc/esp_vfs.inc
+.. include-build-file:: inc/esp_vfs.inc
 
-.. include:: /_build/inc/esp_vfs_dev.inc
+.. include-build-file:: inc/esp_vfs_dev.inc
 

docs/en/api-reference/storage/wear-levelling.rst

@@ -30,5 +30,5 @@ Functions
 Mid level API Reference
 -----------------------
 
-.. include:: /_build/inc/wear_levelling.inc
+.. include-build-file:: inc/wear_levelling.inc