annotate website/README.txt @ 4830:10f8b944e60c

website: now update command is just 'hg pull -u'
author anatoly techtonik <techtonik@gmail.com>
date Mon, 16 Sep 2013 15:49:19 +0300
parents ccfb6c72ebe2
children 8930fe9d6d21
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
1 issues.roundup-tracker.org:
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
2
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
3 * log into issues.roundup-tracker.org
4598
5c8463b8f7ba Updated README for maintaining the websites (www, wiki, issues)
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4554
diff changeset
4 * get a working copy of roundup/website/issues from the SCM, either via
5c8463b8f7ba Updated README for maintaining the websites (www, wiki, issues)
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4554
diff changeset
5 hg clone http://roundup.hg.sourceforge.net:8000/hgroot/roundup/roundup
5c8463b8f7ba Updated README for maintaining the websites (www, wiki, issues)
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4554
diff changeset
6 or download a snapshot:
5c8463b8f7ba Updated README for maintaining the websites (www, wiki, issues)
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4554
diff changeset
7 http://roundup.hg.sourceforge.net/hgweb/roundup/roundup/archive/default.tar.gz
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
8 * copy the files into the tracker instance, using sudo:
4598
5c8463b8f7ba Updated README for maintaining the websites (www, wiki, issues)
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4554
diff changeset
9 sudo -u roundup cp <file> /home/roundup/trackers/roundup/...
4646
cd81ebbce7f9 Minor improvement to the instructions how to maintain our tracker.
Bernhard Reiter <bernhard@intevation.de>
parents: 4620
diff changeset
10 or use rsync to check and only copy the changes files as user roundup like
cd81ebbce7f9 Minor improvement to the instructions how to maintain our tracker.
Bernhard Reiter <bernhard@intevation.de>
parents: 4620
diff changeset
11 rsync -rvc /home/YOURUSERID/roundup/website/issues/ trackers/roundup/
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
12 * restart the roundup server:
4646
cd81ebbce7f9 Minor improvement to the instructions how to maintain our tracker.
Bernhard Reiter <bernhard@intevation.de>
parents: 4620
diff changeset
13 sudo /etc/init.d/roundup restart
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
14
4620
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
15 [1] All services hosted on sf.net:
4770
278f8bd1fc39 Minor Documentation: of SF shell service access improved.
Bernhard Reiter <bernhard@intevation.de>
parents: 4671
diff changeset
16 * log into sf.net (Generic sf instructions can be found here:
278f8bd1fc39 Minor Documentation: of SF shell service access improved.
Bernhard Reiter <bernhard@intevation.de>
parents: 4671
diff changeset
17 http://sourceforge.net/apps/trac/sourceforge/wiki/Shell%20service )
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
18 ssh -t <user>,roundup@shell.sourceforge.net create
4551
7cd19e56ae4c updates
Richard Jones <richard@users.sourceforge.net>
parents: 4442
diff changeset
19 * set project_home:
7cd19e56ae4c updates
Richard Jones <richard@users.sourceforge.net>
parents: 4442
diff changeset
20 project_home=/home/project-web/roundup
4554
4509e2df25c0 have now set up a virtualenv with the goodies in it so use that
Richard Jones <richard@users.sourceforge.net>
parents: 4551
diff changeset
21 cd ${project_home}
4620
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
22 * read up on other people changes and add yours
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
23 vim ${project_home}/logbuch.txt
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
24 * update the working copy of the SCM roundup source (includes www and wiki)
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
25 cd ${project_home}/src/roundup
4830
10f8b944e60c website: now update command is just 'hg pull -u'
anatoly techtonik <techtonik@gmail.com>
parents: 4780
diff changeset
26 hg pull -u
4780
ccfb6c72ebe2 updated warning text in website/README.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4776
diff changeset
27 (The warning about "Not trusting file /home/hg/p/roundup/code/.hg/hgrc
ccfb6c72ebe2 updated warning text in website/README.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4776
diff changeset
28 from untrusted user" can be ignored.)
4771
0173823161b2 Minor documentation: hints for shell access and wiki.
Bernhard Reiter <bernhard@intevation.de>
parents: 4770
diff changeset
29 * When done working in the shell, you can destroy it early to free resources:
0173823161b2 Minor documentation: hints for shell access and wiki.
Bernhard Reiter <bernhard@intevation.de>
parents: 4770
diff changeset
30 shutdown
4620
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
31
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
32 www.roundup-tracker.org:
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
33 * follow [1].
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
34 * activate the virtualenv
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
35 . ${project_home}/docbuilder/bin/activate
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
36 * go to the now current source directory
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
37 cd ${project_home}/src/roundup/website/www
4666
b247d334dc03 Website Build instructions: added a hint for sphinxcontrib-cheeseshop.
Bernhard Reiter <bernhard@intevation.de>
parents: 4655
diff changeset
38 * (build requirement: sphinx and the sphinxcontrib-cheeseshop plugin
b247d334dc03 Website Build instructions: added a hint for sphinxcontrib-cheeseshop.
Bernhard Reiter <bernhard@intevation.de>
parents: 4655
diff changeset
39 http://pypi.python.org/pypi/sphinxcontrib-cheeseshop)
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
40 * build it
4554
4509e2df25c0 have now set up a virtualenv with the goodies in it so use that
Richard Jones <richard@users.sourceforge.net>
parents: 4551
diff changeset
41 make html
4551
7cd19e56ae4c updates
Richard Jones <richard@users.sourceforge.net>
parents: 4442
diff changeset
42 * you may also "make clean"
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
43 * install it
4655
45157fd8ba52 Nicer rsync command for copying over the webpage contents.
Bernhard Reiter <bernhard@intevation.de>
parents: 4646
diff changeset
44 cp -r ./html/* ${project_home}/htdocs/
45157fd8ba52 Nicer rsync command for copying over the webpage contents.
Bernhard Reiter <bernhard@intevation.de>
parents: 4646
diff changeset
45 or alternatively (leaving out the --dry-run later)
45157fd8ba52 Nicer rsync command for copying over the webpage contents.
Bernhard Reiter <bernhard@intevation.de>
parents: 4646
diff changeset
46 rsync --dry-run -v --checksum --recursive ./html/* ${project_home}/htdocs/
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
47
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
48 (I think I can simplify the Makefile above such that the installation will be included as a make target.)
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
49
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
50 wiki.roundup-tracker.org:
4620
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
51 * follow [1].
4771
0173823161b2 Minor documentation: hints for shell access and wiki.
Bernhard Reiter <bernhard@intevation.de>
parents: 4770
diff changeset
52 * the main wiki configuration is here
0173823161b2 Minor documentation: hints for shell access and wiki.
Bernhard Reiter <bernhard@intevation.de>
parents: 4770
diff changeset
53 vim persistent/wiki/wikiconfig.py
4620
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
54 * go to the now current source directory
4598
5c8463b8f7ba Updated README for maintaining the websites (www, wiki, issues)
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4554
diff changeset
55 cd ${project_home}/src/roundup/website/wiki
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
56 * copy the files into the right places:
4598
5c8463b8f7ba Updated README for maintaining the websites (www, wiki, issues)
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4554
diff changeset
57 cp static/roundup/* ${project_home}/htdocs/_wiki/
5c8463b8f7ba Updated README for maintaining the websites (www, wiki, issues)
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4554
diff changeset
58 cp wiki/data/plugin/theme/roundup.py ${project_home}/persistent/wiki/data/plugin/theme/

Roundup Issue Tracker: http://roundup-tracker.org/