Merge branch 'next' into feature/add-grove-multichannel-gas-sensor-v2…

…-docs
esphome · Aug 20, 2023 · 91a1a61 · 91a1a61
2 parents 81cb413 + 240850a
commit 91a1a61
Show file tree

Hide file tree

Showing 153 changed files with 3,749 additions and 654 deletions.
diff --git a/Doxygen b/Doxygen
@@ -38,7 +38,7 @@ PROJECT_NAME           = "ESPHome"
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = 2023.7.0-dev
+PROJECT_NUMBER         = 2023.9.0-dev
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a

diff --git a/_static/changelog-2023.4.0.png b/_static/changelog-2023.4.0.png
diff --git a/_static/changelog-2023.5.0.png b/_static/changelog-2023.5.0.png
diff --git a/_static/changelog-2023.6.0.png b/_static/changelog-2023.6.0.png
diff --git a/_static/changelog-2023.7.0.png b/_static/changelog-2023.7.0.png
diff --git a/_static/changelog-2023.8.0.png b/_static/changelog-2023.8.0.png
diff --git a/_static/custom.css b/_static/custom.css
@@ -1,8 +1,10 @@
 .row-odd {
   background-color: #f3f6f6;
 }
+
 .table-center tr.row-even > td {
   text-align: center;
+  vertical-align: top;
 }
 
 div.document {
@@ -26,6 +28,7 @@ img.component-image {
   height: 85px;
   object-fit: contain;
   border-radius: 10px;
+  max-width: 190px;
 }
 
 table.docutils {
@@ -36,6 +39,7 @@ table.docutils {
   -webkit-animation: 2s linear infinite blink_effect;
   animation: 2s linear infinite blink_effect;
 }
+
 @-webkit-keyframes blink_effect {
   0% {
     visibility: hidden;
@@ -47,6 +51,7 @@ table.docutils {
     visibility: visible;
   }
 }
+
 @keyframes blink_effect {
   0% {
     visibility: hidden;
@@ -74,10 +79,12 @@ table.docutils {
   z-index: 9999;
   display: none;
 }
+
 .footer-button-container {
   margin: 0 60px 0 10px;
   float: right;
 }
+
 .footer-button {
   background-color: #b3b3b3;
   color: #4e4e4e;
@@ -88,6 +95,7 @@ table.docutils {
   cursor: pointer;
   text-decoration: none;
 }
+
 .not-hidden {
   display: block !important;
 }
@@ -133,7 +141,6 @@ div.index-shields {
 }
 
 .guide-card {
-  color: #004b6b;
   display: block;
   height: auto;
   width: 300px;
@@ -149,17 +156,20 @@ div.index-shields {
   margin: 16px !important;
 }
 
-.guide-code {
-  padding: 8px 16px;
-  margin: 8px;
-  color: black;
+.guide-card .example {
+  margin: 10px;
+}
+
+.guide-card pre {
   white-space: pre-line;
+  padding: 15px;
 }
 
-@media screen and (min-width: 870px) {
+@media screen and (min-width: 875px) {
   .guide-card:first-child {
     z-index: 100;
   }
+
   .guide-card:nth-child(2) {
     z-index: 50;
   }
@@ -170,23 +180,163 @@ div.index-shields {
   }
 }
 
-@media screen and (max-width: 870px) {
+@media screen and (max-width: 875px) {
+
+  div.sphinxsidebar {
+    width: 100%;
+    background: #fff;
+    color: #000;
+    border-bottom: 1px solid #444;
+  }
+
+  div.sphinxsidebar p.logo {
+    display: initial;
+  }
+
+  div.sphinxsidebar a, div.sphinxsidebar h3, div.sphinxsidebar h3 a {
+    color: #444;
+  }
+
   .guide-container {
     flex-direction: column;
   }
+
   .guide-card {
     width: 100%;
     margin: 8px 0;
     padding: 0px;
   }
+
   .guide-card:not(:first-child) {
     margin-left: 0;
   }
+
   .guide-card ul {
     margin-left: 32px;
   }
+
+  img.component-image {
+    max-width: 80px;
+  }
 }
 
 .breadcrumbs li {
   display: inline;
 }
+
+a {
+  color: #004B6B;
+  text-decoration: none;
+  border-bottom: 1px dotted #004B6B;
+}
+
+a:hover {
+  color: #999999;
+  text-decoration: none;
+  border-bottom: 1px dotted #999999;
+}
+
+a:hover code {
+  background: none;
+}
+
+div.body p, div.body dd, div.body li, div.body blockquote {
+  hyphens: none;
+}
+
+/* dark theme */
+@media (prefers-color-scheme: dark) {
+
+  @media screen and (max-width: 875px) {
+    div.documentwrapper {
+      background-color: #212121;
+    }
+
+    div.sphinxsidebar {
+      background: #212121;
+      color: #ececec;
+    }
+
+  }
+
+  body, div.body {
+    color: #ececec;
+    background-color: #212121;
+  }
+
+  img.dark-invert, img.logo {
+    filter: invert(1);
+  }
+
+  .row-odd {
+    background-color: #282828;
+  }
+
+  table.docutils {
+    -webkit-box-shadow: 2px 2px 4px #3b3838;
+    box-shadow: 2px 2px 4px #3b3838;
+  }
+
+  div.body {
+    color: #ececec;
+    background-color: #212121;
+  }
+
+  a, a.reference, a:visited {
+    color: #00bfff;
+    border-bottom: 1px dotted #00bfff;
+  }
+
+  a:hover {
+    color: #87ceeb;
+    border-bottom: 1px solid #87ceeb;
+  }
+
+  .toctree-wrapper a code {
+    color: #00bfff;
+  }
+
+  div.sphinxsidebar h3, div.sphinxsidebar h3 a {
+    color: #ececec;
+  }
+
+  div.sphinxsidebar ul {
+    color: #ececec;
+  }
+
+  div.sphinxsidebar a, .breadcrumbs a {
+    color: #ececec;
+    border-bottom: 1px dotted #ececec;
+  }
+
+  div.sphinxsidebar a:hover, .breadcrumbs a:hover {
+    border-bottom: 1px solid #ececec;
+  }
+
+  .guide-card {
+    background-color: #393939;
+  }
+
+  pre {
+    background-color: #0d1117;
+  }
+
+  code {
+    background-color: #424242;
+    color: #e2e2e2;
+  }
+
+  div.note, div.tip {
+    background-color: #2d2c2c;
+    border: 1px solid #808080;
+  }
+
+  div.warning, div.caution {
+    background-color: #5d1616;
+  }
+
+  dt:target, span.highlighted {
+    background-color: #8e8129;
+  }
+
+}
diff --git a/_static/version b/_static/version
@@ -1 +1 @@
-2023.7.0-dev
+2023.9.0-dev
diff --git a/_themes/esphome/theme.conf b/_themes/esphome/theme.conf
@@ -0,0 +1,4 @@
+[theme]
+inherit = alabaster
+pygments_style = xcode
+pygments_dark_style = github-dark
diff --git a/changelog/2021.10.0.rst b/changelog/2021.10.0.rst
@@ -11,12 +11,12 @@ ESPHome 2021.10.0 - 20th October 2021
     :columns: 3
 
     AirThings Wave Mini, components/sensor/airthings_ble, airthings_logo.png
-    Current-Based Cover, components/cover/current_based, flash.svg
+    Current-Based Cover, components/cover/current_based, flash.svg, dark-invert
     Daly BMS, components/sensor/daly_bms, daly_bms.jpg
     EPEVER Tracer, cookbook/tracer-an, tracer-an.jpg
     LTR390, components/sensor/ltr390, ltr390.jpg
     Modbus Controller, components/modbus_controller, modbus.png
-    Safe Mode Switch, components/switch/safe_mode, restart-alert.svg
+    Safe Mode Switch, components/switch/safe_mode, restart-alert.svg, dark-invert
     SCD4X, components/sensor/scd4x, scd4x.jpg
     Tuya Cover, components/cover/tuya, tuya.png
 

diff --git a/changelog/2021.11.0.rst b/changelog/2021.11.0.rst
@@ -12,8 +12,8 @@ ESPHome 2021.11.0 - 17th November 2021
 
     CSE7761, components/sensor/cse7761, cse7761.svg
     CAP1188 Capacitive Touch Sensor, components/binary_sensor/cap1188, cap1188.jpg
-    ESP32 Camera Web Server, components/esp32_camera_web_server, camera.svg
-    Improv via Serial, components/improv_serial, improv.svg
+    ESP32 Camera Web Server, components/esp32_camera_web_server, camera.svg, dark-invert
+    Improv via Serial, components/improv_serial, improv.svg, dark-invert
 
 
 State of the Open Smart Home

diff --git a/changelog/2021.12.0.rst b/changelog/2021.12.0.rst
@@ -10,10 +10,10 @@ ESPHome 2021.12.0 - 11th December 2021
 .. imgtable::
     :columns: 3
 
-    Button Core, components/button/index, folder-open.svg
-    Template Button, components/button/template, description.svg
-    Restart Button, components/button/restart, restart.svg
-    BLE Binary Output, components/output/ble_client, bluetooth.svg
+    Button Core, components/button/index, folder-open.svg, dark-invert
+    Template Button, components/button/template, description.svg, dark-invert
+    Restart Button, components/button/restart, restart.svg, dark-invert
+    BLE Binary Output, components/output/ble_client, bluetooth.svg, dark-invert
     Tuya Text Sensor, components/text_sensor/tuya, tuya.png
     SDP800 Series, components/sensor/sdp3x, sdp31.jpg, Pressure
 

diff --git a/changelog/2021.8.0.rst b/changelog/2021.8.0.rst
@@ -12,8 +12,8 @@ ESPHome 2021.8.0 - 18th August 2021
 
     AM43, components/sensor/am43, am43.jpg
     AM43 Cover, components/cover/am43, am43.jpg
-    Color Temperature Light, components/light/color_temperature, brightness-medium.svg
-    Demo, components/demo, description.svg
+    Color Temperature Light, components/light/color_temperature, brightness-medium.svg, dark-invert
+    Demo, components/demo, description.svg, dark-invert
     DSMR, components/sensor/dsmr, dsmr.svg
     HRXL MaxSonar WR, components/sensor/hrxl_maxsonar_wr, hrxl_maxsonar_wr.jpg
     PipSolar - compatible PV Inverter, components/pipsolar, pipsolar.jpg
@@ -24,8 +24,8 @@ ESPHome 2021.8.0 - 18th August 2021
     Selec Meter, components/sensor/selec_meter, selec_meter_em2m.jpg
     T6613/15, components/sensor/t6615, t6615.jpg
     TLC5947, components/output/tlc5947, tlc5947.jpg
-    Select Core, components/select/index, folder-open.svg
-    Template Select, components/select/template, description.svg
+    Select Core, components/select/index, folder-open.svg, dark-invert
+    Template Select, components/select/template, description.svg, dark-invert
     TSL2591, components/sensor/tsl2591, tsl2591.jpg
 
 

diff --git a/changelog/2021.9.0.rst b/changelog/2021.9.0.rst
@@ -11,7 +11,7 @@ ESPHome 2021.9.0 - 15th September 2021
     :columns: 3
 
     AirThings BLE, components/sensor/airthings_ble, airthings_logo.png
-    H-bridge Fan, components/fan/hbridge, fan.svg
+    H-bridge Fan, components/fan/hbridge, fan.svg, dark-invert
     ST7920, components/display/st7920, st7920.jpg
 
 

diff --git a/changelog/2022.1.0.rst b/changelog/2022.1.0.rst
@@ -17,12 +17,12 @@ ESPHome 2022.1.0 - 19th January 2022
     Growatt Solar, components/sensor/growatt_solar, growatt.jpg
     INA260, components/sensor/ina260, ina260.jpg
     Inkplate 10, components/display/inkplate6, inkplate6.jpg
-    Kalman Combinator, components/sensor/kalman_combinator, function.svg
+    Kalman Combinator, components/sensor/kalman_combinator, function.svg, dark-invert
     MCP3204, components/sensor/mcp3204, mcp3204.jpg
     MCP47A1, components/output/mcp47a1, mcp47a1.svg
-    Midea IR Climate, components/climate/ir_climate, air-conditioner-ir.svg
-    Safe Mode Button, components/button/safe_mode, restart-alert.svg
-    Shutdown Button, components/button/shutdown, power_settings.svg
+    Midea IR Climate, components/climate/ir_climate, air-conditioner-ir.svg, dark-invert
+    Safe Mode Button, components/button/safe_mode, restart-alert.svg, dark-invert
+    Shutdown Button, components/button/shutdown, power_settings.svg, dark-invert
     Tuya Number, components/number/tuya, tuya.png
 
 

diff --git a/changelog/2022.10.0.rst b/changelog/2022.10.0.rst
@@ -10,8 +10,8 @@ ESPHome 2022.10.0 - 19th October 2022
 .. imgtable::
     :columns: 2
 
-    BLE Client RSSI Sensor, components/sensor/ble_client, bluetooth.svg
-    ZHLT01 IR Climate, components/climate/climate_ir, air-conditioner-ir.svg
+    BLE Client RSSI Sensor, components/sensor/ble_client, bluetooth.svg, dark-invert
+    ZHLT01 IR Climate, components/climate/climate_ir, air-conditioner-ir.svg, dark-invert
 
 
 

diff --git a/changelog/2022.11.0.rst b/changelog/2022.11.0.rst
@@ -11,12 +11,12 @@ ESPHome 2022.11.0 - 16th November 2022
     :columns: 4
 
     RP2040, components/rp2040, rp2040.svg
-    WL-134 Pet Tag Sensor , components/text_sensor/wl_134, fingerprint.svg
-    Ethernet Info, components/text_sensor/ethernet_info, ethernet.svg
+    WL-134 Pet Tag Sensor , components/text_sensor/wl_134, fingerprint.svg, dark-invert
+    Ethernet Info, components/text_sensor/ethernet_info, ethernet.svg, dark-invert
     Atlas Scientific Peristaltic Pump, components/ezo_pmp, ezo-pmp.jpg
     ADC128S102, components/sensor/adc128s102, adc128s102.png
-    Daikin BRC, components/climate/climate_ir, air-conditioner-ir.svg
-    Display Menu Core, components/display_menu/index, folder-open.svg
+    Daikin BRC, components/climate/climate_ir, air-conditioner-ir.svg, dark-invert
+    Display Menu Core, components/display_menu/index, folder-open.svg, dark-invert
     LCD Menu, components/display_menu/lcd_menu, lcd_menu.png