Understand how to embed a dynamic tree navigation with the ability to configure the beginning node for the tree navigation with 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, see our DekiScript 101 guide.
Adding DekiScript to an Article
- Go to the article that you want to add DekiScript to.
- Make sure the editor is loaded. If it isn't click Edit page.
- Go to the bottom of the page.
- In the editor click the Insert menu.
- Select DekiScript.
- Once you have created the DekiScript block you will need to paste the following DekiScript:
The example above uses the wiki.tree() function, which displays a hierarchical tree of content that originates from the page which contains the wiki.tree() call. However, it can be customized further using the following parameters:
|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
Customize 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
Analyticshen your path would be
/Documentation/Responsive/Analytics. To specify a path you can use the following DekiScript:
The following DekiScript also accomplishes the same thing:
Customize 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 two. Use the following DekiScript to modify the depth:
The following DekiScript accomplishes the same result as described above, however, it doesn't require that you enter a path:
Tip: Because the depth parameter is a number you do not need to wrap it in quotes.