Enable running sphinx-build on Windows

.gitignore

@@ -5,8 +5,9 @@ __pycache__
 .hypothesis/
 
 # temp files from docs build
+doc/*.nc
 doc/auto_gallery
-doc/example.nc
+doc/rasm.zarr
 doc/savefig
 
 # C extensions
@@ -72,4 +73,3 @@ xarray/tests/data/*.grib.*.idx
 Icon*
 
 .ipynb_checkpoints
-doc/rasm.zarr

doc/conf.py

@@ -28,9 +28,9 @@
 print("python exec:", sys.executable)
 print("sys.path:", sys.path)
 
-if "conda" in sys.executable:
+if "CONDA_DEFAULT_ENV" in os.environ or "conda" in sys.executable:
     print("conda environment:")
-    subprocess.run(["conda", "list"])
+    subprocess.run([os.environ.get("CONDA_EXE", "conda"), "list"])
 else:
     print("pip environment:")
     subprocess.run([sys.executable, "-m", "pip", "list"])

doc/getting-started-guide/quick-overview.rst

@@ -218,6 +218,7 @@ You can directly read and write xarray objects to disk using :py:meth:`~xarray.D
     xr.open_dataset("example.nc")
 
 .. ipython:: python
+    :okexcept:
     :suppress:
 
     import os

doc/user-guide/dask.rst

@@ -148,6 +148,7 @@ A dataset can also be converted to a Dask DataFrame using :py:meth:`~xarray.Data
 Dask DataFrames do not support multi-indexes so the coordinate variables from the dataset are included as columns in the Dask DataFrame.
 
 .. ipython:: python
+    :okexcept:
     :suppress:
 
     import os

doc/user-guide/io.rst

@@ -487,6 +487,7 @@ and currently raises a warning unless ``invalid_netcdf=True`` is set:
     xr.open_dataarray("complex.nc", engine="h5netcdf")
 
 .. ipython:: python
+    :okexcept:
     :suppress:
 
     import os
@@ -727,6 +728,7 @@ This can be useful for generating indices of dataset contents to expose to
 search indices or other automated data discovery tools.
 
 .. ipython:: python
+    :okexcept:
     :suppress:
 
     import os

doc/user-guide/weather-climate.rst

@@ -221,6 +221,7 @@ For data indexed by a :py:class:`~xarray.CFTimeIndex` xarray currently supports:
     xr.open_dataset("example-no-leap.nc")
 
 .. ipython:: python
+    :okexcept:
     :suppress:
 
     import os

doc/whats-new.rst

@@ -38,6 +38,8 @@ Bug fixes
 Documentation
 ~~~~~~~~~~~~~
 
+- Enable building the documentation on Windows via `sphinx-build` (:pull:`6237`).
+  By `Stan West <https://github.com/stanwest>`_.
 
 Internal Changes
 ~~~~~~~~~~~~~~~~