Using Categories On This Site

From Cycling '74 Wiki
Jump to: navigation, search


The Category Hierarchy

On this site, we use Categories as an automatic organization system. There are four main categories:

  • Max (for tutorials and information on Max itself)
  • MaxAnd (for tutorials and information on technologies exposed by Max)
  • MaxWith (for interfacing with hardware and other software packages)
  • Topics and Techniques (for tutorials and information on specific topics in Max)

These categories are the top level categories shown on the Main Page, and represent overview sections. At one level below these categories are sub-categories that are domain specific. For example, in the Max category, you will find sub-categories for curriculum, tutorials on Max objects and other Max-focused learning material.

When authoring an article or tutorial, you will want to assign your work to one or more of these sub-categories. By doing so, your work will automatically be displayed on the front page, and will be available to the category pages. Choosing a precise sub-category depends on the content that you've written about, but it also depends on the way that you are presenting the material.

Setting a Category for a one-page article

If you are making a one-page article or tutorial, you only need to assign your page to one of the overview sub-categories. For example, if you have created an article on using the Javascript MGraphics system to create a slider, you would place the following markup at the bottom of your article:

[[Category:Max And Javascript]]

at the bottom of your text. This will add your article to the Max and Javascript category, and automatically include it in that tree on the main page.

Setting a Category for a multi-page article

If you make a multi-page article, you will need to create a unique category that will 'hold' all of the pages of your work, then expose that category page to the overview sub-category. For example, if you created a 5-page article on developing a sequencer for the Monome, you would create a new container category for all five pages - in this case, you might want to call the category 'A New Sequencer for the Monome'. In order to tie the pages together, you would place the following at the bottom of each page:

[[Category:A New Sequencer for the Monome]]

When you save the pages, a Categories section is automatically created at the bottom that links to a 'Category Page' that contains your article's pages. Now, in order to tie this category to the Monome sub-category, you have to edit the Category Page itself. Click on the link at the bottom of one of your pages, and you will see a default category page that lists all of the links pages. In the Category Page editor, place a link to one of the overview categories. In this case, it would be:


Now, your entire article will appear under the Monome section as a single entity (labeled 'A New Sequencer for the Monome') with a plus sign in front of it; clicking on the plus sign will reveal all of the pages in your article.

Note: The order in which pages are listed are alphabetical based on the page title. In order to make the pages appear in order, it is useful to include the page number in the page title, like:

  • A New Sequencer for the Monome - page 1
  • A New Sequencer for the Monome - page 2
  • A New Sequencer for the Monome - page 3

Creating new overview sub-categories

If you are writing about a new area of interest, you may not find a suitable overview sub-category. For instance, if you are writing about DMX hardware, but don't find a DMX-specific sub-category, you will need to create a new overview category. In this case, you would place a category in your text that points to your proposed sub-category:


After you've done this, a link will appear at the bottom of your article. Click on it to get to the DMX Category Page, and link it to a top level category:


Now, a new overview sub-category will be displayed on the main page for other writers to reference.

Note: The site 'gardeners' will be watching the creation of new sub-categories closely in order to maintain a useful site hierarchy. If you have any questions about creating a new sub-category for your work, feel free to contact one of the site administrators.