Skip to main content

Embed a tree navigation using DekiScript (wiki.tree) (SAP KC)

This How-To explains how to use DekiScript to add a dynamic tree navigation to one of your articles. After completing this how-to you will understand what DekiScript is and how to add DekiScript to an article.  Additionally you will understand how to embed a dynamic tree navigation with the ability to configure the beginning node for the tree navigation.

What is DekiScript

DekiScript is a scripting language in MindTouch that can be used to add dynamic functionality to your articles.  Examples include conditions (IF statements), top 10 lists, directories and more.  For more information on DekiScript please see the DekiScript Guide.

Adding DekiScript to an Article

  1. Go to the article that you want to add DekiScript to.
  2. Make sure the editor is loaded. If it isn't click Edit page.
  3. Go to the bottom of the page.
    • If the cursor only shows up in a DekiScript, CSS or JavaScript block just push Shift Enter to escape it. 
  4. In the editor click the Insert menu.
  5. Select DekiScript.

  1. Once you have created the DekiScript block you will need to paste the following DekiScript:

Using wiki.tree

The example above uses the wiki.tree() function as is, however, it can be customized further using the following parameters:

Name Type Description
path str (optional) wiki page path
depth num (optional) nesting depth for retrieving child pages (default: all)
reverse bool (optional) reverse order of child pages

Customizing the Path

By default the wiki.tree() function will display a tree of content that originates from the home page. If you wish to alter the origin you can enter in a path to use instead of the homepage. The Path is the part of the URL that is after the domain. For instance, if your page was​  then your path would be /Documentation/MindTouchTCS/Scripting/Enhance_with_DekiScript​. To specify a path you can use the following DekiScript:


The following DekiScript also accomplishes the same thing:

wiki.tree{path: '/Documentation/MindTouchTCS/Scripting/Enhance_with_DekiScript​'};

Customizing the Depth

By default the wiki.tree() function will display all articles under the source path. In some cases this can be very time consuming and may drastically deplete the performance of the page. By modifying the depth parameter you can change the scope of the tree to only include a limited number of layers. 

For instance, if your hierarchy has 15 layers, but you only wanted to display the top two, you can set the depth to three. Use the following DekiScript to modify the depth:

wiki.tree('/Documentation/MindTouchTCS/Scripting/Enhance_with_DekiScript​', 3);

The following DekiScript accomplishes the same result as described above, however, it doesn't require that you enter a path:

wiki.tree{depth: 3};

Tip:  Because the depth parameter is a number you do not need to wrap it in quotes.