Edgewall Software

Changes between Version 20 and Version 21 of TracNavigation


Ignore:
Timestamp:
Nov 30, 2011, 10:10:45 AM (12 years ago)
Author:
py.hieroglyph@…
Comment:

I struggled to find the info about re-ordering the mainnav items (so I could control where my plugin appeared) so I added the info here.

Legend:

Unmodified
Added
Removed
Modified

  • TracNavigation

    v20 v21  
    33Starting with Trac 0.11, it is now possible to customize the main and meta navigation entries in some basic ways.
    44
    5 The new `[mainnav]` and `[metanav]` configuration sections can now be used to customize the text and link used for the navigation items, or even to disable them.
     5The new `[mainnav]` and `[metanav]` configuration sections can now be used to customize the text and link used for the navigation items, or even to disable them.  The `mainnav` and `metanav` options in the `[trac]` configuration section can also be used to change the order.
    66
    77=== `[mainnav]` #mainnav-bar
    … …  
    1111** [=#Example Example] **
    1212
    13 In the following example, we rename the link to the Wiki start "Home", and hide the "!Help/Guide" link.
    14 We also make the "View Tickets" entry link to a specific report.
     13In the following example, we rename the link to the Wiki start "Home", and make the "View Tickets" entry link to a specific report.  The second example (below) also hides the "!Help/Guide" link.
    1514
    1615Relevant excerpt from the TracIni:
    … …  
    4443
    4544
     45=== `[trac]` #nav-order
     46The `mainnav` and `metanav` options in the `[trac]` configuration section control the order in which the navigation items are displayed (left to right).  This can be useful with plugins that add navigation items.
     47
     48** Example **
     49
     50In the following example, we change the order to prioritise the ticket related items further left.
     51
     52Relevant excerpt from the TracIni:
     53{{{
     54[trac]
     55mainnav = wiki,tickets,newticket,timeline,roadmap,browser,search,admin
     56}}}
     57
     58The default order and item names can be found in the source, which at the time of writing [source:trunk/trac/web/chrome.py@10883#L396 is here]
     59
     60=== Context Navigation #ctxtnav-bar
     61
    4662Note that it is still not possible to customize the '''contextual navigation bar''', i.e. the one usually placed below the main navigation bar.
    4763