Managing site menus
karma-lab.png

IMPORTANT: Do not ever assign a parent page to a menu. Breadcrumb trails and menus do not play well together. It is, however, safe to assign tags to a menu, and you should always assign the site-admin tag to a menu that you create.

Every page in the wiki generally has two menus

  • A global top menu, which is exactly the same on every page in the wiki.
  • Several different versions of a side menu:
    • The Home page, policy: pages, and most top-level uncategorized pages use a version that purposely has no button for creating a new page, because we want to make it difficult to accidentally create a page that does not belong to a namespace for which we have some automated controls and lists.
    • Each of the 8 article category start pages have their own version, which contains a hierarchical TOC of all pages in that category, plus a special Add new … page button that creates a new page using a template designed specifically for that category:
    • The sandbox start page also has its own version with a special Add new sandbox page button.
    • The admin portal page also has its own version with a special Add new policy page button.

To manage the top menu

To manage the side menus

  • The standard set of links in the top half of the menu use this include file side-menu-standard.
  • The Top 40 Tag Cloud section in the bottom half of the menu uses this include file: side-menu-tagcloud
  • The Home page and uncategorized pages use this version called 'nav:side'
  • Pages in the karma2: category use this version called 'nav:side-karma2'.
  • Pages in the korg-karma: category use this version called 'nav:side-korg-karma'.
  • Pages in the korg-oasys: category use this version called 'nav:side-korg-oasys'.
  • Pages in the korg-m3: category use this version called 'nav:side-korg-m3'.
  • Pages in the korg-m50: category use this version called 'nav:side-korg-m50'.
  • Pages in the korg-kronos: category use this version called 'nav:side-korg-kronos'.
  • Pages in the korg-triton: category use this version called 'nav:side-korg-triton'.
  • Pages in the karma-mw: category use this version called 'nav:side-karma-mw'.
  • Pages in the karma-oasys: category use this version called 'nav:side-karma-oasys'.
  • Pages in the karma-m3: category use this version called 'nav:side-karma-m3'.
  • Pages in the karma-m50: category use this version called 'nav:side-karma-m50'.
  • Pages in the karma-triton: category use this version called 'nav:side-karma-triton'.
  • Pages in the misc: category use this version called 'nav:side-misc'.
  • Pages in the user: category use this version called 'nav:side-user'.
  • Pages in the policy: category use this version called 'nav:side-policy'.
  • Pages in the sandbox: category use this version called 'nav:side-sandbox'.

To create a new side menu

You should generally create new side menus only for new namespaces (categories) that you've created in the wiki. Before you perform this procedure you should have already created an appropriate template for new pages created in this namespace.

  1. Add an entry to the preceding list of side menus.
    1. Copy an existing entry and paste it into the list
    2. Modify the pasted entry to specify the namespace that it's associated with (examine the existing entries to see how this should be done).
  2. Save your edits and then click one of the links for an existing side menu.
  3. Copy the entire source from the existing side menu.
  4. Come back to this page and click the link for your new menu to create it.
  5. Paste in the source you copied from an existing menu in Step 3.
  6. Modify the pasted source to change the behavior of the [[module NewPage]] tag so that it uses the proper template for the new namespace and has the proper button label.

To define the top and side menu used by all pages in a specific namespace (category)

  1. From the top menu, select admin > Site Manager.
  2. In the Site Manager, navigate to Appearance > Navigation elements
  3. Select the category and specify the specific menus for that category.

Important: The functionality in this particular panel is a bit dodgy. You cannot start typing the name of a nav:… menu page name and then select the one you want from the list-ahead control. This works in pretty much every other place on the site but not here for some reason. If you select from the list-ahead control, when you save the changes it will chop off part of the menu name and your pages will suddenly have no menu! o.O

So instead, you must manually type in the full **nav:…* page name and click somewhere away from the list-ahead popup to make it go away. Then save your changes and all should be well.

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-NonCommercial-NoDerivs 3.0 License