KB User's Guide - Documents Tab - Creating Table of Contents (TOC) within a KB page using jQuery
A Table of Contents (TOC) at the top of your document can be useful should your document have a lot of content divided by headers. The combination of using a jQuery snippet and wrapping the headers in h2 and/or h3 containers will turn the headers into links at the top of your document. The content will then become easily accessible by clicking on a link. This document will show you how to make a TOC of your very own.
- Open your document in HTML mode.
- Type the following at the very top of the body field.
- While still in HTML mode, begin entering your headers (as seen below, circled in blue) and content beneath each header. Wrap the headers as in the example below:
This is what it should look like on your screen.
This is what it should look like on your screen. Modify the
h2,h3 below to suit your document.
On the Live site, the name of your KB space, in addition to the Title of your document will be wrapped in H1 Tags. The image below shows the browser inspect element. The Document Title is highlighted, the red box shows that the document title is wrapped in h1 tags.
We recommend that you start your TOC with the h2 tag.
Note: When working in the KB Admin Tools, the document Title in Editor displays as h2. As a result, you may see the Title of your document among the TOC links. Please know that you will NOT see the title among your TOC in the Live site at all.
Example of TOC
You can see the table of contents in action in this document.Example of the KB Table of Contents Plug-in