chore: Switch from edx-sphinx-theme to sphinx-book-theme

The edx-sphinx theme is being deprecated, and replaced with sphinx-book-theme.
This removes references to the deprecated theme and replaces them with the new
standard theme for the platform.

Author: xitij2000

CHANGELOG.rst

@@ -14,6 +14,9 @@ Change Log
 Unreleased
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+* Switch from ``edx-sphinx-theme`` to ``sphinx-book-theme`` since the former is
+  deprecated
+
 [1.4.0] - 2022-05-23
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

docs/conf.py

@@ -17,9 +17,10 @@
 import os
 import re
 import sys
+from datetime import datetime
 from subprocess import check_call
 
-import edx_theme
+
 
 
 def get_version(*file_paths):
@@ -57,7 +58,6 @@ def get_version(*file_paths):
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    'edx_theme',
     'sphinx.ext.autodoc',
     'sphinx.ext.doctest',
     'sphinx.ext.intersphinx',
@@ -88,8 +88,8 @@ def get_version(*file_paths):
 
 # General information about the project.
 project = 'code-annotations'
-copyright = edx_theme.COPYRIGHT  # pylint: disable=redefined-builtin
-author = edx_theme.AUTHOR
+copyright = f'{datetime.now().year}, edX Inc.'  # pylint: disable=redefined-builtin
+author = 'edX Inc.'
 project_title = 'Code Annotations'
 documentation_title = f"{project_title}"
 
@@ -160,16 +160,46 @@ 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/openedx/code-annotations",
+    "repository_branch": "master",
+    "path_to_docs": "docs/",
+    "home_page_in_toc": True,
+    "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": """
+        <a rel="license" href="https://creativecommons.org/licenses/by-sa/4.0/">
+            <img
+                alt="Creative Commons License"
+                style="border-width:0"
+                src="https://i.creativecommons.org/l/by-sa/4.0/80x15.png"/>
+        </a>
+        <br>
+        These works by
+            <a
+                xmlns:cc="https://creativecommons.org/ns#"
+                href="https://openedx.org"
+                property="cc:attributionName"
+                rel="cc:attributionURL"
+            >The Center for Reimagining Learning</a>
+        are licensed under a
+            <a
+                rel="license"
+                href="https://creativecommons.org/licenses/by-sa/4.0/"
+            >Creative Commons Attribution-ShareAlike 4.0 International License</a>.
+    """
+}
 
 # Add any paths that contain custom themes here, relative to this directory.
-html_theme_path = [edx_theme.get_html_theme_path()]
+# html_theme_path = []
 
 # The name for this set of Sphinx documents.
 # "<project> v<release> documentation" by default.
@@ -183,13 +213,13 @@ def get_version(*file_paths):
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
 #
-# html_logo = None
+html_logo = "https://logos.openedx.org/open-edx-logo-color.png"
 
 # The name of an image file (relative to this directory) to use as a favicon of
 # the docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
 # pixels large.
 #
-# html_favicon = None
+html_favicon = "https://logos.openedx.org/open-edx-favicon.ico"
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,

requirements/doc.in

@@ -4,6 +4,6 @@
 -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         # Common theme for all Open edX projects
 Sphinx                    # Documentation builder
 twine                     # Validates README.rst for usage on PyPI

requirements/doc.txt

@@ -1,84 +1,97 @@
 #
-# This file is autogenerated by pip-compile with python 3.8
-# To update, run:
+# This file is autogenerated by pip-compile with Python 3.10
+# by the following command:
 #
-#    make upgrade
+#    pip-compile --output-file=requirements/doc.txt requirements/doc.in
 #
-alabaster==0.7.12
+accessible-pygments==0.0.4
+    # via pydata-sphinx-theme
+alabaster==0.7.13
     # via sphinx
 asgiref==3.5.2
-    # via
-    #   -r requirements/test.txt
-    #   django
+    # via -r requirements/test.txt
 attrs==21.4.0
     # via
     #   -r requirements/test.txt
     #   pytest
-babel==2.10.3
-    # via sphinx
-bleach==5.0.1
+babel==2.12.1
+    # via
+    #   pydata-sphinx-theme
+    #   sphinx
+beautifulsoup4==4.12.0
+    # via pydata-sphinx-theme
+bleach==6.0.0
     # via readme-renderer
-certifi==2022.6.15
+certifi==2022.12.7
     # via requests
-charset-normalizer==2.0.12
+cffi==1.15.1
+    # via cryptography
+charset-normalizer==3.1.0
     # via requests
 click==8.1.3
     # via -r requirements/test.txt
-commonmark==0.9.1
-    # via rich
 coverage[toml]==6.4.1
     # via
     #   -r requirements/test.txt
     #   pytest-cov
-django==3.2.13
-    # via
-    #   -c https://raw.githubusercontent.com/edx/edx-lint/master/edx_lint/files/common_constraints.txt
-    #   -r requirements/test.txt
-doc8==0.11.2
+cryptography==40.0.1
+    # via secretstorage
+doc8==1.1.1
     # via -r requirements/doc.in
