search

eclipse-kura / kura

Eclipse Kura™ is a versatile framework to supercharge your edge devices, streamlining the process of configuring your gateway, connecting sensors, and IoT devices to seamlessly collect, process, and send data to the cloud.
https://eclipse.dev/kura/
Eclipse Public License 2.0
506 stars 312 forks source link

ci: update `mkdocs` versions #5206

Closed mattdibi closed 7 months ago

mattdibi commented 7 months ago

Fix the documentation build automation by updating the mkdocs versions.

The documentation build automation started acting up recently due to a change in mike dependencies.

image

See: https://github.com/eclipse/kura/actions/runs/8551781748/job/23571664614

I was able to reproduce the issue locally:

mike deploy docs-develop
error: lxml.html.clean module is now a separate project lxml_html_clean.
Install lxml[html_clean] or lxml_html_clean directly.

The fix just updates the mkdocs-jupyter-related plugins

pip3 install --upgrade mkdocs-jupyter
Requirement already satisfied: mkdocs-jupyter in ./newtest/lib/python3.11/site-packages (0.22.0)
Collecting mkdocs-jupyter
  Downloading mkdocs_jupyter-0.24.7-py3-none-any.whl.metadata (9.4 kB)
mike deploy docs-develop
INFO     -  Cleaning site directory
INFO     -  Building documentation to directory: /Users/mattia.dalben/Desktop/kura_docs/site
INFO     -  The following pages exist in the docs directory, but are not included in the "nav" configuration:
              - index.md

To do so and avoid version conflicts I had to update all the mkdocs-related plugins.