Mercurial > p > roundup > code
diff website/www/Makefile @ 8044:f9eaaa63fda2
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 | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Wed, 26 Jun 2024 19:11:35 -0400 |
| parents | 2ab234484708 |
| children | 6d4b5005abf2 |
line wrap: on
line diff
--- a/website/www/Makefile Tue Jun 25 12:10:14 2024 -0400 +++ b/website/www/Makefile Wed Jun 26 19:11:35 2024 -0400 @@ -35,6 +35,10 @@ 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 @@ "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/.