TracNav footer navigation bar

[jwilliams@…]

Prev/Next navigation footer for TracNav?

How about a [[TracNavFooter(TOC)]] macro, that renders a page-specific navigation bar to the previous, next and "parent" page in the heirarchy defined by the TOC?

Users adding this macro to the bottom (or top) of each wiki page would give a nice ability for sequential navigation.

This info is already parsed out by the TracNav macro, would just be slightly different way of rendering it.

[moschny]

Interesting proposal, but there are some open questions:

• What should the macro do, if the current page is not part of the TOC?
• What should be selected for prev/next/parent if the current page is mentioned more than once in the TOC?

[jwilliams@…]

In the cases you mention, I would suggest:

• If the current page is not in the TOC, then either give a warning text output:

   WARNING: Current page (pagename) not part of TOC (TOCpage)
  

  alternatively, just fail silently and produce no output at all.

• For next/prev/parent, if there are multiple possibilities, the simplest approach is to fail! For a preliminary release it might be OK to just say "The TracNavFooter requires that the following be true:" and include "only linear/sequential TOCs are supported".

More complex behaviours are certainly possible - for example does Trac drop cookies that allow the footer to detect the navigation path "into" the page? That could be used to resolve ambiguity, at some complexity cost.