Mercurial > p > roundup > code

annotate doc/FAQ.txt @ 3973:85cbaa50eba1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
xml-rpc security checks and tests across all backends [SF#1907211] also add some leap year tests
author Richard Jones <richard@users.sourceforge.net>
date Fri, 07 Mar 2008 01:11:55 +0000
parents 9f4dd27ae843
children be9122d753c5
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
688
b38f4f95bffd More doc tweaks
Richard Jones <richard@users.sourceforge.net>
parents: 686
diff changeset
1 ===========
610
8ba4f914de83 reformatted for stx processing.
Engelbert Gruber <grubert@users.sourceforge.net>
parents: 596
diff changeset
2 Roundup FAQ
659
e429649ed124 More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents: 611
diff changeset
3 ===========
551
fa23796baf7b moving FAQ.txt to doc directory
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
4
3754
9f4dd27ae843 documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents: 3250
diff changeset
5 :Version: $Revision: 1.23 $
551
fa23796baf7b moving FAQ.txt to doc directory
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
6
686
c52122f38c9b Documentation cleanup, added info for potential (and current) developers
Richard Jones <richard@users.sourceforge.net>
parents: 659
diff changeset
7 .. contents::
c52122f38c9b Documentation cleanup, added info for potential (and current) developers
Richard Jones <richard@users.sourceforge.net>
parents: 659
diff changeset
8
c52122f38c9b Documentation cleanup, added info for potential (and current) developers
Richard Jones <richard@users.sourceforge.net>
parents: 659
diff changeset
9
610
8ba4f914de83 reformatted for stx processing.
Engelbert Gruber <grubert@users.sourceforge.net>
parents: 596
diff changeset
10 Installation
659
e429649ed124 More documentation cleanups.
Richard Jones <richard@users.sourceforge.net>
parents: 611
diff changeset
11 ------------
610
8ba4f914de83 reformatted for stx processing.
Engelbert Gruber <grubert@users.sourceforge.net>
parents: 596
diff changeset
12
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
13 Living without a mailserver
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
14 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
610
8ba4f914de83 reformatted for stx processing.
Engelbert Gruber <grubert@users.sourceforge.net>
parents: 596
diff changeset
15
3754
9f4dd27ae843 documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents: 3250
diff changeset
16 Remove the nosy reactor - delete the tracker file
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
17 ``detectors/nosyreactor.py`` from your tracker home.
610
8ba4f914de83 reformatted for stx processing.
Engelbert Gruber <grubert@users.sourceforge.net>
parents: 596
diff changeset
18
551
fa23796baf7b moving FAQ.txt to doc directory
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
19
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
20 The cgi-bin is very slow!
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
21 ~~~~~~~~~~~~~~~~~~~~~~~~~
610
8ba4f914de83 reformatted for stx processing.
Engelbert Gruber <grubert@users.sourceforge.net>
parents: 596
diff changeset
22
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
23 Yep, it sure is. It has to start up Python and load all of the support
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
24 libraries for *every* request.
610
8ba4f914de83 reformatted for stx processing.
Engelbert Gruber <grubert@users.sourceforge.net>
parents: 596
diff changeset
25
3754
9f4dd27ae843 documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents: 3250
diff changeset
26 The solution is to use the built in server (or possibly the mod_python
9f4dd27ae843 documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents: 3250
diff changeset
27 or WSGI support).
589
28debb477133 spelling, formatting...
Richard Jones <richard@users.sourceforge.net>
parents: 583
diff changeset
28
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
29 To make Roundup more seamless with your website, you may place the built
3754
9f4dd27ae843 documentation cleanup from Luke Ross (patch [SF#1594860])
Richard Jones <richard@users.sourceforge.net>
parents: 3250
diff changeset
30 in server behind apache and link it into your web tree (see below).
551
fa23796baf7b moving FAQ.txt to doc directory
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
31
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
32
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
33 How do I put Roundup behind Apache
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
34 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
35
2338
d9a6918aafd5 simpler proxy instructions
Richard Jones <richard@users.sourceforge.net>
parents: 2054
diff changeset
36 We have a project (foo) running on ``tracker.example:8080``.
d9a6918aafd5 simpler proxy instructions
Richard Jones <richard@users.sourceforge.net>
parents: 2054
diff changeset
37 We want ``http://tracker.example/issues`` to use the roundup server, so we
2921
ad4fb8a14a97 more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents: 2897
diff changeset
38 set that up on port 8080 on ``tracker.example`` with the ``config.ini`` line::
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
39
2921
ad4fb8a14a97 more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents: 2897
diff changeset
40 [tracker]
ad4fb8a14a97 more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents: 2897
diff changeset
41 ...
ad4fb8a14a97 more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents: 2897
diff changeset
42 web = 'http://tracker.example/issues/'
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
43
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
44 We have a "foo_issues" tracker and we run the server with::
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
45
2338
d9a6918aafd5 simpler proxy instructions
Richard Jones <richard@users.sourceforge.net>
parents: 2054
diff changeset
46 roundup-server -p 8080 issues=/home/roundup/trackers/issues
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
47
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
48 Then, on the Apache machine (eg. redhat 7.3 with apache 1.3), in
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
49 ``/etc/httpd/conf/httpd.conf`` uncomment::
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
50
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
51 LoadModule proxy_module modules/libproxy.so
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
52
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
53 and::
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
54
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
55 AddModule mod_proxy.c
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
56
2346
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
57 Then add::
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
58
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
59 # roundup stuff (added manually)
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
60 <IfModule mod_proxy.c>
2338
d9a6918aafd5 simpler proxy instructions
Richard Jones <richard@users.sourceforge.net>
parents: 2054
diff changeset
61 # proxy through one tracker
2346
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
62 ProxyPass /issues/ http://tracker.example:8080/issues/
2338
d9a6918aafd5 simpler proxy instructions
Richard Jones <richard@users.sourceforge.net>
parents: 2054
diff changeset
63 # proxy through all tracker(*)
d9a6918aafd5 simpler proxy instructions
Richard Jones <richard@users.sourceforge.net>
parents: 2054
diff changeset
64 #ProxyPass /roundup/ http://tracker.example:8080/
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
65 </IfModule>
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
66
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
67 Then restart Apache. Now Apache will proxy the request on to the
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
68 roundup-server.
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
69
2338
d9a6918aafd5 simpler proxy instructions
Richard Jones <richard@users.sourceforge.net>
parents: 2054
diff changeset
70 Note that if you're proxying multiple trackers, you'll need to use the
d9a6918aafd5 simpler proxy instructions
Richard Jones <richard@users.sourceforge.net>
parents: 2054
diff changeset
71 second ProxyPass rule described above. It will mean that your TRACKER_WEB
d9a6918aafd5 simpler proxy instructions
Richard Jones <richard@users.sourceforge.net>
parents: 2054
diff changeset
72 will change to::
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
73
2338
d9a6918aafd5 simpler proxy instructions
Richard Jones <richard@users.sourceforge.net>
parents: 2054
diff changeset
74 TRACKER_WEB = 'http://tracker.example/roundup/issues/'
d9a6918aafd5 simpler proxy instructions
Richard Jones <richard@users.sourceforge.net>
parents: 2054
diff changeset
75
d9a6918aafd5 simpler proxy instructions
Richard Jones <richard@users.sourceforge.net>
parents: 2054
diff changeset
76 Once you're done, you can firewall off port 8080 from the rest of the world.
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
77
2346
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
78 Note that in some situations (eg. virtual hosting) you might need to use a
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
79 more complex rewrite rule instead of the simpler ProxyPass above. The
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
80 following should be useful as a starting template::
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
81
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
82 # roundup stuff (added manually)
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
83 <IfModule mod_proxy.c>
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
84
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
85 RewriteEngine on
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
86
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
87 # General Roundup
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
88 RewriteRule ^/roundup$ roundup/ [R]
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
89 RewriteRule ^/roundup/(.*)$ http://tracker.example:8080/$1 [P,L]
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
90
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
91 # Handle Foo Issues
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
92 RewriteRule ^/issues$ issues/ [R]
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
93 RewriteRule ^/issues/(.*)$ http://tracker.example:8080/issues/$1 [P,L]
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
94
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
95 </IfModule>
87dc03fa9d80 keep the rewrites - some people need to use them
Richard Jones <richard@users.sourceforge.net>
parents: 2338
diff changeset
96
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
97
3250
8634ea9b2d1c doc updates
Richard Jones <richard@users.sourceforge.net>
parents: 3244
diff changeset
98 How do I run Roundup through SSL (HTTPS)?
8634ea9b2d1c doc updates
Richard Jones <richard@users.sourceforge.net>
parents: 3244
diff changeset
99 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8634ea9b2d1c doc updates
Richard Jones <richard@users.sourceforge.net>
parents: 3244
diff changeset
100
8634ea9b2d1c doc updates
Richard Jones <richard@users.sourceforge.net>
parents: 3244
diff changeset
101 You should proxy through apache and use its SSL service. See the previous
8634ea9b2d1c doc updates
Richard Jones <richard@users.sourceforge.net>
parents: 3244
diff changeset
102 question on how to proxy through apache.
8634ea9b2d1c doc updates
Richard Jones <richard@users.sourceforge.net>
parents: 3244
diff changeset
103
8634ea9b2d1c doc updates
Richard Jones <richard@users.sourceforge.net>
parents: 3244
diff changeset
104
1721
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
105 Roundup runs very slowly on my XP machine when accessed from the Internet
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
106 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
107
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
108 The issue is probably related to host name resolution for the client
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
109 performing the request. You can turn off the resolution of the names
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
110 when it's so slow like this. To do so, edit the module
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
111 roundup/scripts/roundup_server.py around line 77 to add the following
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
112 to the RoundupRequestHandler class:
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
113
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
114 def address_string(self):
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
115 return self.client_address[0]
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
116
ed2c4f5a27da add xp lookup slowness
Richard Jones <richard@users.sourceforge.net>
parents: 1585
diff changeset
117
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
118 Templates
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
119 ---------
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
120
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
121 What is that stuff in the tracker html directory?
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
122 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
123
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
124 This is the template code that Roundup uses to display the various pages.
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
125 This is based upon the template markup language in Zope called, oddly
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
126 enough "Zope Page Templates". There's documentation in the Roundup
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
127 customisation_ documentation. For more information have a look at:
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
128
3244
9cecc6c6b297 fix reference to The Zope Book
Alexander Smishlajev <a1s@users.sourceforge.net>
parents: 2921
diff changeset
129 http://www.zope.org/Documentation/Books/ZopeBook/2_6Edition/
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
130
3244
9cecc6c6b297 fix reference to The Zope Book
Alexander Smishlajev <a1s@users.sourceforge.net>
parents: 2921
diff changeset
131 specifically chapter 10 "Using Zope Page Templates" and chapter 14 "Advanced
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
132 Page Templates".
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
133
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
134
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
135 But I just want a select/option list for ....
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
136 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
137
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
138 Really easy... edit ``html/issue.item``. For 'nosy', change line 53 from::
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
139
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
140 <span tal:replace="structure context/nosy/field" />
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
141
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
142 to::
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
143
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
144 <span tal:replace="structure context/nosy/menu" />
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
145
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
146 For 'assigned to', change line 61 from::
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
147
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
148 <td tal:content="structure context/assignedto/field">assignedto menu</td>
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
149
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
150 to::
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
151
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
152 <td tal:content="structure context/assignedto/menu">assignedto menu</td>
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
153
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
154
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
155
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
156 Great! But now the select/option list is too big
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
157 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
158
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
159 Thats a little harder (but only a little ;^)
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
160
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
161 Again, edit ``html/issue.item``. For nosy, change line 53 from:
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
162
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
163 <span tal:replace="structure context/nosy/field" />
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
164
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
165 to::
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
166
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
167 <span tal:replace="structure python:context.nosy.menu(height=3)" />
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
168
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
169 for more information, go and read about Zope Page Templates.
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
170
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
171
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
172 Using Roundup
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
173 -------------
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
174
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
175 I got an error and I cant reload it!
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
176 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
177
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
178 If you're using Netscape/Mozilla, try holding shift and pressing reload.
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
179 If you're using IE then install Mozilla and try again ;^)
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
180
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
181
1585
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
182 I keep getting logged out
1cfffe2f54c2 edited FAQ
Richard Jones <richard@users.sourceforge.net>
parents: 1584
diff changeset
183 ~~~~~~~~~~~~~~~~~~~~~~~~~
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
184
2921
ad4fb8a14a97 more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents: 2897
diff changeset
185 Make sure that the ``tracker`` -> ``web`` setting in your tracker's
ad4fb8a14a97 more doc updates, not so many TODOs any more
Richard Jones <richard@users.sourceforge.net>
parents: 2897
diff changeset
186 config.ini is set to the URL of the tracker.
1584
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
187
2090f2004ee3 Added some stuff that hit me to the FAQ.txt:
Cameron Blackwood <drkorg@users.sourceforge.net>
parents: 1304
diff changeset
188
2897
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
189 How is sorting performed, and why does it seem to fail sometimes?
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
190 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
191
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
192 When we sort items in the hyperdb, we use one of a number of methods,
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
193 depending on the properties being sorted on:
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
194
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
195 1. If it's a String, Number, Date or Interval property, we just sort the
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
196 scalar value of the property. Strings are sorted case-sensitively.
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
197 2. If it's a Link property, we sort by either the linked item's "order"
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
198 property (if it has one) or the linked item's "id".
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
199 3. Mulitlinks sort similar to #2, but we start with the first
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
200 Multilink list item, and if they're the same, we sort by the second item,
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
201 and so on.
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
202
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
203 Note that if an "order" property is defined on a Class that is used for
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
204 sorting, all items of that Class *must* have a value against the "order"
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
205 property, or sorting will result in random ordering.
21a0b049fed8 notes about sorting
Richard Jones <richard@users.sourceforge.net>
parents: 2346
diff changeset
206
686
c52122f38c9b Documentation cleanup, added info for potential (and current) developers
Richard Jones <richard@users.sourceforge.net>
parents: 659
diff changeset
207 -----------------
c52122f38c9b Documentation cleanup, added info for potential (and current) developers
Richard Jones <richard@users.sourceforge.net>
parents: 659
diff changeset
208
c52122f38c9b Documentation cleanup, added info for potential (and current) developers
Richard Jones <richard@users.sourceforge.net>
parents: 659
diff changeset
209 Back to `Table of Contents`_
c52122f38c9b Documentation cleanup, added info for potential (and current) developers
Richard Jones <richard@users.sourceforge.net>
parents: 659
diff changeset
210
c52122f38c9b Documentation cleanup, added info for potential (and current) developers
Richard Jones <richard@users.sourceforge.net>
parents: 659
diff changeset
211 .. _`Table of Contents`: index.html
1762
4c7f5d925b12 Corrected customizing url (patch [SF#791963]).
Johannes Gijsbers <jlgijsbers@users.sourceforge.net>
parents: 1721
diff changeset
212 .. _`customisation`: customizing.html
686
c52122f38c9b Documentation cleanup, added info for potential (and current) developers
Richard Jones <richard@users.sourceforge.net>
parents: 659
diff changeset
213
Roundup Issue Tracker: http://roundup-tracker.org/