will require a bit of work esp because of use of notebooks in docs -- need to refresh my memory on how this works.
this is the session from the awkard-array, appears to avoid using make or Make.bat.
I've never used sphinx-build before.
@nox.session
def docs(session):
"""
Build the docs. Pass "serve" to serve.
"""
session.install(".[doc]")
session.run("sphinx-build", "-M", "html", ".", "_build")
if session.posargs:
if "serve" in session.posargs:
session.log("Launching docs at http://localhost:8000/ - use Ctrl-C to quit")
session.run("python", "-m", "http.server", "8000", "-d", "_build/html")
else:
session.error("Unsupported argument to docs")
will require a bit of work esp because of use of notebooks in docs -- need to refresh my memory on how this works.
this is the session from the awkard-array, appears to avoid using
make
orMake.bat
. I've never usedsphinx-build
before.