From 13d0f55865f8b1b851ce1e84597b144c5fd41662 Mon Sep 17 00:00:00 2001 From: Rob Austein Date: Sun, 13 Sep 2020 23:15:43 +0000 Subject: GC --- raw-wiki-dump/TracNavigation.md | 72 ----------------------------------------- 1 file changed, 72 deletions(-) delete mode 100644 raw-wiki-dump/TracNavigation.md (limited to 'raw-wiki-dump/TracNavigation.md') diff --git a/raw-wiki-dump/TracNavigation.md b/raw-wiki-dump/TracNavigation.md deleted file mode 100644 index 5c0a595..0000000 --- a/raw-wiki-dump/TracNavigation.md +++ /dev/null @@ -1,72 +0,0 @@ -# Trac Navigation - -The main and meta navigation entries can be customized in some basic ways. The `[mainnav]` and `[metanav]` configuration sections can be used to customize the navigation item text and link, change the ordering of the navigation items, or even disable them. - -### `[mainnav]` #mainnav-bar -`[mainnav]` corresponds to the **main navigation bar**, the one containing entries such as *Wiki*, *Timeline*, *Roadmap*, *Browse Source* and so on. This navigation bar is meant to access the default page of the main modules enabled in Trac that are accessible for the current user. - - -** [=#Example Example] ** - -In the following example we rename the link to WikiStart //Home//, and make the //View Tickets// entry link to a specific report. -```#!ini -[mainnav] -wiki.label = Home -tickets.href = /report/24 -``` - -### `[metanav]` #metanav-bar -`[metanav]` corresponds to the **meta navigation bar**, by default positioned above the main navigation bar and below the *Search* box. It contains the *Login*, *Logout*, *Help/Guide* etc. entries. This navigation bar is meant to access some global information about the Trac project and the current user. - -There is one special entry in the `[metanav]` section: `logout.redirect` is the page the user sees after hitting the logout button. The *Help/Guide* link is also hidden in the following example. -[[comment(see also #Trac3808)]] - -** Example ** - -```#!ini -[metanav] -help = disabled -logout.redirect = wiki/Logout -``` - - -### URL Formats -Possible URL formats for `.href` or `.redirect`: -| **config** | **redirect to** | -|---|---| -| `wiki/Logout` | `/projects/env/wiki/Logout` | -| `http://hostname/` | `http://hostname/` | -| `/projects` | `/projects` | - - - -### Ordering #nav-order -The `order` attribute specifies the order in which the navigation items are displayed. This can be particularly useful for plugins that add navigation items. - -Non-negative floating point values may be used for the `order` attribute. The navigation items will be arranged from left to right in increasing order. Navigation items without an `order` attribute are sorted alphabetically by name. - -The default values are: -```#!ini -[mainnav] -browser.order = 4 -newticket.order = 6 -roadmap.order = 3 -search.order = 7 -tickets.order = 5 -timeline.order = 2 -wiki.order = 1 - -[metanav] -about.order = 5 -help.order = 4 -login.order = 1 -logout.order = 2 -prefs.order = 3 -``` - -### Context Navigation #ctxtnav-bar - -Note that it is still not possible to customize the **contextual navigation bar**, ie the one usually placed below the main navigation bar. - ----- -See also: TracInterfaceCustomization, and the [TracHacks:NavAddPlugin] or [http://trac-hacks.org/wiki/MenusPlugin TracHacks:MenusPlugin](http://trac-hacks.org/wiki/NavAddPlugin) (still needed for adding entries) -- cgit v1.2.3