Edgewall Software
Modify

Opened 14 years ago

Closed 14 years ago

#7633 closed defect (worksforme)

Documentation for Wiki page history

Reported by: anonymous Owned by:
Priority: normal Milestone:
Component: wiki system Version:
Severity: normal Keywords: documentation
Cc: Branch:
Release Notes:
API Changes:
Internal Changes:

Description

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.

Attachments (0)

Change History (7)

comment:1 by anonymous, 14 years ago

Keywords: documentation added

comment:2 by ebray, 14 years ago

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

in reply to:  2 ; comment:3 by anonymous, 14 years ago

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".

in reply to:  3 comment:4 by ebray, 14 years ago

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.

comment:5 by ebray, 14 years ago

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.

comment:6 by anonymous, 14 years ago

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?

in reply to:  6 comment:7 by Remy Blank, 14 years ago

Resolution: worksforme
Status: newclosed

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.

Modify Ticket

Change Properties
Set your email in Preferences
Action
as closed The ticket will remain with no owner.
The resolution will be deleted. Next status will be 'reopened'.
to The owner will be changed from (none) to the specified user.

Add Comment


E-mail address and name can be saved in the Preferences .
 
Note: See TracTickets for help on using tickets.