Using Publish to HTML Help, how do I get a mini-toc in topics? I tried using the default HTML template which is installed here:
C:\Program Files (x86)\Adobe\AdobeFrameMaker2015\fminit\Publisher\Template\Document\PageTemplate\HTMLTemplate.htm
and also parts of the one online from here:
To use the template, in the Publish pod, I select "Microsoft HTML Help", click the "Edit" (settings) then select "Use HTML Page Template", click the Import button to load the template file. I've been able to make some simple boiler plate stuff work, but the mini-toc just shows as dead text.
The documentation says I should be able to insert something like this in the template HTML:
<p data-type=”minitoc-caption”>This section covers the following:</p>
<p data-type=”minitoc-level1”><span data-type=”minitoc-selector”>’H2_Heading2’</span></p>
<p data-type=”minitoc-level2”><span data-type=”minitoc-selector”>’H3_Heading3’</span></p>
<p data-type=”minitoc-level3”><span data-type=”minitoc-selector”>’H4_Heading4’</span></p>
But this results in the literal text 'H2_heading2' appearing instead of a variable replacement, and the whole thing is static.
Do I need to do something in FM or in the Publish settings to get this to work too? Do I need to manually insert mini-toc(s) into my FM documents? I was hoping it would be automatically generated.
Has anybody got the mini-toc feature to work? I'm sorry to ask but I've found virtually no documentation on this.
To quickly experience mini-toc feature of FM publish feature, please do these steps:
A mini-TOC gets created in the output:
How does the mapping work in miniTOC w.r.t the Para Tags?
The para tags that we define in HTML Page Template at level1, level2 etc are scanned from the FM document and are brought at the desired level in selected output.
To show it diagramatically - I have taken a screenshot:
The concept of keeping it in HTML is to provide flexibility in terms of styling & customizations via CSS.
To create a Page Template for your FM file from scratch you may follow the link: Adobe FrameMaker (2015 release)
I apologize that we haven't done our bit to make this feature simple . But suggestions are always welcome
Do let us know if this makes it easy for you to get started.
Thanks for helping to explain this feature. I appreciate it. Your screen shot was useful.
I opened the User Guide book and published to HTML5 and HTML Help using that HTMLTemplate.htm file, however no mini-TOC was created. Not sure why. I used my own simple test with some headings and it sort of worked, but were a couple of problems.
1) When I loaded a page in the HTML Help viewer, it gives a script error:
The line in question I think is this:
document.write("<p class=\\"pt_breadcrumbs\\" ><a href=\"Personal_Spaceship_Operations_Manual.htm\">Home</a> > ....snipped...
I clicked YES to continue running the script. The breadcrumbs part is missing from the output (probably due to the script error).
2) Second problem is the mini-toc seems incorrect:
In the image above, why are the items in the mini-toc at different levels? They look correct in the main TOC on the left.
3) In your sample (and my results) I noticed that the heading numbers run into the text. For example "2.1.1heading text". How can I fix this? Can I remove the auto-number?
4) What if my FM doc uses different named heading styles? I have a document that uses "Heading1", not "H1_Heading1". How do I modify the HTMLTemplate.htm file so the mini-toc heading styles are found?
5) Finally, I was hoping a mini-toc could be placed at any level I want, even if the sub-headings are not contained within the page. For example, in my example above, suppose each heading 3 is in its own topic page. I would like to have a mini-toc at heading 2 level with links to the sub-headings. I'm not sure if that is how the FM mini-toc feature is designed to work.
Sorry for the long post, but thanks for your helpful efforts.
Glad it helped! Replies to your queries below: