ci(docs) replace use of sed with proper configuration variables

docs/CONTRIBUTING.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/CONTRIBUTING.md
 ```
 
 # Contributing

docs/build.py

@@ -32,14 +32,8 @@ ex.exec()
 
 urlpath = re.sub('release/', '', br)
 
-# Be sure the GitHub links point to the right branch
-f = open("header.rst", "w")
-f.write(".. |github_link_base| replace:: https://github.com/lvgl/lvgl/blob/" + gitcommit + "/docs")
-f.close()
-
-base_html = "html_baseurl = 'https://docs.lvgl.io/" + urlpath + "/en/html/'"
-
-os.system("sed -i \"s|html_baseurl = .*|" + base_html +"|\" conf.py")
+os.environ['LVGL_URLPATH'] = urlpath
+os.environ['LVGL_GITCOMMIT'] = gitcommit
 
 clean = 0
 trans = 0

docs/conf.py

@@ -114,9 +114,23 @@ html_theme_options = {
     'logo_only': True,
 }
 # For site map generation
-html_baseurl = 'https://docs.lvgl.io/master/en/html/'
+html_baseurl = f"https://docs.lvgl.io/{os.environ['LVGL_URLPATH']}/en/html/"
+
 sitemap_url_scheme = "{link}"
 
+#lvgl_github_url = f"https://github.com/lvgl/lvgl/blob/{os.environ['LVGL_GITCOMMIT']}/docs"
+
+#extlinks = {'github_link_base': (github_url + '%s', github_url)}
+
+html_context = {
+    'github_version': os.environ['LVGL_GITCOMMIT'],
+    'github_user': 'lvgl',
+    'github_repo': 'lvgl',
+    'display_github': True,
+    'conf_py_path': '/docs/'
+}
+
+
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".

docs/example_list.py

@@ -103,7 +103,6 @@ def exec():
      d_all.update(d_act)
 
   fout.write("```eval_rst\n")
-  fout.write(".. include:: /header.rst\n")
   fout.write(":github_url: |github_link_base|/examples.md\n")
   fout.write("```\n")
   fout.write("\n")
@@ -124,4 +123,3 @@ def exec():
       print_item(h, 3, d_all, fout)
 
     fout.write("")
-

docs/get-started/bindings/cpp.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/bindings/micropython.md
 ```
 # Cpp
 

docs/get-started/bindings/index.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/bindings/index.md
 ```
 # Bindings
 

docs/get-started/bindings/micropython.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/bindings/micropython.md
 ```
 # Micropython
 

docs/get-started/index.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/index.md
 ```
 # Get started
 

docs/get-started/os/freertos.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/os/freertos.md
 ```
 # FreeRTOS
 

docs/get-started/os/index.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/os/index.md
 ```
 # (RT)OS
 

docs/get-started/os/nuttx.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/os/nuttx.md
 ```
 # NuttX RTOS
 

docs/get-started/os/rt-thread.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/os/rt-thread.md
 ```
 # RT-Thread RTOS
 

docs/get-started/os/zephyr.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/os/zephyr.md
 ```
 # Zephyr
 

docs/get-started/platforms/arduino.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/platforms/arduino.md
 ```
 
 # Arduino

docs/get-started/platforms/cmake.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/platforms/cmake.md
 ```
 
 # CMake

docs/get-started/platforms/espressif.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/platforms/espressif.md
 ```
 
 # Espressif (ESP32 chip series)

docs/get-started/platforms/index.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/index.md
 ```
 # Platforms
 

docs/get-started/platforms/nxp.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/platforms/nxp.md
 ```
 # NXP
 NXP has integrated LVGL into the MCUXpresso SDK packages for several of their general

docs/get-started/platforms/pc-simulator.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/platoforms/simulator.md
 ```
 # Simulator on PC
 

docs/get-started/platforms/stm32.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/platforms/stm32.md
 ```
 
 # STM32

docs/get-started/platforms/tasmota-berry.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/platforms/tasmota-berry.md
 ```
 # Tasmota and berry
 

docs/get-started/quick-overview.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/get-started/quick-overview.md
 ```
 
 # Quick overview

docs/header.rst

@@ -1 +0,0 @@
-.. |github_link_base| replace:: https://github.com/lvgl/lvgl/blob/8a8153219163b689e8f96d6a97c1f128eefd7ce2/docs

docs/index.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/index.md
 ```
 
 ```eval_rst

docs/intro/index.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/intro/index.md
 ```
 
 # Introduction

docs/layouts/flex.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/layouts/flex.md
 ```
 
 # Flex

docs/layouts/grid.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/layouts/grid.md
 ```
 
 # Grid

docs/layouts/index.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/layouts/index.md
 ```
 
 # Layouts

docs/libs/bmp.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/libs/bmp.md
 ```
 
 # BMP decoder

docs/libs/ffmpeg.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/libs/ffmpeg.md
 ```
 
 # FFmpeg support

docs/libs/freetype.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/libs/freetype.md
 ```
 
 # FreeType support

docs/libs/fsdrv.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/libs/fsdrv.md
 ```
 
 # File System Interfaces

docs/libs/gif.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/libs/gif.md
 ```
 
 # GIF decoder

docs/libs/index.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/libs/index.md
 ```
 # 3rd party libraries
 

docs/libs/png.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/libs/png.md
 ```
 
 # PNG decoder

docs/libs/qrcode.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/libs/qrcode.md
 ```
 
 # QR code

docs/libs/rlottie.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/libs/rlottie.md
 ```
 
 

docs/libs/sjpg.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/libs/sjpg.md
 ```
 
 # JPG decoder

docs/others/fragment.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/others/fragment.md
 ```
 
 # Fragment

docs/others/gridnav.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/others/gridnav.md
 ```
 # Grid navigation
 

docs/others/imgfont.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/others/imgfont.md
 ```
 ## Image font (imgfont)
 Draw image in label or span obj with imgfont.

docs/others/index.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/others/index.md
 ```
 # Others
 

docs/others/monkey.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/others/monkey.md
 ```
 # Monkey
 

docs/others/msg.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/others/msg.md
 ```
 # Messaging
 

docs/others/snapshot.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/others/snapshot.md
 ```
 # Snapshot
 

docs/overview/animation.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/overview/animation.md
 ```
 # Animations
 

docs/overview/color.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/overview/color.md
 ```
 # Colors
 

docs/overview/coords.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/overview/coords.md
 ```
 # Positions, sizes, and layouts
 

docs/overview/display.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/overview/display.md
 ```
 # Displays
 

docs/overview/drawing.md

@@ -1,6 +1,4 @@
 ```eval_rst
-.. include:: /header.rst
-:github_url: |github_link_base|/overview/drawing.md
 ```
 # Drawing