"circular toctree references detected" warning raised with 1.6.0

[ansbmartin]

🔍 Before submitting the issue

• I have searched among the existing issues
• I am using a Python virtual environment

🐞 Description of the bug

When running sphinx-build on a simple project (a master RST file with a toctree directive referencing another RST file), the following warning is raised:

WARNING: circular toctree references detected, ignoring: index <- index [toc.circular]

📝 Steps to reproduce

• unzip the attached file ansys-theme-circular-refs-warning.zip
• run sphinx-build -M html . _build

Note: the issue does occurs with ansys-sphinx-theme 1.6.0 but not with 1.5.3.

💻 Which operating system are you using?

Windows

📀 Which ANSYS version are you using?

ansys-sphinx-theme==1.6.0

🐍 Which Python version are you using?

3.13

📦 Installed packages

accessible-pygments==0.0.5
alabaster==1.0.0
ansys-sphinx-theme==1.6.0
babel==2.17.0
beautifulsoup4==4.13.4
certifi==2025.6.15
charset-normalizer==3.4.2
colorama==0.4.6
docutils==0.21.2
idna==3.10
imagesize==1.4.1
importlib_metadata==8.7.0
Jinja2==3.1.6
MarkupSafe==3.0.2
packaging==25.0
pdf2image==1.17.0
pillow==11.2.1
pydata-sphinx-theme==0.15.4
Pygments==2.19.2
PyYAML==6.0.2
requests==2.32.4
roman-numerals-py==3.1.0
snowballstemmer==3.0.1
soupsieve==2.7
Sphinx==8.2.3
sphinxcontrib-applehelp==2.0.0
sphinxcontrib-devhelp==2.0.0
sphinxcontrib-htmlhelp==2.1.0
sphinxcontrib-jsmath==1.0.1
sphinxcontrib-qthelp==2.0.0
sphinxcontrib-serializinghtml==2.0.0
typing_extensions==4.14.0
urllib3==2.5.0
zipp==3.23.0

[Revathyvenugopal162]

Hello @ansbmartin , thank you for opening the issue. Could you please try using ansys-sphinx-theme version 1.6.1? The issue should be resolved in this patch release. Please let me know if the problem persists.

[ansbmartin]

Hi @Revathyvenugopal162, the problem is fixed with version 1.6.1, thanks!

[Revathyvenugopal162]

Thank you for the response. Closing the issue