Breadcrumb workaround

This forum is for all Flare issues related to the HTML5, WebHelp, WebHelp Plus, and Adobe Air Targets
Post Reply
Matze
Sr. Propeller Head
Posts: 177
Joined: Mon Jun 20, 2016 10:35 pm

Breadcrumb workaround

Post by Matze »

Hi all,
I´m putting one topic at several TOC positions. I like this reuseable feature :lol:

Then the breadcrumb pathway doesn't work. There is a flare workaround:

http://help.madcapsoftware.com/flare12/ ... roxies.htm

But in the future I don't want to put all of my topics in a snippet to make them reusable :oops:
I like the breadcrumbs but generally putting topics in snippets makes no sense for my single source/topic based thinking ...

Have you other useful workarounds for this breadcrumb issue?

Thanks

Matze
ChoccieMuffin
Senior Propellus Maximus
Posts: 2650
Joined: Wed Apr 14, 2010 8:01 am
Location: Surrey, UK

Re: Breadcrumb workaround

Post by ChoccieMuffin »

You only need to create snippets for those topics that you want to reuse, so it's not such an onerous task.

If you seem to be putting LOTS of topics in your TOC more than once, perhaps you could use cross-references rather than including the entire topic.
Started as a newbie with Flare 6.1, now using Flare 2024r2.
Report bugs at http://www.madcapsoftware.com/bugs/submit.aspx.
Request features at https://www.madcapsoftware.com/feedback ... quest.aspx
Matze
Sr. Propeller Head
Posts: 177
Joined: Mon Jun 20, 2016 10:35 pm

Re: Breadcrumb workaround

Post by Matze »

Hi ChoccieMuffin,

thanks for your comment!

You´re right for online help output like HTML5 to use cross-references. But for my second PDF output I want to avoid many cross-references. So I put my topic to another TOC position instead.

But my really big problem is: I´m not sure if the snippet workaround is useful for multi user documentation projects in my team. I suppose/afraid we will put all of our topics (with snippets) in a whole snippet to reuse them for the feature. Hmmm, sounds a bit strange :?
ChoccieMuffin
Senior Propellus Maximus
Posts: 2650
Joined: Wed Apr 14, 2010 8:01 am
Location: Surrey, UK

Re: Breadcrumb workaround

Post by ChoccieMuffin »

You can have nested snippets, it's not a problem. For example, you may have a note that you want to include in lots of places, including in topics that you want to repeat in several places, so you'd have a snippet for the topic content, and in that snippet you'd have your note snippet.

Something else you might want to think of doing is using nested TOCs (I don't know if that's the correct term), particularly for your PDFs. I have a particularly large project, and each feature for the product has its own TOC. I then include each of those TOCs in the main product TOC. (If you're going to use those smaller TOCs in your Help target as well, then you may still need to do the snippetty thing to avoid breaking your breadcrumbs.)
Started as a newbie with Flare 6.1, now using Flare 2024r2.
Report bugs at http://www.madcapsoftware.com/bugs/submit.aspx.
Request features at https://www.madcapsoftware.com/feedback ... quest.aspx
Dmuir
Propeller Head
Posts: 10
Joined: Fri Sep 04, 2015 9:01 am

Re: Breadcrumb workaround

Post by Dmuir »

Matze, take a look at this thread, where we decided on a different way to approach the same problem, without using snippets. This workaround uses bookmarks instead. Look to the bottom of the thread.

viewtopic.php?f=13&t=7573
David Muir | Technical Writer | Microdea Inc. | Markham ON | Canada
NorthEast
Master Propellus Maximus
Posts: 6426
Joined: Mon Mar 05, 2007 8:33 am

Re: Breadcrumb workaround

Post by NorthEast »

Dmuir wrote:Matze, take a look at this thread, where we decided on a different way to approach the same problem, without using snippets. This workaround uses bookmarks instead. Look to the bottom of the thread.

viewtopic.php?f=13&t=7573
That doesn't actually help with the breadcrumb problem though, it only helps with getting the TOC sync to work.
Post Reply