docs(examples): make example pathing more robust (#9308)

docs/src/details/auxiliary-modules/file_explorer.rst

@@ -215,7 +215,7 @@ through functions such as :cpp:func:`strcpy` and :cpp:func:`strcat` for later us
 Example
 *******
 
-.. include:: ../../examples/others/file_explorer/index.rst
+.. include:: /examples/others/file_explorer/index.rst
 
 
 

docs/src/details/auxiliary-modules/fragment.rst

@@ -82,7 +82,7 @@ Fragment Based Navigation
 Example
 *******
 
-.. include:: ../../examples/others/fragment/index.rst
+.. include:: /examples/others/fragment/index.rst
 
 
 

docs/src/details/auxiliary-modules/translation.rst

@@ -123,7 +123,7 @@ See the the bottom of this page for a complete example.
 Example
 *******
 
-.. include:: ../../examples/others/translation/index.rst
+.. include:: /examples/others/translation/index.rst
 
 .. _lv_translation_api:
 

docs/src/details/common-widget-features/events.rst

@@ -317,7 +317,7 @@ not the original Widget. To get the original target call
 Examples
 ********
 
-.. include:: ../../examples/event/index.rst
+.. include:: /examples/event/index.rst
 
 
 

docs/src/details/common-widget-features/layouts/flex.rst

@@ -210,7 +210,7 @@ You can force Flex to put an item into a new line with
 Examples
 ********
 
-.. include:: ../../../examples/layouts/flex/index.rst
+.. include:: /examples/layouts/flex/index.rst
 
 
 ..  Hyperlinks

docs/src/details/common-widget-features/layouts/grid.rst

@@ -210,7 +210,7 @@ The columns will be placed from right to left.
 Example
 *******
 
-.. include:: ../../../examples/layouts/grid/index.rst
+.. include:: /examples/layouts/grid/index.rst
 
 
 ..  Hyperlinks

docs/src/details/common-widget-features/scrolling.rst

@@ -320,7 +320,7 @@ a Widget. Here is an example to see how to handle the event:
 Examples
 ********
 
-.. include:: ../../examples/scroll/index.rst
+.. include:: /examples/scroll/index.rst
 
 .. _scroll_api:
 

docs/src/details/common-widget-features/styles/overview.rst

@@ -252,7 +252,7 @@ background properties" are the properties being referred to:
 Examples
 ********
 
-.. include:: ../../../examples/styles/index.rst
+.. include:: /examples/styles/index.rst
 
 
 

docs/src/details/debugging/monkey.rst

@@ -51,7 +51,7 @@ Note that ``input_range`` has different meanings depending on the ``type`` input
 Example
 *******
 
-.. include:: ../../examples/others/monkey/index.rst
+.. include:: /examples/others/monkey/index.rst
 
 
 

docs/src/details/libs/barcode.rst

@@ -52,7 +52,7 @@ Notes
 Example
 *******
 
-.. include:: ../../examples/libs/barcode/index.rst
+.. include:: /examples/libs/barcode/index.rst
 
 
 

docs/src/details/libs/font_support/freetype.rst

@@ -147,7 +147,7 @@ See the :cpp:func:`lv_example_freetype_2_vector_font` function for a usage examp
 Examples
 ********
 
-.. include:: ../../../examples/libs/freetype/index.rst
+.. include:: /examples/libs/freetype/index.rst
 
 
 

docs/src/details/libs/font_support/tiny_ttf.rst

@@ -47,7 +47,7 @@ allow kerning, if supported, or disable.
 Example
 *******
 
-.. include:: ../../../examples/libs/tiny_ttf/index.rst
+.. include:: /examples/libs/tiny_ttf/index.rst
 
 
 

docs/src/details/libs/gltf.rst

@@ -471,7 +471,7 @@ Animation speeds use integer values to avoid floating-point arithmetic:
 Examples
 ********
 
-.. include:: ../../examples/libs/gltf/index.rst
+.. include:: /examples/libs/gltf/index.rst
 
 
 

docs/src/details/libs/image_support/bmp.rst

@@ -49,7 +49,7 @@ Limitations
 Example
 *******
 
-.. include:: ../../../examples/libs/bmp/index.rst
+.. include:: /examples/libs/bmp/index.rst
 
 
 

docs/src/details/libs/image_support/gif.rst

@@ -90,7 +90,7 @@ ARGB8888 has a pixel size of 4.
 Example
 *******
 
-.. include:: ../../../examples/libs/gif/index.rst
+.. include:: /examples/libs/gif/index.rst
 
 
 

docs/src/details/libs/image_support/libjpeg_turbo.rst

@@ -66,7 +66,7 @@ feature to ensure that the memory usage is within a reasonable range.
 Example
 *******
 
-.. include:: ../../../examples/libs/libjpeg_turbo/index.rst
+.. include:: /examples/libs/libjpeg_turbo/index.rst
 
 
 

docs/src/details/libs/image_support/libpng.rst

@@ -59,7 +59,7 @@ stored in RGBA pixel format.
 Example
 *******
 
-.. include:: ../../../examples/libs/libpng/index.rst
+.. include:: /examples/libs/libpng/index.rst
 
 
 

docs/src/details/libs/image_support/libwebp.rst

@@ -60,7 +60,7 @@ For optimal memory usage, combine with LVGL's :ref:`overview_image_caching` feat
 Example
 *******
 
-.. include:: ../../../examples/libs/libwebp/index.rst
+.. include:: /examples/libs/libwebp/index.rst
 
 .. _libwebp_api:
 

docs/src/details/libs/image_support/lodepng.rst

@@ -52,7 +52,7 @@ for example Compress PNG: https://compresspng.com/
 Example
 *******
 
-.. include:: ../../../examples/libs/lodepng/index.rst
+.. include:: /examples/libs/lodepng/index.rst
 
 
 

docs/src/details/libs/image_support/rlottie.rst

@@ -298,7 +298,7 @@ IDF) with the appropriate :cpp:expr:`MALLOC_CAP` call --- for SPIRAM usage this
 Example
 *******
 
