Webhelp responsive index.html file

Post here questions and problems related to editing and publishing DITA content.
ajod
Posts: 2
Joined: Thu Aug 01, 2019 8:32 pm

Webhelp responsive index.html file

Post 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.
Costin
Posts: 833
Joined: Mon Dec 05, 2011 6:04 pm

Re: Webhelp responsive index.html file

Post 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
Costin Sandoi
oXygen XML Editor and Author Support
ajod
Posts: 2
Joined: Thu Aug 01, 2019 8:32 pm

Re: Webhelp responsive index.html file

Post 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?
Costin
Posts: 833
Joined: Mon Dec 05, 2011 6:04 pm

Re: Webhelp responsive index.html file

Post 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
Costin Sandoi
oXygen XML Editor and Author Support
mdslup
Posts: 167
Joined: Tue Mar 06, 2018 1:34 am

Re: Webhelp responsive index.html file

Post 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.
Post Reply