소스 검색

Update Sphinx version

Hana - Piralein 9 달 전
부모
커밋
70f703a6c8
4개의 변경된 파일15개의 추가작업 그리고 30개의 파일을 삭제
  1. 1 1
      .github/workflows/ci.yml
  2. 0 6
      _static/css/algolia.css
  3. 6 8
      conf.py
  4. 8 15
      requirements.txt

+ 1 - 1
.github/workflows/ci.yml

@@ -10,7 +10,7 @@ concurrency:
 
 
 jobs:
 jobs:
   build:
   build:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     steps:
     steps:
       - name: Checkout
       - name: Checkout
         uses: actions/checkout@v4
         uses: actions/checkout@v4

+ 0 - 6
_static/css/algolia.css

@@ -1,6 +0,0 @@
-.wy-nav-side { overflow: visible; }
-.wy-side-scroll { overflow-x: inherit; }
-
-.algolia-autocomplete {
-    display: block !important;
-}

+ 6 - 8
conf.py

@@ -9,7 +9,7 @@ import os
 
 
 # -- General configuration ------------------------------------------------
 # -- General configuration ------------------------------------------------
 
 
-needs_sphinx = "1.3"
+needs_sphinx = "8.1"
 
 
 # Sphinx extension module names and templates location
 # Sphinx extension module names and templates location
 sys.path.append(os.path.abspath("_extensions"))
 sys.path.append(os.path.abspath("_extensions"))
@@ -63,6 +63,9 @@ if not on_rtd:
 
 
 # Specify the site name for the Open Graph extension.
 # Specify the site name for the Open Graph extension.
 ogp_site_name = "Godot Engine documentation"
 ogp_site_name = "Godot Engine documentation"
+ogp_social_cards = {
+    "enable": False
+}
 
 
 if not os.getenv("SPHINX_NO_GDSCRIPT"):
 if not os.getenv("SPHINX_NO_GDSCRIPT"):
     extensions.append("gdscript")
     extensions.append("gdscript")
@@ -158,7 +161,6 @@ highlight_language = "gdscript"
 # -- Options for HTML output ----------------------------------------------
 # -- Options for HTML output ----------------------------------------------
 
 
 html_theme = "sphinx_rtd_theme"
 html_theme = "sphinx_rtd_theme"
-html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 if on_rtd:
 if on_rtd:
     using_rtd_theme = True
     using_rtd_theme = True
 
 
@@ -168,8 +170,6 @@ html_theme_options = {
     "logo_only": True,
     "logo_only": True,
     # Collapse navigation (False makes it tree-like)
     # Collapse navigation (False makes it tree-like)
     "collapse_navigation": False,
     "collapse_navigation": False,
-    # Hide the documentation version name/number under the logo
-    "display_version": False,
 }
 }
 
 
 html_title = supported_languages[language] % ( "(" + version + ")" )
 html_title = supported_languages[language] % ( "(" + version + ")" )
@@ -207,16 +207,14 @@ html_extra_path = ["robots.txt"]
 # These paths are either relative to html_static_path
 # These paths are either relative to html_static_path
 # or fully qualified paths (e.g. https://...)
 # or fully qualified paths (e.g. https://...)
 html_css_files = [
 html_css_files = [
-    'css/algolia.css',
-    'https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css',
-    "css/custom.css?10", # Increment the number at the end when the file changes to bust the cache.
+    "css/custom.css",
 ]
 ]
 
 
 if not on_rtd:
 if not on_rtd:
     html_css_files.append("css/dev.css")
     html_css_files.append("css/dev.css")
 
 
 html_js_files = [
 html_js_files = [
-    "js/custom.js?7", # Increment the number at the end when the file changes to bust the cache.
+    "js/custom.js",
 ]
 ]
 
 
 # Output file base name for HTML help builder
 # Output file base name for HTML help builder

+ 8 - 15
requirements.txt

@@ -3,29 +3,22 @@
 # https://github.com/readthedocs/readthedocs.org/blob/master/requirements/docs.txt
 # https://github.com/readthedocs/readthedocs.org/blob/master/requirements/docs.txt
 
 
 # Base dependencies
 # Base dependencies
-pygments==2.15.1
+pygments==2.18.0
 
 
 # Sphinx base and RTD theme.
 # Sphinx base and RTD theme.
-sphinx==4.4.0
-sphinx_rtd_theme==1.1.1
+sphinx==8.1.3
+sphinx_rtd_theme==3.0.1
 
 
 # Sphinx extensions.
 # Sphinx extensions.
 
 
 # Code tabs extension to display codeblocks in different languages as tabs.
 # Code tabs extension to display codeblocks in different languages as tabs.
-sphinx-tabs==3.4.0
+sphinx-tabs==3.4.7
 # Adds a 'copy' button to the right of codeblocks.
 # Adds a 'copy' button to the right of codeblocks.
-sphinx-copybutton==0.5.1
+sphinx-copybutton==0.5.2
 # Custom 404 error page (more useful than the default).
 # Custom 404 error page (more useful than the default).
-sphinx-notfound-page==0.8.3
+sphinx-notfound-page==1.0.4
 # Adds Open Graph tags in the HTML `<head>` tag.
 # Adds Open Graph tags in the HTML `<head>` tag.
-sphinxext-opengraph==0.7.5
-
-# These get pulled in by Sphinx, we need to pin these as higher versions require Sphinx 5.0+.
-sphinxcontrib-applehelp==1.0.4
-sphinxcontrib-htmlhelp==2.0.1
-sphinxcontrib-qthelp==1.0.3
-sphinxcontrib-serializinghtml==1.1.5
-sphinxcontrib-devhelp==1.0.2
+sphinxext-opengraph==0.9.1
 
 
 # `.. video::` directive support to embed videos in documentation pages.
 # `.. video::` directive support to embed videos in documentation pages.
-sphinxcontrib-video==0.2.1rc0
+sphinxcontrib-video==0.2.1