Various small fixes to the docs (#1261)

Author: maximlt

.github/workflows/docs.yaml

@@ -34,33 +34,19 @@ jobs:
       MOZ_HEADLESS: 1
       DISPLAY: ":99.0"
     steps:
-      - uses: actions/checkout@v3
+      - uses: holoviz-dev/holoviz_tasks/install@v0.1a19
         with:
-          fetch-depth: "100"
-      - uses: conda-incubator/setup-miniconda@v2
-        with:
-          mamba-version: "*"
-          channels: pyviz/label/dev,conda-forge
-      - name: Fetch unshallow
-        run: git fetch --prune --tags --unshallow -f
+          name: Documentation
+          python-version: "3.11"
+          channels: pyviz,conda-forge,nodefaults
+          envs: "-o doc -o examples"
+          cache: true
+          conda-update: true
       - name: Set and echo git ref
         id: vars
         run: |
           echo "Deploying from ref ${GITHUB_REF#refs/*/}"
           echo "tag=${GITHUB_REF#refs/*/}" >> $GITHUB_OUTPUT
-      - name: conda setup
-        run: |
-          conda config --remove channels defaults
-          conda create -n test-environment python=3.8 pyctdev
-      - name: doit develop_install
-        run: |
-          conda activate test-environment
-          conda list
-          doit develop_install -o doc -o examples --conda-mode=mamba
-      - name: doit env_capture
-        run: |
-          conda activate test-environment
-          doit env_capture
       - name: bokeh sampledata
         run: |
           conda activate test-environment

.gitignore

@@ -107,6 +107,8 @@ ENV/
 doc/**/*.rst
 doc/**/*.ipynb
 doc/**/*.json
+# thumbnails are downloaded on the fly
+doc/reference/*/thumbnails/
 # this dir contains the whole website and should not be checked in on main
 builtdocs/
 # mystnb

.pre-commit-config.yaml

@@ -4,11 +4,11 @@
 default_stages: [commit]
 repos:
 -   repo: https://github.com/nbQA-dev/nbQA
-    rev: 1.6.3
+    rev: 1.7.1
     hooks:
     -   id: nbqa-flake8
 -   repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.3.0
+    rev: v4.5.0
     hooks:
     -   id: check-builtin-literals
     -   id: check-case-conflict
@@ -20,13 +20,13 @@ repos:
         exclude: (\.min\.js$|\.svg$)
     -   id: trailing-whitespace
 -   repo: https://github.com/PyCQA/flake8
-    rev: 4.0.1
+    rev: 7.0.0
     hooks:
     -   id: flake8  # See 'setup.cfg' for args
         args: [hvplot]
         files: hvplot/
 -   repo: https://github.com/hoxbro/clean_notebook
-    rev: v0.1.10
+    rev: v0.1.14
     hooks:
     - id: clean-notebook
 -   repo: https://github.com/codespell-project/codespell

examples/assets/diagram.svg renamed to doc/assets/diagram.svg

@@ -15,6 +15,8 @@
 version = release  = base_version(hvplot.__version__)
 nbbuild_cell_timeout = 600
 
+exclude_patterns = ['governance']
+
 html_static_path += ['_static']
 
 html_css_files += [
@@ -75,6 +77,7 @@
             ]
         }
     },
+    'thumbnail_url': 'https://assets.holoviz.org/hvplot/thumbnails',
 }
 
 nbsite_analytics = {

examples/assets/streamz_demo.gif renamed to doc/assets/streamz_demo.gif

@@ -310,7 +310,7 @@ align: center
 
 **`.interactive()` to turn data pipelines into widget-based interactive applications**
 
-By starting a data pipeline with [`.interactive()`](getting_started/interactive.html) you can then inject widgets into an extract and transform data pipeline. The pipeline output dynamically updates with widget changes, making data exploration in Jupyter notebooks in particular a lot more efficient.
+By starting a data pipeline with [`.interactive()`](./getting_started/interactive) you can then inject widgets into an extract and transform data pipeline. The pipeline output dynamically updates with widget changes, making data exploration in Jupyter notebooks in particular a lot more efficient.
 
 ::::{tab-set}