cederom opened a new pull request, #120: URL: https://github.com/apache/nuttx-website/pull/120
## Summary * CI runner on nuttx-website repo creates main and documentation websites. * Documentation build includes current master and previous releases. * Documentation uses Sphinx as documentation generator. Sphinx needs Python. * Sphinx may have different dependencies for different NuttX release. * Python packages are managed with PipEnv per release deinfed in Pipfile. * Until now all doc build dependencies were the same, so single build environment setup (pipenv install) for Sphinx was okay before build loop. * Recently m2r2 package was replaced with myst-parser in #nuttx/86be27b. * m2r2 and myst-parser are exclusive Sphinx extensions used for the same task, but the build for older releases got broken (requires m2r2). * Sphinx PipEnv dependencies (un)install was moved into the build loop that will privde packages required by a given release defined in Pipfile. * CI builder script was also updated with helpful log messages. ## Impact Fix documentation build for older NuttX releases after switching from `m2r2` Sphinx extension to `myst-parser`. ## Testing * GitHub Actions tested on my fork, but without updating the public websites. * PLEASE VERIFY [1] and [2] AFTER MERGE! Including documentation for older releases. [1] https://nuttx.apache.org/ [2] https://nuttx.apache.org/docs/latest/ -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
