build: update website build to sync built files

Sourceforge only supports python 2.7. Newer version of sphinx are
required to build docs and they don't work with 2.7.

Set up rsync targets that:

  1) copy html build directory to sourceforge target directory
     (dev_docs, production and user home directory)
  2) backup existing sourceforge target directory re-sync so it
     can be served without any missing files.

The Makefile now check to see if .orig or *~ files are present in the
html build tree. It lists the garbage file and fails if so.

Also inserts a .htaccess into the tree to prevent access to:

  .buildinfo file
  docs_backup-* files
  *.orig
  *~

The first one is a build artifact from newer version of sphinx.

The second is the backup directory created with all the original files
before a rsync from the local system is done to sourceforge. The backup
directory is timestamped with the time of its sync.

The last two are probably redundant since make html will fail if they
exist.

To rollback a sync:

  move the target directory to a new name.

  move the backup directory (in the renamed target directory) to the
      old target directory name.

I added the --delete flag to remove files missing from the html
directory. Using the -no-times flags will create all new files with
the current directory. Using the --backup, --backup-dir flags backs up
all replaced/deleted files to backup-dir. The --exclude flag preserves
the backup directories on the sourceforge side. Without --exclude the
-delete flag would remove these backup-dir's. Note that
--delete-exclude must not be used otherwise the backup directories
will be deleted.

Author: rouilj

website/www/Makefile

@@ -35,6 +35,10 @@ html: docs
 	cp robots.txt html/robots.txt
 	mkdir html/signatures && cp signatures/*.asc html/signatures
 	cp --no-clobber -r docs/html_extra/. html/docs/.
+	cp htaccess html/.htaccess
+	@echo; \
+          l=$$(find html -name '*.orig' -o -name '*~' | tee /dev/tty | wc -l);\
+         if [ $$l -ne 0 ]; then echo "Garbage files found" && false; fi
 
 linkcheck:
 	mkdir -p $(TMP)/linkcheck $(TMP)/doctrees
@@ -44,8 +48,30 @@ linkcheck:
 	      "or in .build/linkcheck/output.txt."
 
 sourceforge_dev_sync:
-	rsync -av html/. web.sourceforge.net:/home/project-web/roundup/htdocs/dev_docs/.
+        # --no-times makes _images/* and other files sync over every time
+        # so docs_backup-... is complete with all files and can be served
+        # as the docs tree. Without --no-times _static, _images and other
+        # directories are missing from the backup directory.
+	# Exclude docs_backup so it won't be deleted from sourceforge
+	# since:
+        #   --delete-exclude
+        # IS NOT (and must not be) SET
+	read -p "sync to dev_docs y/N? " resp; echo "$$resp" | grep -i "^y"
+	rsync -av --no-times --delete --exclude 'docs_backup*' \
+              --backup --backup-dir docs_backup-`date --iso-8601=seconds` \
+              html/. \
+              web.sourceforge.net:/home/project-web/roundup/htdocs/dev_docs/.
 
 sourceforge_prod_sync:
 	read -p "sync to production y/N? " resp; echo "$$resp" | grep -i "^y"
-	rsync -av html/. web.sourceforge.net:/home/project-web/roundup/htdocs/.
+	rsync -av --no-times --delete --exclude 'docs_backup*' \
+              --backup --backup-dir docs_backup-`date --iso-8601=seconds` \
+              html/. \
+              web.sourceforge.net:/home/project-web/roundup/htdocs/.
+
+sourceforge_home_sync:
+	read -p "sync to home y/N? " resp; echo "$$resp" | grep -i "^y"
+	rsync -av --no-times --delete --exclude 'docs_backup*' \
+              --backup --backup-dir docs_backup-`date --iso-8601=seconds` \
+              html/. \
+              web.sourceforge.net:roundup_docs/.

website/www/htaccess

@@ -0,0 +1,4 @@
+RedirectMatch 404 /\.buildinfo$
+RedirectMatch 404 /docs_backup-.*
+RedirectMatch 404 \.orig$
+RedirectMatch 404 ~$