Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Contents

Table of Contents

Navigating Between Pages

If you maintain multiple pages in the Canisius Wiki, you need to add a navigation scheme so users can find and move between your pages.  There are two major navigation methods in the wiki.  One is the college organization chart.  The other is the resources chart.  Each has a starting grid with links on the wiki landing page:

Image Removed

Image Removed

The College organization navigation tree simply follows the organization of the college and in most cases, that of wiki spaces.  The Resources links provide a faster track for visitors to reach things most relevant to them, faster.  The Divisions links go directly to spaces for each of the five divisions.  There, pages or links are arranged by office or departments.  

The Resources links each go to separate pages in a single space, where there are grids with links.  No other pages or content should be in that space if they properly belong to any administrative unit of the college.  Exceptions would be pages that provide documentation or instructions for resources that straddle administrative units of the college (and that are probably managed by ITS administrators.)  

Legacy Organization

The wiki was originally brought to Canisius for use in ITS and, until 2017, was even ignored by ITS outside User Services (and COLI.)  In around 2016-2017, in response to demand among several administrative units of the college for a simple CMS, the wiki was extended to the entire campus.  However, many spaces remain from it's original configuration from ITS, and are being phased out over time.  

In a few key areas, such as Human Resources, spaces may remain separate from their divisional spaces, because these offices require extensive trees of pages that for management purposes, merit their own space.'s two basic ways to do this:


Both are discussed in this video, and in the step-by-step tutorials below

Tutorial Video

Install Navigation Between Pages

Widget Connector
urlhttp://youtube.com/watch?v=PhSRnGyUJOQ

Full Screen

00:00 Do Not Rely on the SideBar Menu

01:21 Children Display Macro 

03:49 Adding Internal Links Manually

06:38 Add "Back" Links to Wiki Pages

Children Display Macro

This gadget lists any child pages of the pages on which it is posted. It is useful for the home page for each space, as well as parent pages for offices.  

Two great things about this macro:

  1. It updates automatically.  If I create another page, it appears in the Macro’s published list without my intervention.
  2. It only shows pages as clickable links if the particular visitor has permission to see that child page.  So if a page is only visible to my team, other visitors won’t see it in the list generated by this macro.


Add the Children Display Macro to the parent page for your office or department to list any child pages you have associated with that parent page.  To do so, on your parent page, click Edit to open the editor.  Place your cursor where you want the macro to operate.  Type an open curley brace: {  Once you do, confluence will open a code editor:

Image Added

Just after the curley brace, type in Children Display.  Confluence will make this available on the list (before you finish typing, probably.)  Press Enter or click it on the menu.  Once it's installed, it will look like this in your editor:

Image Added

Now it's ready to operate.  You can click on it to edit it, but by default it will list your child pages.  Simply click the blue Update button in the lower right, to publish your page.  On the published page, you should see that the macro box is replaced with a list of your child pages.  

To add a link to a Confluence page, click Edit to open that page's editor.  Then, click the chain-link or "Insert Link" icon on the toolbar.  In the resulting dialog, you can choose Recently Viewed to see choose pages you were just on, or can click Search to search by the page's title.  Once you choose a page, Confluence will set up the link.  Click the blue Insert button in the lower right to add the link.  

Image Added

Navigation Within a Page

Widget Connector
urlhttp://youtube.com/watch?v=ducUUC_dCBo

Full Screen

Tutorial Video

Heading Styles and the Table of Contents Macro

00:00 Introduction to Heading Styles

01:46 Table of Contents Macro

03:39 Use TOC links for direct sharing to sections

Headings

Heading Styles can help you quickly format titles for sections and sub-sections with heavier characters, as you see on this page.  Moreover, using headings (instead of just boldface) will be better for visually-impaired visitors, who depend on screen-reading software.

In the lefthand-most tool on the toolbar, you'll find and can choose headings.  ("Paragraph" is the default text, formatted like that you are reading right now.)

Image Added

Choose headings in the proper order, and do not skip a style:  Heading 1, for the largest titles, Heading 2 for the first subtitle, and so on.)

Table of Contents Macro

The Table of Contents Macro will automatically build and maintain a page table of contents, based on headings.  You can see an example of the macro's operation at the top of this page.

In the page editor, type a curley brace: { .  This will tell confluence to open a macro editor.  Now, type in table of contents.  Before you're even done, it'll probably give you the option to select the Table of Contents Macro.  Click the menu option or just press Enter on your keyboard.

Image Added

You'll then see that Confluence installs a placeholder box.  You can click on it, and choose Edit to experiment with settings for the macro, or just click the blue Update button to publish the page, and see the resulting Table of Contents.  

Image Added

This macro will update automatically if you add, remove, or change Headings.  


...

<< Back to Adding and Managing Page Restrictions

Return to Getting Started in Confluence Main Page