diff --git a/.gitignore b/.gitignore
index 4c5db26..918e930 100644
--- a/.gitignore
+++ b/.gitignore
@@ -64,7 +64,6 @@ coverage.xml
diff_*.html
*.report
report
-venv
acceptance_tests.*.log
acceptance_tests.*.png
diff --git a/docs/conf.py b/docs/conf.py
index 5ba8fa8..3e9f781 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -16,7 +16,7 @@
import sys
from subprocess import check_call
-import edx_theme
+import sphinx_book_theme
def get_version(*file_paths):
@@ -59,7 +59,7 @@ def get_version(*file_paths):
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = [
- 'edx_theme',
+ 'sphinx_book_theme',
'sphinx.ext.autodoc',
'sphinx.ext.doctest',
'sphinx.ext.intersphinx',
@@ -90,8 +90,8 @@ def get_version(*file_paths):
# General information about the project.
project = 'program_intent_engagement'
-copyright = edx_theme.COPYRIGHT # pylint: disable=redefined-builtin
-author = edx_theme.AUTHOR
+copyright = "2024, edX LLC" # pylint: disable=redefined-builtin
+author = "edX LLC"
project_title = 'program_intent_engagement'
documentation_title = f"{project_title}"
@@ -172,16 +172,55 @@ def get_version(*file_paths):
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
-html_theme = 'edx_theme'
+html_theme = 'sphinx_book_theme'
# Theme options are theme-specific and customize the look and feel of a theme
# further. For a list of options available for each theme, see the
# documentation.
#
-# html_theme_options = {}
+html_theme_options = {
+
+ "repository_url": 'https://github.com/edx/program-intent-engagement',
+ "repository_branch": 'main',
+ "path_to_docs": "docs/",
+ "use_repository_button": True,
+ "use_issues_button": True,
+ "use_edit_page_button": True,
+ # Please don't change unless you know what you're doing.
+ "extra_footer": """
+
+
+
+
+ These works by
+ edX LLC
+ are licensed under a
+ Creative Commons Attribution-ShareAlike 4.0 International License.
+ """
+}
+
+html_logo = "https://logos.openedx.org/open-edx-logo-color.png"
+html_favicon = "https://logos.openedx.org/open-edx-favicon.ico"
+
-# Add any paths that contain custom themes here, relative to this directory.
-html_theme_path = [edx_theme.get_html_theme_path()]
+# Set the DJANGO_SETTINGS_MODULE if it's not set.
+# Only if your project has a dependency on Django
+if not os.environ.get('DJANGO_SETTINGS_MODULE'):
+ # If you do depend on django you'll need a settings file that you can
+ # use when building docs. This will allow you to pull docstrings from
+ # your code.
+ os.environ['DJANGO_SETTINGS_MODULE'] = 'test_utils.test_settings'
# The name for this set of Sphinx documents.
# " v documentation" by default.
diff --git a/requirements/doc.in b/requirements/doc.in
index 68f4cb2..9fe66db 100644
--- a/requirements/doc.in
+++ b/requirements/doc.in
@@ -4,7 +4,7 @@
-r test.txt # Core and testing dependencies for this package
doc8 # reStructuredText style checker
-edx_sphinx_theme # edX theme for Sphinx output
+sphinx-book-theme # edX theme for Sphinx output
twine # Validates README.rst for usage on PyPI
build # Needed to build the wheel for twine check
Sphinx # Documentation builder
diff --git a/requirements/doc.txt b/requirements/doc.txt
index 53c8275..8adecaa 100644
--- a/requirements/doc.txt
+++ b/requirements/doc.txt
@@ -4,6 +4,8 @@
#
# make upgrade
#
+accessible-pygments==0.0.4
+ # via pydata-sphinx-theme
alabaster==0.7.16
# via sphinx
asgiref==3.8.1
@@ -16,6 +18,8 @@ astroid==3.3.5
# -r requirements/test.txt
# pylint
# pylint-celery
+beautifulsoup4==4.12.3
+ # via pydata-sphinx-theme
babel==2.16.0
# via sphinx
build==1.2.2.post1
@@ -98,7 +102,6 @@ django==4.2.16
# via
# -c requirements/common_constraints.txt
# -c requirements/constraints.txt
- # -r requirements/test.txt
# django-cors-headers
# django-crum
# django-extensions
@@ -149,6 +152,7 @@ doc8==1.1.2
docutils==0.19
# via
# doc8
+ # pydata-sphinx-theme
# readme-renderer
# restructuredtext-lint
# sphinx
@@ -181,8 +185,10 @@ edx-opaque-keys==2.11.0
# edx-drf-extensions
edx-rest-api-client==6.0.0
# via -r requirements/test.txt
-edx-sphinx-theme==3.1.0
- # via -r requirements/doc.in
+exceptiongroup==1.2.2
+ # via
+ # -r requirements/test.txt
+ # pytest
factory-boy==3.3.1
# via -r requirements/test.txt
faker==30.8.0
@@ -276,6 +282,7 @@ packaging==24.1
# -r requirements/test.txt
# build
# drf-yasg
+ # pydata-sphinx-theme
# pyproject-api
# pytest
# sphinx
@@ -305,9 +312,13 @@ pycparser==2.22
# via
# -r requirements/test.txt
# cffi
+pydata-sphinx-theme==0.14.4
+ # via sphinx-book-theme
pygments==2.18.0
# via
+ # accessible-pygments
# doc8
+ # pydata-sphinx-theme
# readme-renderer
# rich
# sphinx
@@ -425,7 +436,6 @@ six==1.16.0
# edx-auth-backends
# edx-django-release-util
# edx-lint
- # edx-sphinx-theme
# python-dateutil
snowballstemmer==2.2.0
# via sphinx
@@ -438,11 +448,16 @@ social-auth-core==4.5.4
# -r requirements/test.txt
# edx-auth-backends
# social-auth-app-django
+soupsieve==2.5
+ # via beautifulsoup4
sphinx==5.3.0
# via
# -r requirements/doc.in
- # edx-sphinx-theme
-sphinxcontrib-applehelp==2.0.0
+ # pydata-sphinx-theme
+ # sphinx-book-theme
+sphinx-book-theme==1.0.1
+ # via -r requirements/doc.in
+sphinxcontrib-applehelp==1.0.4
# via sphinx
sphinxcontrib-devhelp==2.0.0
# via sphinx
@@ -481,6 +496,9 @@ typing-extensions==4.12.2
# via
# -r requirements/test.txt
# edx-opaque-keys
+ # pydata-sphinx-theme
+ # pylint
+ # rich
# faker
uritemplate==4.1.1
# via