Build docs with Cython 3.0

doc_requirements.txt

@@ -0,0 +1,6 @@
+cython>=3.0.0b1
+wheel
+setuptools
+mkdocstrings[python]
+mike
+mkdocs-material

docs/stylesheets/extra.css

@@ -0,0 +1,4 @@
+/* Maximum space for text block */
+.md-grid {
+  max-width: 70%; 
+}

mkdocs.yml

@@ -10,8 +10,10 @@ plugins:
         options:
           filters: ["!^_"]
           docstring_style: sphinx
-          show_signature: false
+          show_signature: true
           show_root_heading: true
 extra:
   version:
-    provider: mike
+    provider: mike
+extra_css:
+  - stylesheets/extra.css

scripts/builddocs.sh

@@ -1,24 +1,5 @@
 #!/bin/bash
-#set -e
 
-###########################################
-# Build the docs and push to GitHub Pages #
-###########################################
-
-# Build docs for all jobs within build
-pip$PYTHON install Sphinx>=1.1
-make BUILDDIR=/root/docs -C /pyslurm/doc/ html
-
-# Only push to GitHub Pages once per build
-if [[ "$PYTHON" == "2.7"     &&
-      "$CYTHON" == "0.27.3"  &&
-      "$SLURM"  == "17.11.8" &&
-      "$BRANCH" == "master"  ]]
-then
-    git clone https://github.com/pyslurm/pyslurm.github.io.git
-    rsync -av --delete --exclude=.git /root/docs/html/ /pyslurm.github.io/
-    cd pyslurm.github.io
-    git add .
-    git -c user.name="Travis" -c user.email="Travis" commit -m 'Updated docs'
-    git push -q https://giovtorres:$GITHUB_TOKEN@github.com/pyslurm/pyslurm.github.io &2>/dev/null
-fi
+pip install -r doc_requirements.txt
+pip install --no-build-isolation -e .
+mkdocs build

setup.cfg

@@ -1,7 +1,3 @@
-[aliases]
-doc=build_sphinx
-docs=build_sphinx
-
 [bdist_rpm]
 release = 1
 packager = Giovanni Torres <giovtorres@users.noreply.github.com>
@@ -13,17 +9,6 @@ build_requires = python3-devel >= 3.6
 requires = slurm
 use_bzip2 = 1
 
-[build_sphinx]
-builder = man
-source-dir = doc/source
-build-dir  = doc/build
-all_files  = 1
-
-[options.extras_require]
-docs =  mkdocstrings[python]
-        mkdocs-material
-        mike
-
 [flake8]
 max-line-length = 88
 extend-ignore = E203