使用 dirhtml

Author: FeignClaims

.github/workflows/deploy_github_pages.yml

@@ -21,7 +21,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v5.0.0
         with:
-          python-version: "3.11"
+          python-version: '3.11'
 
       - name: Checkout sources
         uses: actions/checkout@v4.1.1
@@ -39,17 +39,17 @@ jobs:
       - name: Replace question-board.readthedocs.io/ to feignclaims.github.io/question_board/
         uses: jacobtomlinson/gha-find-replace@v3
         with:
-          include: "main/conf.py"
+          include: 'main/conf.py'
           find: '"https://question-board.readthedocs.io/"'
           replace: '"https://feignclaims.github.io/question_board/"'
           regex: false
 
       - name: Show mirror website
         uses: jacobtomlinson/gha-find-replace@v3
         with:
-          include: "main/index.rst"
-          find: "`本网站的国外备用网址 (不支持搜索) <https://feignclaims.github.io/vscode_cpp_starter/>`_"
-          replace: "`本网站的国外主网址 (支持搜索) <https://vscode-cpp-starter.readthedocs.io/>`_"
+          include: 'main/index.rst'
+          find: '`本网站的国外备用网址 (不支持搜索) <https://feignclaims.github.io/vscode_cpp_starter/>`_'
+          replace: '`本网站的国外主网址 (支持搜索) <https://vscode-cpp-starter.readthedocs.io/>`_'
           regex: false
 
       - name: Install sphinx
@@ -61,24 +61,24 @@ jobs:
         shell: bash
         run: |
           rm -rf github_docs/build
-          sphinx-build main github_docs/build
+          sphinx-build -b dirhtml main github_docs/build
 
       - name: Commit changes
         uses: EndBug/add-and-commit@v9.1.3
         with:
           cwd: github_docs
-          commit: "--amend"
-          push: "--force"
+          commit: '--amend'
+          push: '--force'
           default_author: github_actions
-          message: "[bot] Build github pages"
+          message: '[bot] Build github pages'
 
       - name: Setup Github Pages
         uses: actions/configure-pages@v5
 
       - name: Upload Github Artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: "github_docs/build"
+          path: 'github_docs/build'
 
       - name: Build Github Pages
         uses: actions/deploy-pages@v4