asyml / asyml/forte

Current `sphinx_rtd_theme` doesn't support Sphinx>=4.0

Open
#620 0 comments 0 reactions 0 assignees View on GitHub
priority: low topic: docs
Dominant language
Python
Stars
253
Forks
59
PR merge metrics
No merged PRs in 30d

Description

**Is your feature request related to a problem? Please describe.**
Current html theme package `sphinx_rtd_theme` doesn't support Sphinx version >=4.0.
If sphinx version >= 4.0 is installed, rendered html doesn't have css style.

**Describe the solution you'd like**
Upgrade Sphinx to a version >=4.0 and find a compatible theme.

**Describe alternatives you've considered**
None.

**Additional context**
Wrong rendered html:
image

Correct rendered html:
image

Contributor guide

Open the contributing guide

Research direction

Start by locating the documentation build configuration and its Sphinx and sphinx_rtd_theme dependencies. Reproduce the build with Sphinx >=4.0, identify a compatible theme, and verify that the rendered HTML includes the expected CSS styling.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.