Add dash docset generation CI pipeline

Add CI job to create a dash docset and upload as an artifact.
Also make some slight tweaks to the docset itself, by specifying the
index page, and adding both 16x16, and 32x32 icons.

Author: j9ac9k

.github/workflows/main.yml

@@ -15,6 +15,26 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  make_dash_docset:
+    runs-on: macos-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Setup Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.x'
+    - name: Install Build Dependencies
+      run: |
+        python -m pip install --upgrade doc2dash setuptools -r doc/requirements.txt 
+    - name: Build docset
+      run: |
+        make -C doc dash
+    - run: tar --exclude='.DS_Store' -cvzf pyqtgraph.tgz doc/pyqtgraph.docset
+    - name: Upload docset
+      uses: actions/upload-artifact@v4
+      with:
+        name: pyqtgraph.docset
+        path: pyqtgraph.tgz
   run-mypy:
     runs-on: ubuntu-latest
     steps:

doc/Makefile

@@ -55,10 +55,11 @@ dash: clean
 	export BUILD_DASH_DOCSET=1;\
 	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/dash
 	doc2dash -n pyqtgraph\
+	 --index-page index.html\
 	 --online-redirect-url https://pyqtgraph.readthedocs.io/en/latest\
-	 --icon $(SOURCEDIR)/_static/peegee_03_square_no_bg_32_cleaned.png\
+	 --icon $(SOURCEDIR)/_static/docset-icon.png\
+	 --icon-2x $(SOURCEDIR)/_static/[email protected]\
 	 --force\
-	 -A\
 	 $(BUILDDIR)/dash
 	@echo
 

doc/source/_static/docset-icon.png

@@ -144,8 +144,8 @@
 
 # favicons
 favicons = [
-    "peegee_03_square_no_bg_32_cleaned.png",
-    "peegee_04_square_no_bg_180_cleaned.png",
+    "docset-icon.png",
+    "docset-icon@2x.png",
     "peegee_03_square_no_bg_32_cleaned.ico"
 ]
 
@@ -187,7 +187,6 @@
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
 # pixels large.
-# html_favicon = "_static/peegee_03_square_no_bg_32_cleaned.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,