feat: migrate the builds system to stb

[Revathyvenugopal162]

fix #634

• Migrate the theme builder to sphinx theme builder
• cleanup the pyproject.toml file
• Add package.json and package.json.lock file as part of build system
• Change the order of changelog types

[github-actions]

The towncrier template has been successfully rewritten with the default template.
Please ensure that sphinx-design is included as a dependency in your project's documentation requirements.
Additionally, add sphinx-design to the extensions list in your conf.py file.
For more information, please refer to the migration guide at:
https://actions.docs.ansys.com/version/stable/migrations/index.html#migration-guide

[jorgepiloto]

Just left some comments regarding Node.js and the build system versions.

[jorgepiloto]

Any reason for this particular commit? Why not pointing to the latest stable version?

[Revathyvenugopal162]

I initially encountered an infinite loop while testing with another package, possibly due to an oversight when adapting from PyData. I'll test the latest release again and make the necessary adjustments.

[RobPasMue]

Isn't this going to prevent us from releasing? I know PyPI doesn't like links to repositories as dependencies

[jorgepiloto]

Good point.

[Revathyvenugopal162]

i updated to latest version, working with my tox env, (may be issue is only with nox env)

[jorgepiloto]

Can you elaborate more about this issue, @Revathyvenugopal162?

[Revathyvenugopal162]

Yes, STB can run the docs live using the command stb serve doc/source/ --open-browser. However, I encountered an issue where it was stuck in an infinite loop, preventing the browser from opening and running it properly. I referred to other themes and noticed they were using a specific commit. After testing with Tox, it worked fine, so the issue might be related to my environment or possibly the Nox environment.

[Revathyvenugopal162]

i will open another PR to add docs-preview in tox env, but the issue persists when using Sphinx-Gallery with build_example = True, causing the docs to enter an infinite loop.

[Revathyvenugopal162]

PR : #642

[jorgepiloto]

Super cool! Thanks, @Revathyvenugopal162.