Creating tip document

Hi,

Unforunately I havent found an answer to this problem.

I am creating a writer document that contains a number of links to KB articles.

I want to have in that document a standard table of contents - which is easy to do.

Additionally I would like to have an overview of all tips that I have collected in that document similar to a table of content or a table if illustrations. How can I achieve this?

Thanks for explaining the solution to me.

–Gaismair

Do you want to show the entire tip i the overview? Or has each tip a suitable word, that can be used as index entry? Do you need a link from the overview to the tip?

Hi Regina,

Sorry for the late reply. I did not get any e-mail notification nor was I able to attach an example file to my question although I tried.

Let me give you an example how my document looks like:

Chapter 1 VMware basic KB Articles

Correlating build numbers and versions of VMware products (1014508)
https://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1014508

Chapter 2 RAID related articles
Like above

and further chapters and link lists and other text

Once I am done I would like to create similar to a table of contents or Illustration in an own section of the document a “Table of KB articles” as follows:

Correlating build numbers and versions of VMware products (1014508) … page number
Build numbers and versions of VMware ESXi/ESX (2143832) … page number

From that “Table of KB articles” I’d like to link to the actual text with link in my document.

I hope this sounds understandable.

Thanks for helping.

–Gaismair

You didn’t get a notification, possibly, because you created your question as “community wiki” - why would you want to do that? Clearly we should make some warning near that option that it’s not something you possibly want… And that’s why you cannot update your own question and need to “answer” it with clarification to question itself.

Added an answer to your question. Hope that this comment will notify you about it.

If you use a dedicated paragraph style for Correlating build numbers and versions of VMware products (1014508), then you may insert another ToC, and use Type: User-Defined, Styles-Assign styles... and choose which styles you need.

Also, if you use Index Entries, then use Index Marks in the same Type tab of ToC dialog.

Thanks, Mike. I will try that and feedback ASAP.

Hi Mike,

This solution works. When creating the TOC I click “Entries” tab I can not set a LS and LE because the text is just identified by the paragraph style.

What do I need to do in order to get a TOC where I can click on each entry and jump to the relevant section in the document? It should behave just like a normal TOC with headers.

Thanks.

–Gaismair

Well, you may use usual ToC (with Type:-Table of Contents), but uncheck Outline, and check Additional styles. Then all elements (including links) are available.

For automatic generation you would need an index. But there exist only two kind of indexes, which allow links back to the document: “Table of Content” and “Illustration Index”, with “Illustration Index” being actually a index of a number range.
Therefore I would go with a number range.

You can define an own number range in Insert > Field > More Fields, or shorter Ctrl F2. Then in dialog tab Variables choose the type Number range and enter a new identifier in Name. You can give it a start number. You cannot have the deep nesting as in lists, but you can add the chapter number in front of the number range number by setting the desired level in field Numbering by Chapter.

For all the following occurrences of this number range, you only need to select the new range in the Select list and click on button Insert.

When generating the index you choose the type Illustration Index and then select your number range identifier from the Category drop-down list. Then you decide about what to seen in the index in the field Display. The meanings are

  • References The entire paragraph, which contains the number of your number range.
  • Category and Number The text before the number and the number itself.
  • Caption text The text after the number.

The dialog tab Entries has already a structure, which make the entire line to a link back to the document.

So you need to put a short paragraph into your text for each KB article, which contains, what you want to see in the index. This paragraph should not be a heading. That is technically possible, but would be against the structure of the document.