release: bump version 1.3.1

Author: Revathyvenugopal162

doc/changelog.d/617.documentation.md

@@ -0,0 +1 @@
+Fix: optimize imports for whatsnew

doc/source/user-guide/options.rst

@@ -263,6 +263,12 @@ What's new section
 The "What's new" section is an option that allows you to highlight new features in your library
 for each minor version within the changelog file.
 
+To install the "What's new" dependencies from ansys-sphinx-theme, run the following command:
+
+.. code-block:: bash
+
+    pip install ansys-sphinx-theme[changelog]
+
 To get started, create a YAML file named ``whatsnew.yml`` in the ``doc/source`` directory. The
 YAML file should contain the following structure:
 

pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "flit_core.buildapi"
 [project]
 # Check https://flit.readthedocs.io/en/latest/pyproject_toml.html for all available sections
 name = "ansys-sphinx-theme"
-version = "1.3.0"
+version = "1.3.1"
 description = "A theme devised by ANSYS, Inc. for Sphinx documentation."
 readme = "README.rst"
 requires-python = ">=3.10,<4"

src/ansys_sphinx_theme/__init__.py

@@ -34,7 +34,6 @@
 from docutils import nodes
 from sphinx import addnodes
 from sphinx.application import Sphinx
-import yaml
 
 from ansys_sphinx_theme.extension.linkcode import DOMAIN_KEYS, sphinx_linkcode_resolve
 from ansys_sphinx_theme.latex import generate_404
@@ -687,6 +686,14 @@ def get_whatsnew_data(whatsnew_file: pathlib.Path) -> dict:
     """
     if whatsnew_file.exists():
         # Open and read the whatsnew.yml file
+
+        try:
+            import yaml
+        except ImportError as e:
+            raise ImportError(
+                f"Failed to import `pyyaml`: {e}. Install the package using `pip install ansys-sphinx-theme[changelog]`"  # noqa: E501
+            )
+
         with pathlib.Path.open(whatsnew_file, "r", encoding="utf-8") as file:
             whatsnew_data = yaml.safe_load(file)
 
@@ -1143,11 +1150,11 @@ def setup(app: Sphinx) -> Dict:
     # Check for what's new options in the theme configuration
     whatsnew_file, changelog_file, sidebar_pages = get_whatsnew_options(app)
 
-    if whatsnew_file is not None and changelog_file is not None:
+    if whatsnew_file and changelog_file:
         app.connect("doctree-read", add_whatsnew_changelog)
         app.connect("doctree-resolved", extract_whatsnew)
 
-        if sidebar_pages is not None:
+        if sidebar_pages:
             app.connect("html-page-context", add_whatsnew_sidebar)
 
     app.connect("html-page-context", update_footer_theme)