Offline help files
-
- Jr. Propeller Head
- Posts: 3
- Joined: Mon Mar 22, 2021 11:52 am
Offline help files
What are your most efficient ways of providing access to help files? We are exploring possibilities to be able to download help files in HTML5 format per release of our software.
Re: Offline help files
For offline access, we install the help (HTML5) as part of the software installation.
-
- Jr. Propeller Head
- Posts: 3
- Joined: Mon Mar 22, 2021 11:52 am
Re: Offline help files
Thank you for your reply, Dave. And how do you keep it up-to-date?
Re: Offline help files
It's part of the software installation - so when you install a new software update, that includes the updated help too.
Help isn't updated independently of the software.
Our installed offline help is only displayed if a customer doesn't have internet access.
If the customer has internet access, they see the online version of the help.
Help isn't updated independently of the software.
Our installed offline help is only displayed if a customer doesn't have internet access.
If the customer has internet access, they see the online version of the help.
-
- Senior Propellus Maximus
- Posts: 2632
- Joined: Wed Apr 14, 2010 8:01 am
- Location: Surrey, UK
Re: Offline help files
How do you put this in place? I'm trying to persuade our lot to change from CHM to HTML5 as the format for our help. Some of our users won't have online access, some will. Is this something the devs need to do or is there anything we can help with with what we provide them?Dave Lee wrote:It's part of the software installation - so when you install a new software update, that includes the updated help too.
Help isn't updated independently of the software.
Our installed offline help is only displayed if a customer doesn't have internet access.
If the customer has internet access, they see the online version of the help.
If a user has intermittent internet access, does their usage information while they were offline get passed to Central, or only if they're using help while they're online?
Started as a newbie with Flare 6.1, now using Flare 2023.
Report bugs at http://www.madcapsoftware.com/bugs/submit.aspx.
Request features at https://www.madcapsoftware.com/feedback ... quest.aspx
Report bugs at http://www.madcapsoftware.com/bugs/submit.aspx.
Request features at https://www.madcapsoftware.com/feedback ... quest.aspx
Re: Offline help files
We have HTML5 help, and a copy is installed to the PC's local file system as part of the app installation.ChoccieMuffin wrote:How do you put this in place? I'm trying to persuade our lot to change from CHM to HTML5 as the format for our help. Some of our users won't have online access, some will. Is this something the devs need to do or is there anything we can help with with what we provide them?
If a user has intermittent internet access, does their usage information while they were offline get passed to Central, or only if they're using help while they're online?
Our devs included code in the app that detects if you have internet access. I think it works by pinging our website, and seeing if it gets a response.
* If there's no internet access, then help links are directed to the locally installed help on their PC - e.g. file://xxx/yourapp/help/Default.htm
* If there is internet access, then help links are directed to the online help - e.g. https://www.yourcompany.com/help/Default.htm
So the first part of the URL isn't hard-coded, and is switched depending on whether you have access.
We don't use Central, and no offline information is recorded or sent when you go online. We use Google Analytics, and obviously that will only record data when the user is online.
The app itself can be used offline if you need to, so the help also needed to work in a completely offline scenario.
-
- Senior Propellus Maximus
- Posts: 2632
- Joined: Wed Apr 14, 2010 8:01 am
- Location: Surrey, UK
Re: Offline help files
Dave, a STERLING response, as always!
Thanks, I thought it'd be something like that but it's always good to get some confirmation from an expert.
Thanks, I thought it'd be something like that but it's always good to get some confirmation from an expert.
Started as a newbie with Flare 6.1, now using Flare 2023.
Report bugs at http://www.madcapsoftware.com/bugs/submit.aspx.
Request features at https://www.madcapsoftware.com/feedback ... quest.aspx
Report bugs at http://www.madcapsoftware.com/bugs/submit.aspx.
Request features at https://www.madcapsoftware.com/feedback ... quest.aspx