annotate website/README.txt @ 4777:276bcbd1f4e4

Website: Its 2013 now.
author Bernhard Reiter <bernhard@intevation.de>
date Thu, 28 Mar 2013 00:46:28 +0100
parents 35f6225dc308
children ccfb6c72ebe2
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
4776
35f6225dc308 website/README.txt: Adapting to new SF repository paths.
Bernhard Reiter <bernhard@intevation.de>
parents: 4771
diff changeset
26 hg pull -u /home/hg/p/roundup/code
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.)
4771
0173823161b2 Minor documentation: hints for shell access and wiki.
Bernhard Reiter <bernhard@intevation.de>
parents: 4770
diff changeset
30 * 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
31 shutdown
4620
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
32
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
33 www.roundup-tracker.org:
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
34 * follow [1].
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
35 * activate the virtualenv
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
36 . ${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
37 * 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
38 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
39 * (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
40 http://pypi.python.org/pypi/sphinxcontrib-cheeseshop)
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
41 * 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
42 make html
4551
7cd19e56ae4c updates
Richard Jones <richard@users.sourceforge.net>
parents: 4442
diff changeset
43 * you may also "make clean"
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
44 * install it
4655
45157fd8ba52 Nicer rsync command for copying over the webpage contents.
Bernhard Reiter <bernhard@intevation.de>
parents: 4646
diff changeset
45 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
46 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
47 rsync --dry-run -v --checksum --recursive ./html/* ${project_home}/htdocs/
4227
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 (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
50
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
51 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
52 * follow [1].
4771
0173823161b2 Minor documentation: hints for shell access and wiki.
Bernhard Reiter <bernhard@intevation.de>
parents: 4770
diff changeset
53 * the main wiki configuration is here
0173823161b2 Minor documentation: hints for shell access and wiki.
Bernhard Reiter <bernhard@intevation.de>
parents: 4770
diff changeset
54 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
55 * 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
56 cd ${project_home}/src/roundup/website/wiki
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
57 * 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
58 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
59 cp wiki/data/plugin/theme/roundup.py ${project_home}/persistent/wiki/data/plugin/theme/

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