[Trac-tickets] [The Trac Project] #2168: Universal TracLinks argument

The Trac Project noreply at edgewall.com
Tue Oct 4 04:02:07 CDT 2005


#2168: Universal TracLinks argument
-------------------------+--------------------------------------------------
 Reporter:  cboos        |       Owner:  cboos
     Type:  enhancement  |      Status:  new  
 Priority:  normal       |   Milestone:       
Component:  wiki         |     Version:  devel
 Severity:  minor        |   Keywords:               |  
-------------------------+--------------------------------------------------
 Currently, each flavor of TracLinks implements it's own "sub" syntax.

 There is some consistency however, for example,
 a trailing "#fragment" is used to locate a specific anchor in the targeted
 objects.
 This works for section anchors in Wiki pages and more recently
 for line numbers in repository files.

 Also, there's some support for the special "?format=raw" argument
 which works for attachment: links, and it was suggested that source:
 links adopt the same convention.

 What becomes apparent from the above is that those conventions
 are pretty much the same as those used for
 [http://ietfreport.isoc.org/idref/rfc3986 URIs].

 Therefore, I propose to add the query URI syntax
 to the TracLinks syntax, for the short and long form of links
 (but not for the shorthand forms).

 Examples:
  * source:trunk/README?format=txt    Access the README file in "text" mode
  * wiki:WikiStart?format=txt         Access the WikiStart page in "text"
 mode
  * log:trunk?limit=10                See the last ten changesets on trunk
  * query:?milestone=1.0&owner=cboos  See my 1.0 tickets (works already)
  * search:?q=google&wiki=on         Search for "google" in Wiki pages
 (works already)
  * report:14?PRIORITY=highest        ... works in Trac > r2322

-- 
Ticket URL: <http://projects.edgewall.com/trac/ticket/2168>
The Trac Project <http://trac.edgewall.com/>


More information about the Trac-Tickets mailing list