Merge pull request #114 from liuzhenqi77/fix-docs

Author: liuzhenqi77

docs/Makefile

@@ -18,7 +18,7 @@ clean:
 	rm -rf generated/
 
 html-noplot:
-	$(SPHINXBUILD) -D plot_gallery=0 -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	$(SPHINXBUILD) -D plot_gallery=0 -b html $(ALLSPHINXOPTS) $(SOURCEDIR) $(BUILDDIR)/html
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
 

docs/api.rst

@@ -84,10 +84,13 @@ Python Reference API
    :template: function.rst
    :toctree: generated/
 
+   sort_communities
    plot_mod_heatmap
    plot_conte69
-   plot_point_brain
+   plot_fslr
    plot_fsaverage
+   plot_fsvertex
+   plot_point_brain
 
 .. _ref_stats:
 
@@ -130,6 +133,7 @@ Python Reference API
 
    communicability_bin
    communicability_wei
+   rich_feeder_peripheral
 
 .. _ref_datasets:
 

docs/conf.py

@@ -15,7 +15,7 @@
 
 # Add project name, copyright holder, and author(s)
 project = 'netneurotools'
-copyright = '2018, netneurotools developers'
+copyright = '2018-2022, netneurotools developers'
 author = 'Network Neuroscience Lab'
 
 # Import project to get version info
@@ -62,7 +62,8 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+# https://github.com/sphinx-doc/sphinx/issues/10474
+# language = None
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -83,7 +84,9 @@
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-html_theme_options = {}
+html_theme_options = {
+    "navigation_depth": 3
+}
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
@@ -100,7 +103,7 @@
 
 # -- Extension configuration -------------------------------------------------
 intersphinx_mapping = {
-    'python': ('https://docs.python.org/3.6', None),
+    'python': ('https://docs.python.org/3', None),
     'matplotlib': ('https://matplotlib.org', None),
     'numpy': ('https://docs.scipy.org/doc/numpy', None),
     'scipy': ('https://docs.scipy.org/doc/scipy/reference', None),