Navigation:
Documentation
Archive



Page Tree:

Child pages
  • Wiki navigation changes - July 2011

This wiki space contains archival documentation of Project Bamboo, April 2008 - March 2013.

Skip to end of metadata
Go to start of metadata

This page is a reference for team members who are pruning wiki pages of extraneous columns and navigation cruft now that navigation for the Tech Wiki space is relocated to the left navigation bar as a space-wide theme.

On this page:

Background: old-style navigation

Each page on this wiki was always intended to include some structural 'decoration' inside of which the main content appears. This standard 'decoration' allows for easy navigation to main pages on the wiki.

Until July 2011, this navigational layout was hard-coded into each wiki page. The navigational elements were maintained on one page, and inserted by reference from the Navigation Master - BTECH page.

Here's what the "old style navigation looks like on most pages; there's some variation, but this is the general pattern. Note the "main content appears here" marker – that's the content that's unique to the page.

{section}
{column:width=75%}

Main content appears here!

{column}
{column:width=25%}
{excerpt-include:Navigation Master - BTECH|nopanel=true}
{column}
{section}

Removing old-style navigation to unclutter new-style pages

Many pages that already exists have this "standard" layout applied, and when the new page theme added navigation to the left navigation bar for all pages, only a few active wiki pages were manually edited to remove now-extraneous and cluttering markup.

Our strategy is to edit pages as we go rather than engage in a concentrated editing sprint. We ask that those who encounter pages with the old navigational elements in place please edit the pages to remove the navigation.

You can remove the old navigational elements using the Wiki Markup or the Rich Text editor. In general, this will involve two (2) surgical edits to the page.

(1) Delete these two lines that occur before any other content that appears on the page:

{section}
{column:width=75%}

(2) Then delete these five lines that occur after any other content on the page:

{column}
{column:width=25%}
{excerpt-include:Navigation Master - BTECH|nopanel=true}
{column}
{section}

Note that the percentage values may differ on some pages from the examples above. Also, deletion of blank lines that occur between any of the markup lines shown above may also be deleted.

Save the page. That should do it.

Mistake? It's easy to restore a prior version of a page...

If the page content looks wrong after you save, it's always possible to revert to the prior saved version of the page. To do this, navigate to Tools : Page History and choose the prior version to which the page should be reverted, clicking on the appropriate Restore this page link on the right side of the Page History page.

About creating pages from templates: no longer necessary for most pages

It is no longer necessary to create a page from a template if the goal is only to add navigational elements. In fact, templates formerly used for this purpose have been deprecated and marked as obsolete.

Templates for structured pages, such as weekly status reports or pages in the Service Description Repository, often benefit by using a template on page creation. Sometimes copying and editing an extant page is as effective a tactic.

  • No labels