Sync Docs platformio/platformio-core@d153146

platformio · Dec 13, 2024 · 77068fd · 77068fd
1 parent 3d94f1e
commit 77068fd
Show file tree

Hide file tree

Showing 1,891 changed files with 37,501 additions and 44,640 deletions.
diff --git a/en/latest/404.html b/en/latest/404.html
@@ -1,27 +1,34 @@
+
+
 <!DOCTYPE html>
 <html class="writer-html5" lang="en" data-content_root="./">
 <head>
   <meta charset="utf-8" />
+    <!-- Google tag (gtag.js) -->
+    <script async src="https://www.googletagmanager.com/gtag/js?id=G-LQZCKGZE94"></script>
+    <script>
+        window.dataLayer = window.dataLayer || [];
+        function gtag(){dataLayer.push(arguments);}
+        gtag('js', new Date());
+        gtag('config', 'G-LQZCKGZE94');
+    </script>
+
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>Page not found &mdash; PlatformIO latest documentation</title>
       <link rel="stylesheet" type="text/css" href="/en/latest/_static/pygments.css?v=266695fe" />
-      <link rel="stylesheet" type="text/css" href="/en/latest/_static/css/theme.css?v=19f00094" />
+      <link rel="stylesheet" type="text/css" href="/en/latest/_static/css/theme.css?v=e59714d7" />
       <link rel="stylesheet" type="text/css" href="/en/latest/_static/copybutton.css?v=76b2166b" />
 
 
     <link rel="shortcut icon" href="/en/latest/_static/favicon.ico"/>
     <link rel="canonical" href="https://docs.platformio.org/404.html" />
-  <!--[if lt IE 9]>
-    <script src="/en/latest/_static/js/html5shiv.min.js"></script>
-  <![endif]-->
-
-        <script src="/en/latest/_static/jquery.js?v=5d32c60e"></script>
-        <script src="/en/latest/_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-        <script src="/en/latest/_static/documentation_options.js?v=475e7f29"></script>
-        <script src="/en/latest/_static/doctools.js?v=9a2dae69"></script>
-        <script src="/en/latest/_static/sphinx_highlight.js?v=dc90522c"></script>
-        <script src="/en/latest/_static/clipboard.min.js?v=a7894cd8"></script>
-        <script src="/en/latest/_static/copybutton.js?v=f281be69"></script>
+      <script src="/en/latest/_static/jquery.js?v=5d32c60e"></script>
+      <script src="/en/latest/_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
+      <script src="/en/latest/_static/documentation_options.js?v=475e7f29"></script>
+      <script src="/en/latest/_static/doctools.js?v=9bcbadda"></script>
+      <script src="/en/latest/_static/sphinx_highlight.js?v=dc90522c"></script>
+      <script src="/en/latest/_static/clipboard.min.js?v=a7894cd8"></script>
+      <script src="/en/latest/_static/copybutton.js?v=f281be69"></script>
     <script src="/en/latest/_static/js/theme.js"></script>
     <link rel="index" title="Index" href="/en/latest/genindex.html" />
     <link rel="search" title="Search" href="/en/latest/search.html" />
@@ -283,18 +290,7 @@ <h1>Page not found</h1>
       jQuery(function () {
           SphinxRtdTheme.Navigation.enable(true);
       });
-  </script>
-    <!-- Theme Analytics -->
-    <script async src="https://www.googletagmanager.com/gtag/js?id=G-LQZCKGZE94"></script>
-    <script>
-      window.dataLayer = window.dataLayer || [];
-      function gtag(){dataLayer.push(arguments);}
-      gtag('js', new Date());
-
-      gtag('config', 'G-LQZCKGZE94', {
-          'anonymize_ip': false,
-      });
-    </script> 
+  </script> 
 
 </body>
 </html>
diff --git a/en/latest/_sources/scripting/launch_types.rst.txt b/en/latest/_sources/scripting/launch_types.rst.txt
@@ -58,3 +58,20 @@ If there is no prefix specified, the ``post:`` will be used automatically.
     pre:pre_extra_script.py
     post:post_extra_script1.py
     post_extra_script2.py
+
+.. note::
+   PlatformIO includes a service stage during runtime where it re-executes extra
+   scripts to gather integration information intended for IDE plugins. If you want
+   your scripts to run exclusively for the "build" target, include the following
+   hook at the beginning of your script:
+
+.. code-block:: python
+
+   Import("env")
+
+   if env.IsIntegrationDump():
+      # stop the current script execution
+      Return()
+
+   # code below runs for the "build" and other targets
+   env.Append(CPPDEFINES=["MACRO_NAME"])
diff --git a/en/latest/_static/basic.css b/en/latest/_static/basic.css
@@ -1,12 +1,5 @@
 /*
- * basic.css
- * ~~~~~~~~~
- *
  * Sphinx stylesheet -- basic theme.
- *
- * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
  */
 
 /* -- main layout ----------------------------------------------------------- */
