Skip to content

Conversation

@JakubAndrysek
Copy link

@JakubAndrysek JakubAndrysek commented Nov 25, 2025

This PR adds a new Sphinx plugin docs-embed that provides directives to embed the Wokwi simulator directly into the documentation.
It also adds support for embedding Arduino examples just by linking the example path.
The plugin adds two new directives:

  • .. wokwi:: directive embeds a Wokwi diagram specified by JSON file and firmware binary file URLs.
  • .. wokwi-example:: directive embeds a Wokwi example from the docs folder. Currently supports only Arduino framework examples.

PR also adds a CLI command to maintain the ci.yml file used by the Arduino ESP32 framework to prepare tests for web examples.

The plugin was tested together with Arduino ESP32 fork, and the compilation and deployment work fine.

image image image

The last change which has to be done is to replace the Wokwi Client JS URL with the latest published version.
But I am still waiting for the publishing.
It is published on NPM.

@JakubAndrysek
Copy link
Author

PR is ready from my side. Please look at it.
Thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant