[pre-commit] Add sphinx local pre-commit hook

This will run sphinx the same way as in the CI.

.pre-commit-config.yaml

@@ -22,3 +22,21 @@ repos:
     hooks:
       - id: bandit
         exclude: beat/editor/test
+  - repo: local
+    hooks:
+      - id: sphinx-build
+        name: sphinx build
+        entry: python -m sphinx.cmd.build
+        args: [-a, -E, -W, doc, sphinx]
+        language: system
+        files: ^doc/
+        types: [file]
+        pass_filenames: false
+      - id: sphinx-doctest
+        name: sphinx doctest
+        entry: python -m sphinx.cmd.build
+        args: [-a, -E, -b, doctest, doc, sphinx]
+        language: system
+        files: ^doc/
+        types: [file]
+        pass_filenames: false