Mercurial > p > roundup > code
comparison doc/customizing.txt @ 2589:809758599cdc
oops, double-@
| author | Richard Jones <richard@users.sourceforge.net> |
|---|---|
| date | Tue, 20 Jul 2004 00:19:04 +0000 |
| parents | e80604dbe2af |
| children | aa95c79cff8b |
comparison
equal
deleted
inserted
replaced
| 2588:e80604dbe2af | 2589:809758599cdc |
|---|---|
| 1 =================== | 1 =================== |
| 2 Customising Roundup | 2 Customising Roundup |
| 3 =================== | 3 =================== |
| 4 | 4 |
| 5 :Version: $Revision: 1.144 $ | 5 :Version: $Revision: 1.145 $ |
| 6 | 6 |
| 7 .. This document borrows from the ZopeBook section on ZPT. The original is at: | 7 .. This document borrows from the ZopeBook section on ZPT. The original is at: |
| 8 http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx | 8 http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx |
| 9 | 9 |
| 10 .. contents:: | 10 .. contents:: |
| 980 special request variable ``@template``. The URL path after the tracker | 980 special request variable ``@template``. The URL path after the tracker |
| 981 identifier is examined. Typical URL paths look like: | 981 identifier is examined. Typical URL paths look like: |
| 982 | 982 |
| 983 1. ``/tracker/issue`` | 983 1. ``/tracker/issue`` |
| 984 2. ``/tracker/issue1`` | 984 2. ``/tracker/issue1`` |
| 985 3. ``/tracker/@file/style.css`` | 985 3. ``/tracker/@@file/style.css`` |
| 986 4. ``/cgi-bin/roundup.cgi/tracker/file1`` | 986 4. ``/cgi-bin/roundup.cgi/tracker/file1`` |
| 987 5. ``/cgi-bin/roundup.cgi/tracker/file1/kitten.png`` | 987 5. ``/cgi-bin/roundup.cgi/tracker/file1/kitten.png`` |
| 988 | 988 |
| 989 where the "tracker identifier" is "tracker" in the above cases. That means | 989 where the "tracker identifier" is "tracker" in the above cases. That means |
| 990 we're looking at "issue", "issue1", "@file/style.css", "file1" and | 990 we're looking at "issue", "issue1", "@@file/style.css", "file1" and |
| 991 "file1/kitten.png" in the cases above. The path is generally only one | 991 "file1/kitten.png" in the cases above. The path is generally only one |
| 992 entry long - longer paths are handled differently. | 992 entry long - longer paths are handled differently. |
| 993 | 993 |
| 994 a. if there is no path, then we are in the "home" context. See `the "home" | 994 a. if there is no path, then we are in the "home" context. See `the "home" |
| 995 context`_ below for more information about how it may be used. | 995 context`_ below for more information about how it may be used. |
| 996 b. if the path starts with "@file" (as in example 3, | 996 b. if the path starts with "@@file" (as in example 3, |
| 997 "/tracker/@file/style.css"), then the additional path entry, | 997 "/tracker/@@file/style.css"), then the additional path entry, |
| 998 "style.css" specifies the filename of a static file we're to serve up | 998 "style.css" specifies the filename of a static file we're to serve up |
| 999 from the tracker "html" directory. Raises a SendStaticFile exception. | 999 from the tracker TEMPLATES (or STATIC_FILES, if configured) directory. |
| 1000 This is usually the tracker's "html" directory. Raises a SendStaticFile | |
| 1001 exception. | |
| 1000 c. if there is something in the path (as in example 1, "issue"), it | 1002 c. if there is something in the path (as in example 1, "issue"), it |
| 1001 identifies the tracker class we're to display. | 1003 identifies the tracker class we're to display. |
| 1002 d. if the path is an item designator (as in examples 2 and 4, "issue1" | 1004 d. if the path is an item designator (as in examples 2 and 4, "issue1" |
| 1003 and "file1"), then we're to display a specific item. | 1005 and "file1"), then we're to display a specific item. |
| 1004 e. if the path starts with an item designator and is longer than one | 1006 e. if the path starts with an item designator and is longer than one |
| 1039 | 1041 |
| 1040 Serving static content | 1042 Serving static content |
| 1041 ---------------------- | 1043 ---------------------- |
| 1042 | 1044 |
| 1043 See the previous section `determining web context`_ where it describes | 1045 See the previous section `determining web context`_ where it describes |
| 1044 ``@file`` paths. | 1046 ``@@file`` paths. |
| 1045 | 1047 |
| 1046 | 1048 |
| 1047 Performing actions in web requests | 1049 Performing actions in web requests |
| 1048 ---------------------------------- | 1050 ---------------------------------- |
| 1049 | 1051 |