-docutils==0.18.1
+docutils==0.19
     # via
     #   doc8
+    #   pydata-sphinx-theme
     #   readme-renderer
     #   restructuredtext-lint
     #   sphinx
-edx-sphinx-theme==3.0.0
-    # via -r requirements/doc.in
-idna==3.3
+idna==3.4
     # via requests
-imagesize==1.3.0
+imagesize==1.4.1
     # via sphinx
-importlib-metadata==4.12.0
+importlib-metadata==6.1.0
     # via
     #   keyring
-    #   sphinx
     #   twine
 iniconfig==1.1.1
     # via
     #   -r requirements/test.txt
     #   pytest
+jaraco-classes==3.2.3
+    # via keyring
+jeepney==0.8.0
+    # via
+    #   keyring
+    #   secretstorage
 jinja2==3.1.2
     # via
     #   -r requirements/test.txt
     #   sphinx
-keyring==23.6.0
+keyring==23.13.1
     # via twine
+markdown-it-py==2.2.0
+    # via rich
 markupsafe==2.1.1
     # via
     #   -r requirements/test.txt
     #   jinja2
+mdurl==0.1.2
+    # via markdown-it-py
 mock==4.0.3
     # via -r requirements/test.txt
+more-itertools==9.1.0
+    # via jaraco-classes
 packaging==21.3
     # via
     #   -r requirements/test.txt
+    #   pydata-sphinx-theme
     #   pytest
     #   sphinx
 pbr==5.9.0
     # via
     #   -r requirements/test.txt
     #   stevedore
-pkginfo==1.8.3
+pkginfo==1.9.6
     # via twine
 pluggy==1.0.0
     # via
@@ -88,9 +101,15 @@ py==1.11.0
     # via
     #   -r requirements/test.txt
     #   pytest
-pygments==2.12.0
+pycparser==2.21
+    # via cffi
+pydata-sphinx-theme==0.13.1
+    # via sphinx-book-theme
+pygments==2.14.0
     # via
+    #   accessible-pygments
     #   doc8
+    #   pydata-sphinx-theme
     #   readme-renderer
     #   rich
     #   sphinx
@@ -107,42 +126,45 @@ pytest-cov==3.0.0
 python-slugify==6.1.2
     # via -r requirements/test.txt
 pytz==2022.1
-    # via
-    #   -r requirements/test.txt
-    #   babel
-    #   django
+    # via -r requirements/test.txt
 pyyaml==6.0
     # via -r requirements/test.txt
-readme-renderer==35.0
+readme-renderer==37.3
     # via twine
-requests==2.28.0
+requests==2.28.2
     # via
     #   requests-toolbelt
     #   sphinx
     #   twine
-requests-toolbelt==0.9.1
+requests-toolbelt==0.10.1
     # via twine
 restructuredtext-lint==1.4.0
     # via doc8
 rfc3986==2.0.0
     # via twine
-rich==12.4.4
+rich==13.3.3
     # via twine
+secretstorage==3.3.3
+    # via keyring
 six==1.16.0
-    # via
-    #   bleach
-    #   edx-sphinx-theme
+    # via bleach
 snowballstemmer==2.2.0
     # via sphinx
-sphinx==5.0.2
+soupsieve==2.4
+    # via beautifulsoup4
+sphinx==5.3.0
     # via
+    #   -c https://raw.githubusercontent.com/edx/edx-lint/master/edx_lint/files/common_constraints.txt
     #   -r requirements/doc.in
-    #   edx-sphinx-theme
-sphinxcontrib-applehelp==1.0.2
+    #   pydata-sphinx-theme
+    #   sphinx-book-theme
+sphinx-book-theme==1.0.0
+    # via -r requirements/doc.in
+sphinxcontrib-applehelp==1.0.4
     # via sphinx
 sphinxcontrib-devhelp==1.0.2
     # via sphinx
-sphinxcontrib-htmlhelp==2.0.0
+sphinxcontrib-htmlhelp==2.0.1
     # via sphinx
 sphinxcontrib-jsmath==1.0.1
     # via sphinx
@@ -151,9 +173,7 @@ sphinxcontrib-qthelp==1.0.3
 sphinxcontrib-serializinghtml==1.1.5
     # via sphinx
 sqlparse==0.4.2
-    # via
-    #   -r requirements/test.txt
-    #   django
+    # via -r requirements/test.txt
 stevedore==3.5.0
     # via
     #   -r requirements/test.txt
@@ -166,16 +186,15 @@ tomli==2.0.1
     # via
     #   -r requirements/test.txt
     #   coverage
+    #   doc8
     #   pytest
-twine==4.0.1
+twine==4.0.2
     # via -r requirements/doc.in
-typing-extensions==4.2.0
-    # via rich
-urllib3==1.26.9
+urllib3==1.26.15
     # via
     #   requests
     #   twine
 webencodings==0.5.1
     # via bleach
-zipp==3.8.0
+zipp==3.15.0
     # via importlib-metadata