Changes between Version 6 and Version 7 of ShowPathPlugin


Ignore:
Timestamp:
Oct 13, 2008 2:58:51 PM (6 years ago)
Author:
JasonWinnebeck
Comment:

Notes about how this plugin interacts with (upcoming) Trac 0.11.2

Legend:

Unmodified
Added
Removed
Modified
  • ShowPathPlugin

    v6 v7  
    55A Trac 0.11 version of the TracShowPathPatch as a single-file plugin, since in Trac 0.11 this can be done without source code modification, thanks to the ITemplateStreamFilter interface in Trac. This is a modification of Morris's work at t:wiki:MacroBazaar#ShowPath. His code works, but only if the trac instance is at the root of the web server (like trac-hacks.org). My modifications use the Trac environment href API to form the proper URLs. 
    66 
    7 === Requirements === 
     7== The Times, They Are A'Changin' == 
     8 
     9In the current Trac 0.11-stable branch (at least as of t:source:branches/0.11-stable at 7581) is currently the Trac 0.11.2 release, which includes an integration of the !ShowPath "patch" to Trac. If this functionality is deployed, it would basically obsolete this plugin, but is not incompatible with this plugin. What is implemented is slightly different from what this plugin does: 
     10 
     11 * The hierarchical path is shown only if you are in a "second level" page, for example "A/B". This plugin on WikiStart shows "Start Page" (no link), and on page A, shows "Start Page / A" (only "Start Page" as a link). 
     12 * This plugin puts the path on the left side of the context navigation bar in the upper right. The Trac 0.11.2 functionality puts it as a `<p>`aragraph, which appears on the left side immediately above the start of the wiki content 
     13 * The Trac functionality puts an "Up" link in the context navigation bar when on a second-level page. The "Up" link does not appear on a first level page (i.e. WikiStart is not the parent of all other first-level pages). 
     14 
     15The plugin does work in Trac 0.11.2, but you will see both the Trac 0.11.2 functionality (breadcrumbs on the left and "Up" link) and the added links from this plugin. 
     16 
     17== Requirements == 
    818 
    919Trac 0.11 and Genshi 0.5. Current version released is 0.4, so Genshi trunk will be needed. I tested with r851 of Genshi trunk. Genshi 0.5 is needed for the Transformer API to replace the "Start Page" link on the context navigation bar. 
    1020 
    11 === Documentation === 
     21== Documentation == 
    1222 
    1323From the source: 
     
    6777Replaces the "Start Page" link in the Trac bar. If you are on this page, you would see[[BR]][wiki:WikiStart Start Page] / ShowPathPlugin[[BR]]instead. If you were in a a subpage like "!ShowPathPlugin/SubPage" you would see[[BR]][wiki:WikiStart Start Page] / [wiki:ShowPathPlugin ShowPathPlugin] / !SubPage. 
    6878 
     79 
    6980== Recent Changes == 
    7081