feat: migrate the builds system to stb

.gitignore

@@ -35,7 +35,6 @@ MANIFEST
 #  before PyInstaller builds the exe, so as to inject date/other infos into it.
 *.manifest
 *.spec
-
 # Installer logs
 pip-log.txt
 pip-delete-this-directory.txt
@@ -163,3 +162,8 @@ doc/source/examples/gallery-examples/
 doc/source/sg_execution_times.rst
 # rendering of sphinx autoapi examples
 doc/source/examples/api/
+
+
+# node modules and env
+node_modules/
+.nodeenv/

doc/changelog.d/639.maintenance.md

@@ -0,0 +1 @@
+feat: migrate the builds system to stb

doc/changelog.d/changelog_template.jinja

@@ -1,17 +1,22 @@
-{% if sections[""] %}
-{% for category, val in definitions.items() if category in sections[""] %}
-
-{{ definitions[category]['name'] }}
-{% set underline = '^' * definitions[category]['name']|length %}
-{{ underline }}
-
-{% for text, values in sections[""][category].items() %}
-- {{ text }} {{ values|join(', ') }}
-{% endfor %}
-
-{% endfor %}
-{% else %}
-No significant changes.
-
-
-{% endif %}
+{% if sections[""] %}
+
+.. tab-set::
+
+{%+ for category, val in definitions.items() if category in sections[""] %}
+
+  .. tab-item:: {{ definitions[category]['name'] }}
+
+    .. list-table::
+        :header-rows: 0
+        :widths: auto
+
+{% for text, values in sections[""][category].items() %}
+        * - {{ text }}
+          - {{ values|join(', ') }}
+
+{% endfor %}
+{% endfor %}
+
+{% else %}
+No significant changes.
+{% endif %}

package.json

@@ -0,0 +1,12 @@
+{
+    "name": "ansys_sphinx_theme",
+    "repository": "https://github.com/ansys/ansys-sphinx-theme",
+
+    "description": "",
+    "main": "",
+    "scripts": {
+        "build": "echo 'No build step needed' "
+    },
+    "dependencies": {},
+    "devDependencies": {}
+}

pyproject.toml

@@ -1,6 +1,12 @@
 [build-system]
-requires = ["flit_core >=3.2,<4"]
-build-backend = "flit_core.buildapi"
+requires = [
+  "sphinx-theme-builder @ https://github.com/pradyunsg/sphinx-theme-builder/archive/87214d0671c943992c05e3db01dca997e156e8d6.zip",
+]
+build-backend = "sphinx_theme_builder"
+
+[tool.sphinx-theme-builder]
+node-version = "22.9.0"
+theme-name = "ansys_sphinx_theme"
 
 [project]
 # Check https://flit.readthedocs.io/en/latest/pyproject_toml.html for all available sections
@@ -63,19 +69,7 @@ changelog = [
 ]
 
 [project.entry-points."sphinx.html_themes"]
-ansys_sphinx_theme = "ansys_sphinx_theme"
-
-[tool.flit.module]
-name = "ansys_sphinx_theme"
-
-[tool.flit.sdist]
-include = [
-    "src/ansys_sphinx_theme/theme/ansys_sphinx_theme/layout.html",
-    "src/ansys_sphinx_theme/theme/ansys_sphinx_theme/components/breadcrumbs.html",
-    "src/ansys_sphinx_theme/theme/ansys_sphinx_theme/theme.conf",
-    "src/ansys_sphinx_theme/theme/ansys_sphinx_theme/_templates/",
-    "src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/",
-]
+"ansys_sphinx_theme" = "ansys_sphinx_theme"
 
 [project.urls]
 Home = "https://sphinxdocs.ansys.com/"
@@ -147,18 +141,18 @@ name = "Fixed"
 showcontent = true
 
 [[tool.towncrier.type]]
-directory = "dependencies"
-name = "Dependencies"
+directory = "documentation"
+name = "Documentation"
 showcontent = true
 
 [[tool.towncrier.type]]
-directory = "miscellaneous"
-name = "Miscellaneous"
+directory = "test"
+name = "Test"
 showcontent = true
 
 [[tool.towncrier.type]]
-directory = "documentation"
-name = "Documentation"
+directory = "dependencies"
+name = "Dependencies"
 showcontent = true
 
 [[tool.towncrier.type]]
@@ -167,6 +161,6 @@ name = "Maintenance"
 showcontent = true
 
 [[tool.towncrier.type]]
-directory = "test"
-name = "Test"
-showcontent = true
+directory = "miscellaneous"
+name = "Miscellaneous"
+showcontent = true

src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/css/ansys_sphinx_theme.css

@@ -6,6 +6,9 @@
 @import "sphinx-design.css";
 @import "table-custom.css";
 @import "sphinx-gallery.css";
+@import "whatsnew.css";
+@import "nbsphinx.css";
+@import "ansys-sphinx-theme-variable.css";
 
 /*
 * Code cell

src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/css/ast-search.css

@@ -1,5 +1,3 @@
-@import "ansys-sphinx-theme-variable.css";
-
 .static-search-results {
   display: flex;
   flex-direction: column;

src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/css/breadcrumbs.css

@@ -1,8 +1,5 @@
 /* Provided by the Sphinx base theme template at build time,
 styles exclusively for the ansys-sphinx-theme classes. */
-
-@import "ansys-sphinx-theme-variable.css";
-
 /**
 * Breadcrumbs
 */

src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/css/pydata-sphinx-theme-custom.css

@@ -1,7 +1,5 @@
 /* Changes associated with the Ansys Sphinx Theme */
 /* for pydata-sphinx-theme */
-@import "ansys-sphinx-theme-variable.css";
-
 /*
 *
 * _secondary sidebar and primary sidebars

src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/css/sphinx-gallery.css

@@ -1,5 +1,3 @@
-@import "ansys-sphinx-theme-variable.css";
-
 /**
 * Sphinx gallery output cell
 */

src/ansys_sphinx_theme/theme/ansys_sphinx_theme/theme.conf

@@ -1,5 +1,6 @@
 [theme]
 inherit = pydata_sphinx_theme
+stylesheet = styles/ansys-sphinx-theme.css
 
 [options]
 contact_mail =