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.
This is what it should look like on your screen.
/* Specify elements to be used as TOC heading */
This is what it should look like on your screen. Modify the
h2,h3 below to suit your document.
- 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:
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.
Sample Doc: How To Remove Coffee Stains From Your Clothes