Add codec categories in doc contents

zarr-developers · Aug 24, 2023 · 2c5dff1 · 2c5dff1
1 parent cb15543
commit 2c5dff1
Show file tree

Hide file tree

Showing 26 changed files with 46 additions and 30 deletions.
diff --git a/docs/Makefile b/docs/Makefile
@@ -8,11 +8,6 @@ PAPER         =
 BUILDDIR      = _build
 
 .PHONY: sphinx
-sphinx:
-	# User-friendly check for sphinx-build
-	ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
-		$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don\'t have Sphinx installed, grab it from http://sphinx-doc.org/)
-	endif
 
 # Internal variables.
 PAPEROPT_a4     = -D latex_paper_size=a4
@@ -230,4 +225,3 @@ dummy: sphinx
 	$(SPHINXBUILD) -b dummy $(ALLSPHINXOPTS) $(BUILDDIR)/dummy
 	@echo
 	@echo "Build finished. Dummy builder generates no files."
-
diff --git a/docs/checksum32.rst b/docs/checksum32.rst
@@ -1,5 +1,5 @@
-32-bit checksums
-================
+Checksum codecs
+===============
 .. automodule:: numcodecs.checksum32
 
 CRC32
@@ -37,7 +37,7 @@ JenkinsLookup3
 --------------
 
 .. autoclass:: JenkinsLookup3
-    
+
     .. autoattribute:: codec_id
     .. autoattribute:: initval
     .. autoattribute:: prefix

diff --git a/docs/blosc.rst → docs/compression/blosc.rst b/docs/blosc.rst → docs/compression/blosc.rst
diff --git a/docs/bz2.rst → docs/compression/bz2.rst b/docs/bz2.rst → docs/compression/bz2.rst
diff --git a/docs/gzip.rst → docs/compression/gzip.rst b/docs/gzip.rst → docs/compression/gzip.rst
diff --git a/docs/compression/index.rst b/docs/compression/index.rst
@@ -0,0 +1,14 @@
+Compression codecs
+------------------
+
+.. toctree::
+    :maxdepth: 2
+
+    blosc
+    lz4
+    zfpy
+    zstd
+    zlib
+    gzip
+    bz2
+    lzma
diff --git a/docs/lz4.rst → docs/compression/lz4.rst b/docs/lz4.rst → docs/compression/lz4.rst
diff --git a/docs/lzma.rst → docs/compression/lzma.rst b/docs/lzma.rst → docs/compression/lzma.rst
diff --git a/docs/zfpy.rst → docs/compression/zfpy.rst b/docs/zfpy.rst → docs/compression/zfpy.rst
diff --git a/docs/zlib.rst → docs/compression/zlib.rst b/docs/zlib.rst → docs/compression/zlib.rst
diff --git a/docs/zstd.rst → docs/compression/zstd.rst b/docs/zstd.rst → docs/compression/zstd.rst
diff --git a/docs/astype.rst → docs/filter/astype.rst b/docs/astype.rst → docs/filter/astype.rst
diff --git a/docs/bitround.rst → docs/filter/bitround.rst b/docs/bitround.rst → docs/filter/bitround.rst
diff --git a/docs/categorize.rst → docs/filter/categorize.rst b/docs/categorize.rst → docs/filter/categorize.rst
diff --git a/docs/delta.rst → docs/filter/delta.rst b/docs/delta.rst → docs/filter/delta.rst
diff --git a/docs/fixedscaleoffset.rst → docs/filter/fixedscaleoffset.rst b/docs/fixedscaleoffset.rst → docs/filter/fixedscaleoffset.rst
diff --git a/docs/filter/index.rst b/docs/filter/index.rst
@@ -0,0 +1,14 @@
+Filter codecs
+-------------
+
+.. toctree::
+    :maxdepth: 2
+
+    delta
+    fixedscaleoffset
+    quantize
+    bitround
+    packbits
+    categorize
+    astype
+    shuffle
diff --git a/docs/packbits.rst → docs/filter/packbits.rst b/docs/packbits.rst → docs/filter/packbits.rst
diff --git a/docs/quantize.rst → docs/filter/quantize.rst b/docs/quantize.rst → docs/filter/quantize.rst
diff --git a/docs/shuffle.rst → docs/filter/shuffle.rst b/docs/shuffle.rst → docs/filter/shuffle.rst
diff --git a/docs/index.rst b/docs/index.rst
@@ -64,29 +64,12 @@ Contents
 .. toctree::
     :maxdepth: 2
 
+    compression/index
+    filter/index
+    other/index
+    checksum32
     abc
     registry
-    blosc
-    lz4
-    zfpy
-    zstd
-    zlib
-    gzip
-    bz2
-    lzma
-    delta
-    fixedscaleoffset
-    quantize
-    bitround
-    packbits
-    categorize
-    checksum32
-    astype
-    json
-    pickles
-    msgpacks
-    vlen
-    shuffle
     release
     contributing
 

diff --git a/docs/other/index.rst b/docs/other/index.rst
@@ -0,0 +1,11 @@
+Other codecs
+------------
+
+
+.. toctree::
+    :maxdepth: 2
+
+    json
+    pickles
+    msgpacks
+    vlen
diff --git a/docs/json.rst → docs/other/json.rst b/docs/json.rst → docs/other/json.rst
diff --git a/docs/msgpacks.rst → docs/other/msgpacks.rst b/docs/msgpacks.rst → docs/other/msgpacks.rst
diff --git a/docs/pickles.rst → docs/other/pickles.rst b/docs/pickles.rst → docs/other/pickles.rst
diff --git a/docs/vlen.rst → docs/other/vlen.rst b/docs/vlen.rst → docs/other/vlen.rst