Add doc builds to taskfile

mamba-org · Nov 13, 2023 · cd28d5c · cd28d5c
1 parent b129112
commit cd28d5c
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 4 deletions.
diff --git a/Taskfile.dist.yml b/Taskfile.dist.yml
@@ -10,6 +10,7 @@ vars:
   CMAKE_BUILD_DIR: '{{.BUILD_DIR}}/cmake'
   CMAKE_PRESET: 'mamba-unix-shared-debug-dev'
   CACHE_DIR: '{{.BUILD_DIR}}/pkgs'
+  DOCS_DIR: '{{.BUILD_DIR}}/doc'
   CPU_PERCENTAGE: 75
   CPU_COUNT:
     sh: >-
@@ -173,8 +174,10 @@ tasks:
       - cp "{{.BUILD_DIR}}/stubs/libmambapy/core/bindings-stubs/__init__.pyi" libmambapy/src/libmambapy/__init__.pyi
       - '{{.DEV_RUN}} pre-commit run --files libmambapy/src/libmambapy/__init__.pyi'
 
-  clean: 'rm -rf {{.BUILD_DIR}}'
+  build-docs:
+    deps: [create-dev-env]
+    cmds:
+      - '{{.DEV_RUN}} python -m sphinx -b html docs/source {{.DOCS_DIR}}'
 
-  clean-ci-caches: >-
-    gh api 'repos/{owner}/{repo}/actions/caches' --paginate --jq '.actions_caches[].id'
-    | xargs -I'{}' gh api -X DELETE 'repos/{owner}/{repo}/actions/caches/{}'
+
+  clean: 'rm -rf {{.BUILD_DIR}}'
diff --git a/dev/environment-dev.yml b/dev/environment-dev.yml
@@ -46,3 +46,7 @@ dependencies:
   - pybind11
   # dev dependencies
   - pre-commit
+  # Documentation dependencies
+  - sphinx
+  - sphinx-book-theme
+  - myst-parser