Skip to main content
MindTouch Success Center

Site structure errors

Applies to:
All MindTouch Versions
Role required:
Author
The Structure Analysis Reports can contain Category errors, Guide errors, Topic errors, How-To errors, Reference errors, Unclassified errors, and customer or other errors.

We recommend you address Category and Guide errors before sub-page errors to resolve structure issues from the top down.

Category errors

  • Category under Guide
  • Category under Topic
  • Category under How-To
  • Category under Reference
  • Category under Unclassified
  • Category under Custom

To resolve: Move Category underneath lowest level Category within hierarchy.

Guide errors

Guide under Guide

Option 1: Move both Guides directly under the lowest level Category to make Guides siblings.

Option 2: Change lower level Guide to an article:

  1. If the Guide is a parent to other articles, the Guide should be made a Topic. Otherwise, it can be made any article type (such as a Topic, How-to or Reference).
  2. Change article type from Guide to Topic, How-to or Reference.
  3. Remove Guide DekiScript (Navigation widget) from new article.

Guide under Topic

Option 1: Change Guide to Topic

  1. Change article type from Guide to Topic.
  2. Remove Guide DekiScript  (Navigation widget) from article.

Option 2: Change Topic to Guide

  1. Change article type from Topic to Guide.
  2. Move both Guides to become children of lowest level Category.
  3. Add Guide DekiScript to new Guide. To do this: Add a DekiScript code block to the bottom of the Guide and add Navigation widget code.

Guide under How-To

  1. Change article type from Guide to Topic.
  2. Move Topic underneath the closest Topic or Guide in its hierarchy.
  3. Remove Guide DekiScript.

Guide under Reference

  1. Change article type from Guide to Topic.
  2. Move Topic underneath the closest Topic or Guide in its hierarchy.
  3. Remove Guide DekiScript.

Guide under Unclassified

  1. Change article type from Guide to Topic.
  2. Move Topic underneath the closest Topic or Guide in its hierarchy.
  3. Remove Guide DekiScript.

Guide under Custom

  1. Change article type from Guide to Topic.
  2. Move Topic underneath the closest Topic or Guide in its hierarchy.
  3. Remove Guide DekiScript.

Topic errors

Topic under Category

Option 1: Change Topic to Guide

  1. Change article type from Topic to Guide.
  2. Add Guide DekiScript. Add a DekiScript code block to the bottom of the Guide and paste the navigation code.

Option 2: Move Topic under nearest Guide within hierarchy

Topic under Topic
Make the Topic pages siblings or change the lower-level topic to a Reference or How-To page.

Topic under How-To
Option 1:  Move Topic under nearest Guide or Topic
Option 2:  Change How-to to Topic - Change article type from How-to to Topic.

Topic under Reference
Option 1:  Move Topic under nearest Guide or Topic
Option 2:  Change Reference to Topic - Change article type from Reference to Topic.

Topic under Unclassified
Option 1:  Move Topic under nearest Guide or Topic
Option 2:  Change Unclassified to Topic - Change article type from (not set) to Topic.

Topic under Custom
Option 1:  Move Topic under nearest Guide or Topic
Option 2:  Change custom article to Topic - Change article type from custom article to Topic.

How-To errors

How-To underneath Category
Move How-to article to under a Guide.

How-To underneath How-To
Option 1:  Change top level How-to article to Topic - Change article type from How-to to Topic.
Option 2:  Move bottom level How-to article under a Topic or Guide

How-To underneath Reference
Option 1:  Change Reference article to Topic -Change article type from Reference to Topic.
Option 2:  Move How-to article underneath a Topic or Guide

How-To under Unclassified
Option 1:  Change Unclassified article to Topic - Change article type from (not set) to Topic.
Option 2:  Move How-to article underneath a Topic or Guide

How-To underneath Custom
Move How-to article underneath a Topic or Guide.

Reference errors

Reference under Category
Move Reference article to under a Guide.

Reference under How-To
Option 1:  Change How-to article to Topic - Change article type from How-to to Topic.
Option 2:  Move Reference article underneath a Topic or Guide

Reference under Reference
Option 1:  Change top level Reference article to Topic - Change article type from Reference to Topic.
Option 2:  Move bottom level Reference article under a Topic or Guide

Reference under Unclassified
Option 1:  Change Unclassified article to Topic - Change article type from (not set) to Topic.
Option 2:  Move Reference article underneath a Topic or Guide

Reference under Custom
Move Reference article underneath a Topic or Guide.

Unclassified errors

Page has no article type
All pages on your site should include an article type association. If your page does not include an article type, expand Page settingsand choose an option from the Article type drop-down menu.

Unclassified page not under Home page
Unclassified articles can only fall under a Category and only if that Category is the home page.

Option 1:  Move Unclassified page underneath Home page. - Home page must be classified as a Category

Option 2:  Classify the Unclassified page.

  1. Change article type from (not set) to desired article type.
  2. Add appropriate DekiScript if Category or Guide: If the article type is to be a Category, add Category DekiScript.

{Custom} page errors

If an error pertaining to a custom article type surfaces, the report will list the error by the name of the custom article type.

{Custom} under Category
Move custom article to under a Guide.

{Custom} under How-To
Option 1:  Change How-to to Topic - Change article type from How-to to Topic.
Option 2:  Move custom article underneath a Topic or Guide

{Custom} under Reference
Option 1:  Change Reference to Topic - Change article type from Reference to Topic.
Option 2:  Move custom article underneath a Topic or Guide

{Custom} under Unclassified
Option 1:  Change Unclassified article to Topic - Change article type from (not set) to Topic.
Option 2:  Move custom article underneath a Topic or Guide

{Custom} under Custom
Option 1:  Change top level custom article to Topic - Change article type from Custom to Topic
Option 2:  Move bottom level custom article under a Topic or Guide

Other errors

Page contains multiple article types
Sometimes an article will have multiple article types. To resolve, change the article type classification to the desired article. If the article type classification is already correct, select an alternate article type and re-select the appropriate article type.

  • Was this article helpful?