Documentation for Wiki page history

[anonymous]

The trac wiki has a great feature that lets one view the revision history of a page. It's used on the main trac site, in the row of links below the row of navigation icons.

However I cannot find any documentation of this feature. It appears to be some template magic, but I can't see how to turn it on apart from digging into the template code. Shouldn't this be settable from the trac.ini file, in the way mainnav and metanav are? Perhaps it is but I can't find any documentation on the trac wiki to that effect. If someone can point me to the right part of the code or examples directory tree, perhaps I could draft something…

A separate but closely related issue (split the bug if you wish): It would be quite helpful to have a macro e.g. [[PageHistory]] that allows the user to place the link to the page revision history where they would like it.

Note that this all applies to the wiki pages, not the (already excellent) handling of the revision control system's history data.

[ebray]

The page history link should be displayed on any page by default. There's no "setting" for that.

[anonymous]

Replying to ebray:

The page history link should be displayed on any page by default. There's no "setting" for that.

This is since 0.11? It definitely doesn't exist in 0.10.3.

The point still stands - there's no documentation that I could find explaining how the group of links in the upper right corner of the page, below the navigation icons, is generated. Also, the links one sees change with context (compare viewing a wiki page with viewing a ticket). Does this page element have a name? For example the navigation icons seem to be called "mainnav".

[ebray]

Replying to anonymous:

This is since 0.11? It definitely doesn't exist in 0.10.3.

The point still stands - there's no documentation that I could find explaining how the group of links in the upper right corner of the page, below the navigation icons, is generated. Also, the links one sees change with context (compare viewing a wiki page with viewing a ticket). Does this page element have a name? For example the navigation icons seem to be called "mainnav".

Unless there's something wrong with your installation, it definitely should exist. See: tags/trac-0.10.3/templates/wiki.cs​.

Anyways, to answer your question, that's called the ctxtnav bar. One thing that has changed since 0.11 is that there's now a function to add links to it, whereas they were previously just hard-coded in the templates, which wasn't great.

[ebray]

Actually, upon closer inspection, it seems that in 0.10.3 it only displays the Page History link when a page diff is being viewed, so I guess that changed too. Anyways, that's the template to edit if you want to fix that. Though I would really recommend upgrading if possible.

[anonymous]

Ok, thanks for the information about the context-navigation element (ctxtnav) and where it is defined.

The (0.11) capability to add links to this is great.

We do plan to upgrade, RSN. I think this can be closed.

Can I suggest a change to TracIni, though, in the [trac] subheading -

|| ctxtnav || Selection and order of the items to display in the context-sensitive navigation bar (ctxtnav), listed by IDs.||

Should TracNavigation be updated on this score as well?

[Remy Blank]

Replying to anonymous:

The (0.11) capability to add links to this is great.

Erik meant that plugins now have a way to add items to the ctxtnav bar. This is not configurable in trac.ini, as explained in TracNavigation:

Note that it is still not possible to customize the contextual navigation bar, i.e. the one usually placed below the main navigation bar.

Closing as per comment:6.