TOC as startup topic?

This forum is for all Flare issues related to the WebHelp Mobile target and skins

TOC as startup topic?

Postby owenf on Tue Jun 15, 2010 2:42 am

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?

Postby owenf on Mon Jun 21, 2010 4:11 am

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
owenf
Propeller Head
 
Posts: 48
Joined: Tue Sep 01, 2009 3:41 am

Re: TOC as startup topic?

Postby billyclark on Thu Mar 24, 2011 3:51 pm

did you ever figure this out? i don't like it starting out on the TOC either?
billyclark
Jr. Propeller Head
 
Posts: 2
Joined: Tue Jan 25, 2011 5:02 pm

Re: TOC as startup topic?

Postby owenf on Mon Jul 25, 2011 8:21 am

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
owenf
Propeller Head
 
Posts: 48
Joined: Tue Sep 01, 2009 3:41 am

Re: TOC as startup topic?

Postby Ling on Wed Aug 15, 2012 1:59 pm

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!
Ling
Jr. Propeller Head
 
Posts: 2
Joined: Mon Jul 30, 2012 11:22 am

Re: TOC as startup topic?

Postby owenf on Fri Sep 14, 2012 3:04 am

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
owenf
Propeller Head
 
Posts: 48
Joined: Tue Sep 01, 2009 3:41 am

Re: TOC as startup topic?

Postby tomjohnson1492 on Sun Nov 11, 2012 10:10 am

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/Advanced/Resources/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
tomjohnson1492
Propeller Head
 
Posts: 90
Joined: Wed Nov 07, 2007 11:08 pm
Location: Salt Lake City

Re: TOC as startup topic?

Postby rob hollinger on Tue Nov 13, 2012 6:41 pm

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

http://www.madcapsoftware.com/blog/2012 ... plication/
Rob Hollinger
MadCap Software
rob hollinger
Propellus Maximus
 
Posts: 659
Joined: Mon Mar 17, 2008 8:40 am

Re: TOC as startup topic?

Postby dkramp on Thu Feb 21, 2013 10:36 am

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.
dkramp
Jr. Propeller Head
 
Posts: 3
Joined: Thu Feb 21, 2013 9:58 am

Re: TOC as startup topic?

Postby Doug Eaton on Fri Apr 05, 2013 10:50 am

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.
Doug Eaton
Propeller Head
 
Posts: 68
Joined: Tue Feb 19, 2008 9:47 am

Re: TOC as startup topic?

Postby dreamer09 on Fri May 24, 2013 12:41 pm

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.
dreamer09
Jr. Propeller Head
 
Posts: 2
Joined: Fri May 24, 2013 11:15 am

Re: TOC as startup topic?

Postby owenf on Tue Mar 18, 2014 2:03 pm

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
owenf
Propeller Head
 
Posts: 48
Joined: Tue Sep 01, 2009 3:41 am

Re: TOC as startup topic?

Postby kwag_myers on Wed Mar 11, 2015 12:09 pm

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
kwag_myers
Propellus Maximus
 
Posts: 808
Joined: Wed Jul 25, 2012 11:36 am
Location: Ann Arbor, MI


Return to WebHelp Mobile

Who is online

Users browsing this forum: No registered users and 1 guest