Pull rewuest

.black.toml

@@ -0,0 +1,3 @@
+[tool.black]
+line-length = 79
+target-version = ["py38", "py39", "py39", "py310", "py311", "py312", "py313"]

.browserslistrc

@@ -1,6 +1,13 @@
 # Browsers that we support
 
+>0.25%
+last 3 versions
 defaults
-not IE 11
-not last 0 OperaMini version
-not last 0 OperaMobile version
+not Android < 5
+not Edge < 19
+not KaiOS < 3
+not OperaMini all
+not OperaMobile < 13
+not QQAndroid >= 0
+not UCAndroid >= 0
+not dead

.codespellrc

@@ -3,5 +3,6 @@ builtin = clear,rare,informal,code,names
 check-filenames =
 check-hidden =
 enable-colors =
-ignore-words-list = sur
+ignore-words-list = jupyter,lite,sur
+quiet-level = 32
 skip = .codespellrc,.gitattributes

.flake8

@@ -1,4 +1,6 @@
 [flake8]
-ignore = E123, W504
+count = True
+ignore = E123, E203, W504
 max-doc-length = 79
 max-complexity = 15
+jobs = 1

.git-blame-ignore-revs

@@ -0,0 +1,3 @@
+# Blacken scripts
+
+9e75d1834b30a486e6b8d0a011be43b587e8cd2d

.github/ISSUE_TEMPLATE.md

@@ -1,8 +1,9 @@
+# Issue Report
+
 <!--- **PLEASE NOTE:** This is the issue tracker for Spyder's documentation, not problems with the Spyder application itself nor general help with Spyder. For that, please see the main Spyder repo: <https://github.com/spyder-ide/spyder> . --->
 
 <!--- Please make sure you fill out this template completely so we can find and fix your issue. Otherwise, it may be closed. Thanks! --->
 
-# Issue Report
 
 ## Issue Description
 
@@ -35,7 +36,7 @@
     * [ ] Spyder 3 (``3.x``, frozen)
 
 
-* Are you planning on submitting a Github pull request with a suitable change?
+* Are you planning on submitting a GitHub pull request with a suitable change?
 
     * [ ] Yes
     * [ ] No

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,7 +1,8 @@
+# Pull Request
+
 <!--- Before submitting your pull request, --->
 <!--- please complete as much as possible of the following checklist: --->
 
-# Pull Request
 
 ## Pull Request Checklist
 

.github/workflows/build.yaml

@@ -1,6 +1,4 @@
-# Build the docs to test that they work correctly
-# Based on https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
-
+# Build the site and deploy it to GitHub pages
 name: Build
 
 on:  # yamllint disable-line rule:truthy
@@ -17,27 +15,47 @@ on:  # yamllint disable-line rule:truthy
     - '*.*'
     - 'staging*'
 
+permissions:
+  contents: write
+
 jobs:
   build:
-    name: Build Docs
+    name: Build and Deploy
 
     runs-on: ubuntu-latest
 
+    env:
+      IS_DEPLOY: ${{ (github.event_name == 'push' && '1') || '0' }}
+      IS_STAGING: ${{ (github.ref == 'refs/heads/staging' && '1') || '0' }}
+      IS_MAIN: ${{ ((github.ref == 'refs/heads/main' || github.ref == 'refs/heads/master') && '1') || '0' }}
+
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v3
-      with:
-        fetch-depth: 0
+      uses: actions/checkout@v4
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
-        python-version: '3.9'
+        python-version: '3.11'
     - name: Install dependencies
       shell: bash
       run: ./ci/install.sh
     - name: List dependencies
       shell: bash
-      run: pip list
-    - name: Build with Sphinx
+      run: |
+        echo $IS_DEPLOY
+        echo $IS_PROD
+        echo $IS_MAIN
+        pip list
+    - name: Build site
       shell: bash
       run: ./ci/build.sh
+    - name: Postprocess site
+      shell: bash
+      run: nox -s prepare-multiversion
+    - name: Deploy to GitHub Pages
+      if: env.IS_DEPLOY == '1'
+      uses: JamesIves/github-pages-deploy-action@v4
+      with:
+        folder: ./doc/_build/html
+        clean: false  # Don't remove files from other branches
+        dry-run: ${{ (env.IS_STAGING == '1' && 'true') || 'false' }}

.github/workflows/check.yaml

@@ -1,40 +1,45 @@
 # Build the docs and run checks on them
-# Based on https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
 
 name: Check
 
 on:  # yamllint disable-line rule:truthy
+  schedule:
+  - cron: '49 18 * * 5'  # 18:49 UTC every Friday, to avoid GHA load spikes
+
   push:
     branches:
     - master
     - main
     - '*.*'
     - 'staging*'
+
   pull_request:
     branches:
     - master
     - main
     - '*.*'
     - 'staging*'
 
+  workflow_dispatch:  # yamllint disable-line rule:empty-values
+
 jobs:
   check:
-    name: Check Docs
+    name: Check Links
 
     runs-on: ubuntu-latest
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
-        python-version: '3.9'
+        python-version: '3.11'
     - name: Install dependencies
       shell: bash
       run: ./ci/install.sh
     - name: List dependencies
       shell: bash
       run: pip list
     - name: Run Linkcheck
-      run: make linkcheck
+      run: nox -s linkcheck

.github/workflows/lint.yaml

@@ -23,16 +23,10 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
-        python-version: '3.9'
-    - name: Install dependencies
-      shell: bash
-      run: ./ci/install.sh
-    - name: List dependencies
-      shell: bash
-      run: pip list
-    - name: Run Pre-Commit hooks
-      uses: pre-commit/action@v3.0.0
+        python-version: '3.11'
+    - name: Run pre-commit hooks
+      uses: pre-commit/action@v3.0.1

.gitignore

@@ -40,7 +40,6 @@ develop-eggs/
 dist/
 downloads/
 eggs/
-lib/
 lib64/
 MANIFEST
 parts/