Mercurial > p > roundup > code
view website/README.txt @ 4703:8e34362a14f7
issue2550774: Fix generating the website documentation
- the COPYING.txt file needs to be symlinked into website/www/ so the
documentation can be generated correctly
- add website/www/COPYING.txt to the .hgignore file so the symlinked version
does not get accidentally committed to the repository
- the website documentation Makefile 'clean' removes the symlinks and the
generated html to return things back to the original state, which is what
should happen on a 'clean'
| author | John Kristensen <john@jerrykan.com> |
|---|---|
| date | Sun, 16 Dec 2012 13:18:11 +1100 |
| parents | 0333f2b245a3 |
| children | 278f8bd1fc39 |
line wrap: on
line source
issues.roundup-tracker.org: * log into issues.roundup-tracker.org * get a working copy of roundup/website/issues from the SCM, either via hg clone http://roundup.hg.sourceforge.net:8000/hgroot/roundup/roundup or download a snapshot: http://roundup.hg.sourceforge.net/hgweb/roundup/roundup/archive/default.tar.gz * copy the files into the tracker instance, using sudo: sudo -u roundup cp <file> /home/roundup/trackers/roundup/... or use rsync to check and only copy the changes files as user roundup like rsync -rvc /home/YOURUSERID/roundup/website/issues/ trackers/roundup/ * restart the roundup server: sudo /etc/init.d/roundup restart [1] All services hosted on sf.net: * log into sf.net http://sourceforge.net/apps/trac/sourceforge/wiki/Shell%20service ssh -t <user>,roundup@shell.sourceforge.net create * set project_home: project_home=/home/project-web/roundup cd ${project_home} * read up on other people changes and add yours vim ${project_home}/logbuch.txt * update the working copy of the SCM roundup source (includes www and wiki) cd ${project_home}/src/roundup hg pull -u /home/scm_hg/r/ro/roundup/roundup (The warning about "Not trusting file /home/scm_hg/r/ro/roundup/roundup/.hg/hgrc from untrusted user" can be ignored.) www.roundup-tracker.org: * follow [1]. * activate the virtualenv . ${project_home}/docbuilder/bin/activate * go to the now current source directory cd ${project_home}/src/roundup/website/www * (build requirement: sphinx and the sphinxcontrib-cheeseshop plugin http://pypi.python.org/pypi/sphinxcontrib-cheeseshop) * build it make html * you may also "make clean" * install it cp -r ./html/* ${project_home}/htdocs/ or alternatively (leaving out the --dry-run later) rsync --dry-run -v --checksum --recursive ./html/* ${project_home}/htdocs/ (I think I can simplify the Makefile above such that the installation will be included as a make target.) wiki.roundup-tracker.org: * follow [1]. * go to the now current source directory cd ${project_home}/src/roundup/website/wiki * copy the files into the right places: cp static/roundup/* ${project_home}/htdocs/_wiki/ cp wiki/data/plugin/theme/roundup.py ${project_home}/persistent/wiki/data/plugin/theme/