@@ -115,15 +108,11 @@ img {
 /* -- search page ----------------------------------------------------------- */
 
 ul.search {
-    margin: 10px 0 0 20px;
-    padding: 0;
+    margin-top: 10px;
 }
 
 ul.search li {
-    padding: 5px 0 5px 20px;
-    background-image: url(file.png);
-    background-repeat: no-repeat;
-    background-position: 0 7px;
+    padding: 5px 0;
 }
 
 ul.search li a {

diff --git a/en/latest/_static/css/badge_only.css b/en/latest/_static/css/badge_only.css
diff --git a/en/latest/_static/css/theme.css b/en/latest/_static/css/theme.css
diff --git a/en/latest/_static/doctools.js b/en/latest/_static/doctools.js
@@ -1,12 +1,5 @@
 /*
- * doctools.js
- * ~~~~~~~~~~~
- *
  * Base JavaScript utilities for all Sphinx HTML documentation.
- *
- * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
  */
 "use strict";
 

diff --git a/en/latest/_static/fonts/Lato/lato-bold.eot b/en/latest/_static/fonts/Lato/lato-bold.eot
diff --git a/en/latest/_static/fonts/Lato/lato-bold.ttf b/en/latest/_static/fonts/Lato/lato-bold.ttf
diff --git a/en/latest/_static/fonts/Lato/lato-bold.woff b/en/latest/_static/fonts/Lato/lato-bold.woff
diff --git a/en/latest/_static/fonts/Lato/lato-bold.woff2 b/en/latest/_static/fonts/Lato/lato-bold.woff2
diff --git a/en/latest/_static/fonts/Lato/lato-bolditalic.eot b/en/latest/_static/fonts/Lato/lato-bolditalic.eot
diff --git a/en/latest/_static/fonts/Lato/lato-bolditalic.ttf b/en/latest/_static/fonts/Lato/lato-bolditalic.ttf
diff --git a/en/latest/_static/fonts/Lato/lato-bolditalic.woff b/en/latest/_static/fonts/Lato/lato-bolditalic.woff
diff --git a/en/latest/_static/fonts/Lato/lato-bolditalic.woff2 b/en/latest/_static/fonts/Lato/lato-bolditalic.woff2
diff --git a/en/latest/_static/fonts/Lato/lato-italic.eot b/en/latest/_static/fonts/Lato/lato-italic.eot
diff --git a/en/latest/_static/fonts/Lato/lato-italic.ttf b/en/latest/_static/fonts/Lato/lato-italic.ttf
diff --git a/en/latest/_static/fonts/Lato/lato-italic.woff b/en/latest/_static/fonts/Lato/lato-italic.woff
diff --git a/en/latest/_static/fonts/Lato/lato-italic.woff2 b/en/latest/_static/fonts/Lato/lato-italic.woff2
diff --git a/en/latest/_static/fonts/Lato/lato-regular.eot b/en/latest/_static/fonts/Lato/lato-regular.eot
diff --git a/en/latest/_static/fonts/Lato/lato-regular.ttf b/en/latest/_static/fonts/Lato/lato-regular.ttf
diff --git a/en/latest/_static/fonts/Lato/lato-regular.woff b/en/latest/_static/fonts/Lato/lato-regular.woff
diff --git a/en/latest/_static/fonts/Lato/lato-regular.woff2 b/en/latest/_static/fonts/Lato/lato-regular.woff2
diff --git a/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-bold.eot b/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-bold.eot
diff --git a/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-bold.ttf b/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-bold.ttf
diff --git a/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-bold.woff b/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-bold.woff
diff --git a/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-bold.woff2 b/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-bold.woff2
diff --git a/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-regular.eot b/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-regular.eot
diff --git a/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-regular.ttf b/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-regular.ttf
diff --git a/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-regular.woff b/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-regular.woff
diff --git a/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-regular.woff2 b/en/latest/_static/fonts/RobotoSlab/roboto-slab-v7-regular.woff2
diff --git a/en/latest/_static/js/html5shiv-printshiv.min.js b/en/latest/_static/js/html5shiv-printshiv.min.js
diff --git a/en/latest/_static/js/html5shiv.min.js b/en/latest/_static/js/html5shiv.min.js