docs/Makefile: Fix local build of global swh documentation

It can be convenient to run the global swh documentation in the
current venv instead of using tox (notably to save time by skipping
dependencies installation).

It looks like the Makefile in docs folder was not really maintained
regarding that kind of documentation build so fix it in order to
restore local build.

docs/Makefile

@@ -25,6 +25,7 @@ html: sphinx/html
 sphinx/html: links-stamp apidoc-stamp images-stamp rec-build-stamp
 
 links-stamp:
+	mkdir -p sources/swh
 	bin/ln-sphinx-subprojects
 	touch $@
 

docs/bin/ln-sphinx-subprojects

@@ -10,6 +10,9 @@ create_links () {
         if [ ! -e "$pymodule" -a -d "../../${pymodule}/docs" ] ; then
             ln -s "../../${pymodule}/docs" "$pymodule"
         fi
+        if [ -d "../../${pymodule}/swh" ] ; then
+            cp -r -f --symbolic-link $(realpath ../../${pymodule}/swh/*) sources/swh/
+        fi
     done
 }
 
@@ -22,6 +25,7 @@ remove_links () {
             rm "$pymodule"
         fi
     done
+    rm -rf sources/swh/
 }
 
 if [ "$1" = "--remove" ] ; then

swh/docs/sphinx/conf.py

@@ -85,6 +85,9 @@ exclude_patterns = [
     "swh-icinga-plugins/index.rst",
     "swh.loader.cvs.rcsparse.setup.rst",
     "apidoc/swh.loader.cvs.rcsparse.setup.rst",
+    "**/swh/lister/maven/README.md",
+    "**/swh/loader/cvs/cvs2gitdump/README.md",
+    "**/swh/web/tests/resources/contents/code/extensions/test.md",
 ]
 
 # The name of the Pygments (syntax highlighting) style to use.