Merge branch 'doc/resolve-pdf-building-issues' into 'master'

Doc/resolve pdf building issues

See merge request espressif/esp-idf!5566

docs/en/get-started-legacy/index.rst

@@ -373,10 +373,10 @@ To exit IDF monitor use the shortcut ``Ctrl+]``.
 
 If IDF monitor fails shortly after the upload, or if instead of the messages above you see a random garbage similar to what is given below, your board is likely using a 26MHz crystal. Most development board designs use 40MHz, so ESP-IDF uses this frequency as a default value.
 
-.. code-block:: none
-
-    e<EFBFBD><EFBFBD><EFBFBD>)(Xn@<40>y.!<21><>(<28>PW+)<29><>Hn9a؅/9<>!<21>t5<74><35>P<EFBFBD>~<7E>k<EFBFBD><6B>e<EFBFBD>ea<65>5<EFBFBD>jA
-    ~zY<7A><59>Y(1<>,1<15><> e<><65><EFBFBD>)(Xn@<40>y.!Dr<44>zY(<28>jpi<70>|<7C>+z5Ymvp
+.. figure:: ../../_static/get-started-garbled-output.png
+    :align: center
+    :alt: Garbled output
+    :figclass: align-center
 
 If you have such a problem, do the following:
 

docs/en/get-started/index.rst

@@ -447,10 +447,10 @@ To exit IDF monitor use the shortcut ``Ctrl+]``.
 
 If IDF monitor fails shortly after the upload, or, if instead of the messages above, you see random garbage similar to what is given below, your board is likely using a 26MHz crystal. Most development board designs use 40MHz, so ESP-IDF uses this frequency as a default value.
 
-.. code-block:: none
-
-    e<EFBFBD><EFBFBD><EFBFBD>)(Xn@<40>y.!<21><>(<28>PW+)<29><>Hn9a؅/9<>!<21>t5<74><35>P<EFBFBD>~<7E>k<EFBFBD><6B>e<EFBFBD>ea<65>5<EFBFBD>jA
-    ~zY<7A><59>Y(1<>,1<15><> e<><65><EFBFBD>)(Xn@<40>y.!Dr<44>zY(<28>jpi<70>|<7C>+z5Ymvp
+.. figure:: ../../_static/get-started-garbled-output.png
+    :align: center
+    :alt: Garbled output
+    :figclass: align-center
 
 If you have such a problem, do the following:
 

docs/en/index.rst

@@ -14,24 +14,24 @@ This is the documentation for Espressif IoT Development Framework (`esp-idf <htt
 `API Guides`_       `Contribute`_       `Resources`_
 ==================  ==================  ==================
 
-.. |Get Started| image:: ../_static/get-started.gif
+.. |Get Started| image:: ../_static/get-started.png
 .. _Get Started: get-started/index.html
 
-.. |API Reference| image:: ../_static/api-reference.gif
+.. |API Reference| image:: ../_static/api-reference.png
 .. _API Reference: api-reference/index.html
 
-.. |H/W Reference| image:: ../_static/hw-reference.gif
+.. |H/W Reference| image:: ../_static/hw-reference.png
 .. _H/W Reference: hw-reference/index.html
 
-.. |API Guides| image:: ../_static/api-guides.gif
+.. |API Guides| image:: ../_static/api-guides.png
 .. _API Guides: api-guides/index.html
 
 .. _Libraries and Frameworks: libraries-and-frameworks/index.html
 
-.. |Contribute| image:: ../_static/contribute.gif
+.. |Contribute| image:: ../_static/contribute.png
 .. _Contribute: contribute/index.html
 
-.. |Resources| image:: ../_static/resources.gif
+.. |Resources| image:: ../_static/resources.png
 .. _Resources: resources.html
 
 

docs/zh_CN/get-started-legacy/index.rst

@@ -369,10 +369,10 @@ Windows 操作系统
 
 如果 IDF 监视器在烧录后很快发生错误，或打印信息全是乱码（见下），很有可能是因为您的开发板选用了 26 MHz 晶振，而 ESP-IDF 默认支持大多数开发板使用的 40 MHz 晶振。
 
-.. code-block:: none
-
-    e<EFBFBD><EFBFBD><EFBFBD>)(Xn@<40>y.!<21><>(<28>PW+)<29><>Hn9a؅/9<>!<21>t5<74><35>P<EFBFBD>~<7E>k<EFBFBD><6B>e<EFBFBD>ea<65>5<EFBFBD>jA
-    ~zY<7A><59>Y(1<>,1<15><> e<><65><EFBFBD>)(Xn@<40>y.!Dr<44>zY(<28>jpi<70>|<7C>+z5Ymvp
+.. figure:: ../../_static/get-started-garbled-output.png
+    :align: center
+    :alt: 乱码输出
+    :figclass: align-center
 
 此时，请您：
 

docs/zh_CN/get-started/index.rst

@@ -440,10 +440,10 @@ Python 2.7 安装程序将尝试配置 Windows，将 ``.py`` 文件与 Python 2
 
 如果 IDF 监视器在烧录后很快发生错误，或打印信息全是乱码（见下），很有可能是因为您的开发板选用了 26 MHz 晶振，而 ESP-IDF 默认支持大多数开发板使用的 40 MHz 晶振。
 
-.. code-block:: none
-
-    e<EFBFBD><EFBFBD><EFBFBD>)(Xn@<40>y.!<21><>(<28>PW+)<29><>Hn9a؅/9<>!<21>t5<74><35>P<EFBFBD>~<7E>k<EFBFBD><6B>e<EFBFBD>ea<65>5<EFBFBD>jA
-    ~zY<7A><59>Y(1<>,1<15><> e<><65><EFBFBD>)(Xn@<40>y.!Dr<44>zY(<28>jpi<70>|<7C>+z5Ymvp
+.. figure:: ../../_static/get-started-garbled-output.png
+    :align: center
+    :alt: 乱码输出
+    :figclass: align-center
 
 此时，请您：
 

docs/zh_CN/index.rst

@@ -15,24 +15,24 @@ ESP-IDF 编程指南
 ==================  ==================  ==================
 
 
-.. |快速入门| image:: ../_static/get-started.gif
+.. |快速入门| image:: ../_static/get-started.png
 .. _快速入门: get-started/index.html
 
-.. |API 参考| image:: ../_static/api-reference.gif
+.. |API 参考| image:: ../_static/api-reference.png
 .. _API 参考: api-reference/index.html
 
-.. |H/W 参考| image:: ../_static/hw-reference.gif
+.. |H/W 参考| image:: ../_static/hw-reference.png
 .. _H/W 参考: hw-reference/index.html
 
-.. |API 指南| image:: ../_static/api-guides.gif
+.. |API 指南| image:: ../_static/api-guides.png
 .. _API 指南: api-guides/index.html
 
 .. _Libraries and Frameworks: libraries-and-frameworks/index.html
 
-.. |贡献代码| image:: ../_static/contribute.gif
+.. |贡献代码| image:: ../_static/contribute.png
 .. _贡献代码: contribute/index.html
 
-.. |相关资源| image:: ../_static/resources.gif
+.. |相关资源| image:: ../_static/resources.png
 .. _相关资源: resources.html