Standardise make files (#35)

* Add sg_execution_times.rst to clean target in Makefile

* Allow chaining commands in make.bat

* Use make in CI

---------

Co-authored-by: niksirbi <niko.sirbiladze@gmail.com>

Author: lochhh

.github/workflows/docs_build_and_deploy.yml

@@ -31,6 +31,7 @@ jobs:
         with:
           python-version: "3.13"
           use-requirements-txt: false
+          use-make: true
           github-token: ${{ secrets.GITHUB_TOKEN }}
 
   deploy_sphinx_docs:
@@ -45,3 +46,4 @@ jobs:
       - uses: neuroinformatics-unit/actions/deploy_sphinx_docs@v2
         with:
           secret_input: ${{ secrets.GITHUB_TOKEN }}
+          use-make: true

docs/Makefile

@@ -19,6 +19,7 @@ clean:
 	rm -rf $(BUILDDIR)
 	rm -rf $(SOURCEDIR)/api_generated
 	rm -rf $(SOURCEDIR)/auto_examples
+	rm -f $(SOURCEDIR)/sg_execution_times.rst
 
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).

docs/make.bat

@@ -25,7 +25,20 @@ if errorlevel 9009 (
 
 if "%1" == "" goto help
 
-%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+:process_targets
+if "%1" == "clean" (
+	if exist "%BUILDDIR%" rmdir /s /q "%BUILDDIR%"
+	if exist "%SOURCEDIR%\api_generated" rmdir /s /q "%SOURCEDIR%\api_generated"
+	if exist "%SOURCEDIR%\auto_examples" rmdir /s /q "%SOURCEDIR%\auto_examples"
+	if exist "%SOURCEDIR%\sg_execution_times.rst" del /q "%SOURCEDIR%\sg_execution_times.rst"
+) else (
+	%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+	if errorlevel 1 goto end
+)
+
+shift
+if not "%1" == "" goto process_targets
+
 goto end
 
 :help