-.. include:: ../../../examples/libs/rlottie/index.rst
+.. include:: /examples/libs/rlottie/index.rst
 
 
 

docs/src/details/libs/image_support/svg.rst

@@ -58,7 +58,7 @@ It is also possible to draw SVG vector graphics in draw events:
 Example
 *******
 
-.. include:: ../../../examples/libs/svg/index.rst
+.. include:: /examples/libs/svg/index.rst
 
 
 .. _svg_api:

docs/src/details/libs/image_support/tjpgd.rst

@@ -65,7 +65,7 @@ Converting JPEG to C array
 Example
 *******
 
-.. include:: ../../../examples/libs/tjpgd/index.rst
+.. include:: /examples/libs/tjpgd/index.rst
 
 
 

docs/src/details/libs/qrcode.rst

@@ -43,7 +43,7 @@ Notes
 Example
 *******
 
-.. include:: ../../examples/libs/qrcode/index.rst
+.. include:: /examples/libs/qrcode/index.rst
 
 
 

docs/src/details/libs/video_support/ffmpeg.rst

@@ -90,7 +90,7 @@ Learn more about :ref:`events`.
 Examples
 ********
 
-.. include:: ../../../examples/libs/ffmpeg/index.rst
+.. include:: /examples/libs/ffmpeg/index.rst
 
 
 

docs/src/details/libs/video_support/gstreamer.rst

@@ -301,7 +301,7 @@ Once media is loaded (LV_EVENT_READY), you can access:
 Examples
 ********
 
-.. include:: ../../../examples/libs/gstreamer/index.rst
+.. include:: /examples/libs/gstreamer/index.rst
 
 .. _gstreamer_api:
 

docs/src/details/main-modules/animation.rst

@@ -373,7 +373,7 @@ Call :cpp:expr:`lv_anim_timeline_delete(timeline)` function to delete the Animat
 Examples
 ********
 
-.. include:: ../../examples/anim/index.rst
+.. include:: /examples/anim/index.rst
 
 .. _animations_api:
 

docs/src/details/main-modules/draw/snapshot.rst

@@ -84,7 +84,7 @@ is large enough, and if it fails, destroy the existing draw buffer and call
 Example
 *******
 
-.. include:: ../../../examples/others/snapshot/index.rst
+.. include:: /examples/others/snapshot/index.rst
 
 
 

docs/src/details/main-modules/fonts/font_manager.rst

@@ -127,7 +127,7 @@ being referenced, the font manager will fail to be destroyed and the function wi
 Example
 *******
 
-.. include:: ../../../examples/others/font_manager/index.rst
+.. include:: /examples/others/font_manager/index.rst
 
 
 

docs/src/details/main-modules/fonts/imgfont.rst

