annotate website/README.txt @ 4770:278f8bd1fc39

Minor Documentation: of SF shell service access improved.
author Bernhard Reiter <bernhard@intevation.de>
date Thu, 07 Mar 2013 16:11:38 +0100
parents 0333f2b245a3
children 0173823161b2
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
4609
9ed905019303 website docs: Added link to Makefile and adapted the hg command needed for sf.
Bernhard Reiter <bernhard@intevation.de>
parents: 4608
diff changeset
26 hg pull -u /home/scm_hg/r/ro/roundup/roundup
4671
0333f2b245a3 website/README.txt: removed trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4666
diff changeset
27 (The warning about "Not trusting file
0333f2b245a3 website/README.txt: removed trailing spaces
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4666
diff changeset
28 /home/scm_hg/r/ro/roundup/roundup/.hg/hgrc from untrusted user"
4620
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
29 can be ignored.)
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
30
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
31 www.roundup-tracker.org:
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
32 * follow [1].
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
33 * activate the virtualenv
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
34 . ${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
35 * 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
36 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
37 * (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
38 http://pypi.python.org/pypi/sphinxcontrib-cheeseshop)
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
39 * 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
40 make html
4551
7cd19e56ae4c updates
Richard Jones <richard@users.sourceforge.net>
parents: 4442
diff changeset
41 * you may also "make clean"
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
42 * install it
4655
45157fd8ba52 Nicer rsync command for copying over the webpage contents.
Bernhard Reiter <bernhard@intevation.de>
parents: 4646
diff changeset
43 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
44 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
45 rsync --dry-run -v --checksum --recursive ./html/* ${project_home}/htdocs/
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
46
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
47 (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
48
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
49 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
50 * follow [1].
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
51 * 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
52 cd ${project_home}/src/roundup/website/wiki
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
53 * 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
54 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
55 cp wiki/data/plugin/theme/roundup.py ${project_home}/persistent/wiki/data/plugin/theme/

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