[doc] update doc build workflow

.github/workflows/build_sphinx_doc.yml

@@ -0,0 +1,33 @@
+name: sphinx build doc html
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build-html:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python
+        uses: actions/setup-python@v3
+        with:
+          python-version: '3.9'
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r sgio/docs/requirements.txt
+      - name: Build HTML
+        run: |
+          cd sgio/docs
+          make html
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          publish_branch: gh-pages
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs/_build/html
+          force_orphan: true

docs/requirements.txt

@@ -0,0 +1,9 @@
+sphinx
+sphinx-comments
+sphinx-sitemap
+sphinx-design
+sphinx-gallery
+pydata-sphinx-theme
+sphinx-prompt
+sphinx-copybutton
+myst-parser

docs/source/conf.py

@@ -53,7 +53,8 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'sphinx_book_theme'
+# html_theme = 'sphinx_book_theme'
+html_theme = 'pydata_sphinx_theme'
 
 # 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,