Webhelp responsive index.html file
Post here questions and problems related to editing and publishing DITA content.
-
- Posts: 2
- Joined: Thu Aug 01, 2019 8:32 pm
Webhelp responsive index.html file
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.
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.
-
- Posts: 846
- Joined: Mon Dec 05, 2011 6:04 pm
Re: Webhelp responsive index.html file
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
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
oXygen XML Editor and Author Support
-
- Posts: 2
- Joined: Thu Aug 01, 2019 8:32 pm
Re: Webhelp responsive index.html file
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?
-
- Posts: 846
- Joined: Mon Dec 05, 2011 6:04 pm
Re: Webhelp responsive index.html file
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
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
oXygen XML Editor and Author Support
-
- Posts: 167
- Joined: Tue Mar 06, 2018 1:34 am
Re: Webhelp responsive index.html file
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.
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.
Return to “DITA (Editing and Publishing DITA Content)”
Jump to
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ SDK-API, Frameworks - Document Types
- ↳ DocBook
- ↳ TEI
- ↳ XHTML
- ↳ Other Issues
- Oxygen XML Web Author
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Content Fusion
- ↳ Feature Request
- ↳ Common Problems
- Oxygen JSON Editor
- ↳ Feature Request
- ↳ Common Problems
- Oxygen PDF Chemistry
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Feedback
- ↳ Feature Request
- ↳ Common Problems
- Oxygen XML WebHelp
- ↳ Feature Request
- ↳ Common Problems
- XML
- ↳ General XML Questions
- ↳ XSLT and FOP
- ↳ XML Schemas
- ↳ XQuery
- NVDL
- ↳ General NVDL Issues
- ↳ oNVDL Related Issues
- XML Services Market
- ↳ Offer a Service