TOC as startup topic?

This forum is for all Flare issues related to the WebHelp Mobile target and skins
Post Reply
owenf
Propeller Head
Posts: 48
Joined: Tue Sep 01, 2009 3:41 am

TOC as startup topic?

Post by owenf »

Hi there,

i've just finished an iPhone help system and everything worked really well without much tweaking. hooray! that's the good news. The bad news is that users need an extra tap to get into it. imo, going straight into the TOC would be much better, from a usability perspective, than going into the nav menu for index, TOC, browse sequences etc - all of which i've turned off except Search and TOC.
Does anyone know if it's possible to get Flare to open the TOC as the startup topic in webhelp mobile? I have read about startup topics in the help but they apparently aren't supported in webhelp mobile.
Is there a post-output workaround that people are using, maybe redirecting from default.htm after all the scripts etc have run?

i would be grateful for any pointers.
thanks,
Owen
owenf
Propeller Head
Posts: 48
Joined: Tue Sep 01, 2009 3:41 am

Re: TOC as startup topic?

Post by owenf »

i tried doing a redirect from the default.htm to toc_0.htm which worked just dandy. don't know what else i broke in the process though, although i do know i don't have the search field anymore. i put the meta refresh type of redirect in just before the end of the head section. there is a lot of madcap generated javascript in the head that looks like it's deliberately setting the landing page, so i probably am courting danger. oh well. still looking forward to hearing if anyone else out there has a fix for this issue

cheers
owen
billyclark
Jr. Propeller Head
Posts: 2
Joined: Tue Jan 25, 2011 5:02 pm

Re: TOC as startup topic?

Post by billyclark »

did you ever figure this out? i don't like it starting out on the TOC either?
owenf
Propeller Head
Posts: 48
Joined: Tue Sep 01, 2009 3:41 am

Re: TOC as startup topic?

Post by owenf »

a redirect worked as i posted above. i can't remember exactly the details, but essentially you tell the iphone browser to go to a different page than the one it loads when the help opens. i can't give you the source though as i stopped working at the place where i did that. good luck.
owen
Ling
Jr. Propeller Head
Posts: 2
Joined: Mon Jul 30, 2012 11:22 am

Re: TOC as startup topic?

Post by Ling »

Has anyone else come up with a solution?

Does this redirect also work on Android and Windows phones, or only on iPhones?

Thanks in advance for any advice!
owenf
Propeller Head
Posts: 48
Joined: Tue Sep 01, 2009 3:41 am

Re: TOC as startup topic?

Post by owenf »

it's pretty standard html practice, although sometimes security stuff doesn't like it, so i would say give it a try and see how you get on. i've not worked on mobile outputs in a while, but your devs should easily help you with the redirect
tomjohnson1492
Propeller Head
Posts: 90
Joined: Wed Nov 07, 2007 11:08 pm
Location: Salt Lake City
Contact:

Re: TOC as startup topic?

Post by tomjohnson1492 »

I agree that requiring users to tap the Table of Contents option to go directly into the real list of help topics adds an extra, unnecessary step. Presumably that homepage on the mobile webhelp shows a larger menu: Table of Contents, Index, Glossary, and About. However, the Index and About options aren't that helpful in my situation, so that leaves just the Table of Contents and Index. You can see my mobile webhelp here: https://ue.ldschurch.org/mobile/gla.

When users drill into the Table of Contents, that URL becomes https://ue.ldschurch.org/mobile/gla/Adv ... /Toc_0.htm. I could set URL as the default URL for help, but the problem is that the Home button in the skin always redirects to the view that has the Table of Contents and Index, not the direct list of topics.

Apart from hacking the output to change the URL to the home button (a tedious process if you regenerate your target frequently), I don't see any solution.
-------------
my blog/podcast: http://www.idratherbewriting.com
rob hollinger
Propellus Maximus
Posts: 661
Joined: Mon Mar 17, 2008 8:40 am

Re: TOC as startup topic?

Post by rob hollinger »

This blog post should help getting the TOC as a startup topic.

http://www.madcapsoftware.com/blog/2012 ... plication/
Rob Hollinger
MadCap Software
dkramp
Jr. Propeller Head
Posts: 3
Joined: Thu Feb 21, 2013 9:58 am

Re: TOC as startup topic?

Post by dkramp »

Hello Rob,

I followed that blog post and unless I missed something that process has to be done after every "Build Primary" correct? It seems when you run Build Primary it essentially reverts the coding I edited back to the original.

It's almost like you need to build primary first, then modify the coding, then send your final package for upload.

I just want to clarify. Thank you.
Doug Eaton
Propeller Head
Posts: 68
Joined: Tue Feb 19, 2008 9:47 am

Re: TOC as startup topic?

Post by Doug Eaton »

dkramp wrote:... unless I missed something that process has to be done after every "Build Primary" correct?

You did not miss anything. This procedure works great, but it is "post-processing." You have to do it after Flare does its magic. Every time you generate the target.
dreamer09
Jr. Propeller Head
Posts: 2
Joined: Fri May 24, 2013 11:15 am

Re: TOC as startup topic?

Post by dreamer09 »

Is there a way to have a single topic as the first page? I want users to click through a series of steps - so each step is going to be a topic.

My goal is to have a specific topic open up first, then use the "PreviousTopic" and "NextTopic" toolbar buttons to have users click through the steps. I have the toolbar working.. but its still taking two clicks ( "TOC" and "Step 1" off of the TOC menu) before you get to that first step.
owenf
Propeller Head
Posts: 48
Joined: Tue Sep 01, 2009 3:41 am

Re: TOC as startup topic?

Post by owenf »

the meta refresh should work to direct user from default for any topic, not just loading the TOC. also, less work to put the refresh in the head of default after the build than to do the other hack (copying the contents of TOC 0 into default ul). you might even be able to put the refresh in before the build though i haven't tried it..

all this might be a waste of effort if you go for the full banana flare 10 responsive webhelp2, tho i haven't personally tried it.

the internet abounds with places to tell you how to do the redirect, eg. http://www.w3.org/TR/WCAG20-TECHS/H76
kwag_myers
Propellus Maximus
Posts: 810
Joined: Wed Jul 25, 2012 11:36 am
Location: Ann Arbor, MI

Re: TOC as startup topic?

Post by kwag_myers »

Put this in the <head> section of ...\Output\WebHelpMobile\Advanced\Default.htm and Save:

Code: Select all

<meta http-equiv="refresh" content="0; URL='Resources/Toc_0.htm'">
In Flare, click View Primary to verify it works. Then make a copy of the Default.htm file somewhere outside of the Output folder and copy over the Default.htm after each build. Here's a VBScript I use for this purpose:

Code: Select all

dim filesys

set filesys=CreateObject("Scripting.FileSystemObject")

' NOTE: Revise this directory to where your good Default.htm file resides
If filesys.FileExists("Z:\MobileProject\Default.htm") Then

' NOTE: The first directory is the same as above. The second is the output folder.
filesys.CopyFile "Z:\MobileProject\Default.htm", "C:\Users\kwag_myers\Documents\MobileProject\Output\WebHelpMobile\Advanced\"

End If

MsgBox "Ta Da! \0/" & strMsg, vbInformation, "Done!"

WScript.Quit "
"I'm tryin' to think, but nothin' happens!" - Curly Joe Howard
Post Reply