Can't get a Mini-TOC proxy to work with Clean HTML

This forum is for all Flare issues related to the HTML5, WebHelp, WebHelp Plus, and Adobe Air Targets

Can't get a Mini-TOC proxy to work with Clean HTML

Postby Colum on Thu Sep 19, 2019 1:33 pm

I'm struggling to get a mini-toc prozy to display properly in my topics. It has been added to a master page that has been added to my target. However when I publish the output - I'm using Clean HTML - no min-TOC is displayed in the topics. Before you ask, yes there are other headings in the topic and I've set the proxy to display the first three levels.

mini-toc1.png

mini-toc2.png


I see you can specify a master page in a topic's properties also. I've set this to "default" which in my book should be the one I've set in the target. Am I right? Maybe one of your super heroes can point me in the direction of where I'm going wrong.
You do not have the required permissions to view the files attached to this post.
Colum
Propeller Head
 
Posts: 43
Joined: Thu Apr 11, 2013 3:15 am
Location: The (not so) United Kingdom

Re: Can't get a Mini-TOC proxy to work with Clean HTML

Postby Nita Beck on Thu Sep 19, 2019 2:02 pm

I believe you're confusing a mini-TOC proxy with a menu proxy.

A mini-TOC proxy is intended to build a list of links based on the first headings found in topics whose associated TOC entries are nested beneath another topic's TOC entry.

A menu proxy, by contrast, can be used to build a list of links to subheadings within a topic.

HTH
Nita
Image
Content Strategist / Information Architect / Flare Consultant: http://beck-communications.com
Manager, Rochester Flare User Group: http://www.facebook.com/RochesterFlareUserGroup
Nita Beck
Senior Propellus Maximus
 
Posts: 3288
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Can't get a Mini-TOC proxy to work with Clean HTML

Postby Colum on Thu Sep 19, 2019 2:45 pm

Thanks for the clarification Nita. It sounds like I can't achieve what I wanted. Say I've got a topic with the following heading structure:

Heading 1
Paragraph
Paragraph
Heading 2
Paragraph
Heading 2
Paragraph
Heading 3
Paragraph
Paragraph
Heading 2
Paragraph

I want to automatically add a list of bookmarks to all the headings in the same topic. It looks like both the mini-toc and menu proxies don't do this.
Colum
Propeller Head
 
Posts: 43
Joined: Thu Apr 11, 2013 3:15 am
Location: The (not so) United Kingdom

Re: Can't get a Mini-TOC proxy to work with Clean HTML

Postby Nita Beck on Thu Sep 19, 2019 6:26 pm

You *can* with a menu proxy. Edit the menu proxy and associate it with headings instead of a TOC.

From Flare’s help:
You also have the option of selecting “Headings,” which will display topic headings in the side menu instead. In other words, any headings or subheadings (e.g., h1, h2, h3, h4) that you’ve included in a topic will be shown in the side menu instead of other topics in the output.

https://help.madcapsoftware.com/flare2019/Content/Flare/Proxies/Creating-Topic-Menu.htm

You may need to play with CSS so the menu isn’t rendered as a floating side menu.
Nita
Image
Content Strategist / Information Architect / Flare Consultant: http://beck-communications.com
Manager, Rochester Flare User Group: http://www.facebook.com/RochesterFlareUserGroup
Nita Beck
Senior Propellus Maximus
 
Posts: 3288
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Can't get a Mini-TOC proxy to work with Clean HTML

Postby Dave Lee on Fri Sep 20, 2019 12:20 am

You can't use a menu proxy in Clean XHTML targets - it's only supported in HTML5 targets.

You can use Mini-TOC proxy in Clean XHTML targets, but a mini-TOC will not automatically create links to headings in your topics.
The mini-TOC will only display the links that are in your TOC. So I think you'd need to manually add links to these headings in your TOC, i.e. insert bookmarks next to the headings, and then add links link to these bookmarks in your TOC.

If you're using Clean XHTML, then quite a lot of things aren't supported - see https://help.madcapsoftware.com/flare20 ... Output.htm
I'd suggest using HTML5, unless there's a reason for using Clean XHTML.
Dave Lee
Master Propellus Maximus
 
Posts: 5654
Joined: Mon Mar 05, 2007 8:33 am
Location: UK

Re: Can't get a Mini-TOC proxy to work with Clean HTML

Postby Colum on Fri Sep 20, 2019 2:36 am

Thanks Dave. We are limited to Clean HTML as we are using the Salesforce Connect plugin.
Colum
Propeller Head
 
Posts: 43
Joined: Thu Apr 11, 2013 3:15 am
Location: The (not so) United Kingdom

Re: Can't get a Mini-TOC proxy to work with Clean HTML

Postby Nita Beck on Fri Sep 20, 2019 5:26 am

Colum, my *sincere* apology for taking you down the proverbial garden path. I consulted several Flare help topics before posting the link and would swear that I found reference — positively so — to Clean HTML and menu proxies. But I’m clearly wrong.
Nita
Image
Content Strategist / Information Architect / Flare Consultant: http://beck-communications.com
Manager, Rochester Flare User Group: http://www.facebook.com/RochesterFlareUserGroup
Nita Beck
Senior Propellus Maximus
 
Posts: 3288
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Can't get a Mini-TOC proxy to work with Clean HTML

Postby Colum on Fri Sep 20, 2019 6:43 am

No problem Nita. It was a particularly rich and colorful path :-)
Colum
Propeller Head
 
Posts: 43
Joined: Thu Apr 11, 2013 3:15 am
Location: The (not so) United Kingdom


Return to Web-based Outputs

Who is online

Users browsing this forum: No registered users and 3 guests