@@ -43,7 +43,7 @@ To destroy the *imgfont* that is no longer used, use :cpp:expr:`lv_imgfont_destr
 Example
 *******
 
-.. include:: ../../../examples/others/imgfont/index.rst
+.. include:: /examples/others/imgfont/index.rst
 
 
 

docs/src/details/main-modules/indev/gridnav.rst

@@ -86,7 +86,7 @@ hidden (:cpp:enumerator:`LV_OBJ_FLAG_HIDDEN`) to receive focus via gridnav.
 Examples
 ********
 
-.. include:: ../../../examples/others/gridnav/index.rst
+.. include:: /examples/others/gridnav/index.rst
 
 
 

docs/src/details/main-modules/observer/observer_examples.rst

@@ -4,5 +4,5 @@
 Examples
 ========
 
-.. include:: ../../../examples/others/observer/index.rst
+.. include:: /examples/others/observer/index.rst
 

docs/src/details/widgets/animimg.rst

@@ -81,7 +81,7 @@ No *Keys* are processed by Animation-Image Widgets.
 Example
 *******
 
-.. include:: ../../examples/widgets/animimg/index.rst
+.. include:: /examples/widgets/animimg/index.rst
 
 
 

docs/src/details/widgets/arc.rst

@@ -194,7 +194,7 @@ Keys
 Example
 *******
 
-.. include:: ../../examples/widgets/arc/index.rst
+.. include:: /examples/widgets/arc/index.rst
 
 
 

docs/src/details/widgets/arclabel.rst

@@ -92,7 +92,7 @@ The Arc Label does not define specific key bindings beyond those inherited from
 Example
 *******
 
-.. include:: ../../examples/widgets/arclabel/index.rst
+.. include:: /examples/widgets/arclabel/index.rst
 
 .. _lv_arclabel_api:
 

docs/src/details/widgets/bar.rst

@@ -122,7 +122,7 @@ No *Keys* are processed by Bar Widgets.
 Example
 *******
 
-.. include:: ../../examples/widgets/bar/index.rst
+.. include:: /examples/widgets/bar/index.rst
 
 
 

docs/src/details/widgets/button.rst

@@ -70,7 +70,7 @@ and :cpp:enumerator:`LV_EVENT_RELEASED` etc.
 Example
 *******
 
-.. include:: ../../examples/widgets/button/index.rst
+.. include:: /examples/widgets/button/index.rst
 
 
 

docs/src/details/widgets/buttonmatrix.rst

@@ -171,7 +171,7 @@ the button will not be activated upon leaving edit mode.
 Example
 *******
 
-.. include:: ../../examples/widgets/buttonmatrix/index.rst
+.. include:: /examples/widgets/buttonmatrix/index.rst
 
 
 

docs/src/details/widgets/calendar.rst

@@ -171,7 +171,7 @@ contains 2 Drop-Drown List Widgets for the year and month.
 Example
 *******
 
-.. include:: ../../examples/widgets/calendar/index.rst
+.. include:: /examples/widgets/calendar/index.rst
 
 
 

docs/src/details/widgets/canvas.rst

@@ -115,7 +115,7 @@ No *Keys* are processed by Canvas Widgets.
 Example
 *******
 
-.. include:: ../../examples/widgets/canvas/index.rst
+.. include:: /examples/widgets/canvas/index.rst
 
 
 

docs/src/details/widgets/chart.rst

@@ -393,7 +393,7 @@ No *Keys* are processed by Chart Widgets.
 Example
 *******
 
-.. include:: ../../examples/widgets/chart/index.rst
+.. include:: /examples/widgets/chart/index.rst
 
 
 

docs/src/details/widgets/checkbox.rst

@@ -101,7 +101,7 @@ Note that, as usual, the state of :cpp:enumerator:`LV_KEY_ENTER` is translated t
 Example
 *******
 
-.. include:: ../../examples/widgets/checkbox/index.rst
+.. include:: /examples/widgets/checkbox/index.rst
 
 
 

docs/src/details/widgets/dropdown.rst

@@ -186,7 +186,7 @@ Keys
 Example
 *******
 
-.. include:: ../../examples/widgets/dropdown/index.rst
+.. include:: /examples/widgets/dropdown/index.rst
 
 
 

docs/src/details/widgets/image.rst

@@ -242,7 +242,7 @@ No *Keys* are processed by Image Widgets.
 Example
 *******
 
-.. include:: ../../examples/widgets/image/index.rst
+.. include:: /examples/widgets/image/index.rst
 
 
 

docs/src/details/widgets/imagebutton.rst

@@ -106,7 +106,7 @@ Keys
 Example
 *******
 
-.. include:: ../../examples/widgets/imagebutton/index.rst
+.. include:: /examples/widgets/imagebutton/index.rst
 
 
 

docs/src/details/widgets/ime_pinyin.rst

@@ -121,7 +121,7 @@ The default mode is :cpp:enumerator:`LV_IME_PINYIN_MODE_K26`.
 Example
 *******
 
-.. include:: ../../examples/others/ime/index.rst
+.. include:: /examples/others/ime/index.rst
 
 
 

docs/src/details/widgets/keyboard.rst

@@ -152,7 +152,7 @@ Keys
 Example
 *******
 
-.. include:: ../../examples/widgets/keyboard/index.rst
+.. include:: /examples/widgets/keyboard/index.rst
 
 
 

docs/src/details/widgets/label.rst

@@ -295,7 +295,7 @@ No *Keys* are processed by Label Widgets.
 Example
 *******
 
-.. include:: ../../examples/widgets/label/index.rst
+.. include:: /examples/widgets/label/index.rst
 
 
 

docs/src/details/widgets/led.rst

@@ -82,7 +82,7 @@ No *Keys* are processed by LED Widgets.
 Example
 *******
 
-.. include:: ../../examples/widgets/led/index.rst
+.. include:: /examples/widgets/led/index.rst
 
 
 

docs/src/details/widgets/line.rst

@@ -86,7 +86,7 @@ No *Keys* are processed by Line Widgets.
 Example
 *******
 
-.. include:: ../../examples/widgets/line/index.rst
+.. include:: /examples/widgets/line/index.rst
 
 
 

docs/src/details/widgets/list.rst

@@ -85,7 +85,7 @@ No *Keys* are processed by List Widgets.
 Example
 *******
 
-.. include:: ../../examples/widgets/list/index.rst
+.. include:: /examples/widgets/list/index.rst