Page 1 of 1

Webhelp responsive index.html file

Posted: Thu Aug 01, 2019 8:38 pm
by ajod
I need to rename the index.html file the webhelp responsive transformation scenario creates to default.htm

I used the args.outext parameter to change all the extensions to htm, which is great. But there doesn't seem to be anything to change the name. Is there a parameter or some simple transformation option I am missing?

Thanks.

Re: Webhelp responsive index.html file

Posted: Mon Aug 05, 2019 11:05 am
by Costin
Hello,

It is not possible in the current implementation of WebHelp to rename the index.html main page.
However, we already have an open issue logged in our internal improvements tracking system, so our developers analyze this possibility for a future version of oXygen.

I've logged your vote for this feature on the open issue and we will update this thread when/if this gets implemented.

Best Regards,
Costin

Re: Webhelp responsive index.html file

Posted: Thu Aug 08, 2019 7:13 pm
by ajod
For reasons they don't feel the need to explain to me, our devops team requires this file be named default.htm. So I have manually renamed it. This works fine except the Home breadcrumb is now broken because it points to index.htm. Is there a way for me to change that?

Re: Webhelp responsive index.html file

Posted: Fri Aug 09, 2019 10:58 am
by Costin
Hi,

Manually renaming won't work, as it could change the WebHelp output behavior, leading to problems..
Like I mentioned in my previous reply, we have an improvement request logged in our system and we will update this thread when/if this will be implemented by our development team.

Meanwhile, indeed, performing a find/replace action to find all the links that point to the index.html file and replace its name to default.htm seems the only solution.

Regards,
Costin

Re: Webhelp responsive index.html file

Posted: Tue Aug 13, 2019 3:36 am
by mdslup
ajod,

I was in a similar situation. I wanted mobile users to end up on the index.html page, but I wanted desktop users to come straight to the content of the manual (and not see the tile or tree layout).

To do this, I added a dummy file as the first topic in the map...mine was called "welcome" (but you could call yours "default") that simply said, "Welcome to the manual." Then, I used the webhelp.fragment.welcome parameter. This parameter lets you insert HTML in the head of index.html (and not any child pages). The HTML code pointed to a javascript file which contained a redirect to the welcome file. So you could use that same strategy:

1. Create a file called "default" that just says "Welcome to the manual", make it first child in map
2. Use webhelp.fragment.welcome parameter to reference HTML file
3. Use HTML file to reference javascript with redirect

Now when someone goes to your site, the index.html will bypass the trees/tiles and jump straight to the content of the manual, with the navigation menu on the left...since your first topic is "default" and you made it look like a welcome screen, your users are none the wiser.

Let me know if you have any questions.