Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Help - Move from .chm to a new format #437
Spun of from #436.
NB. Currently from toc.html it's not possible to navigate to all parts of the help... ie. more TOC items need adding.
referenced this issue
Jul 19, 2017
Yes, the more hyperlinking the better.
The other alternative that would still keep the hyperlinks is converting the HTML docs to a PDF. That way there's just one file.
One easy way to do this is with:
I've attached a simple test below. I've used this before but not extensively, so there are probably better ways. For instance it can generate a TOC, but I've just used our existing one - though content is imported in the order you supply the file names, so I've put toc first.
There are some other ideas here:
Here's a batch file I threw together. Would be better to do this in PowerShell perhaps.
And here's your new AppleWin Manual!
OK, so I just need to reorder the input of the pages and then the PDF will read in the right sequence.
I have no problem in switching from CHM to PDF though.
Another alternative (to PDF) is just to move all the help online and host (as HTML / wiki) on github, eg:
A (small) advantage is the separation of the help from the main release so that you can update the help without needing to do a new release (not that we've ever needed to do this).
Equally this is a disadvantage, since the online docs will only match the latest AppleWin release, so if you are running an older version, then you won't have access to accurate docs.
Anyway, the PDF is dead easy to generate, so let's switch to that.
I thought the original chm file worked well enough. But I suppose if a change has to be made, then PDF would be the next choice as opposed to online browser-accessed help.
Several other programs I work with went the online-html route for a while and came full circle back to locally saved chm/pdf/doc files.
All versions can still be generated. It's just a question of what we distribute. There's still the option of getting and using the HTML files locally, or maybe even merging them into one HTML file with something like this: https://sourceforge.net/projects/htmlmg/files/ Cheers, Nick.
Nick - given the recent discussion about ADS on csa2p, see this thread: "ProBLOAD (a DOS 3.3 tiny extension)". this is exactly how the AppleWin.chm is blocked.
So all we need to do is delete the AppleWin.chm:Zone.Identifier ADS.
We could do this each time AppleWin is run (obviously it only needs to be done once, but AppleWin has no memory of if it has been run before; also it doesn't cause a problem to delete a non-existent stream).
Also it's simple: the standard DeleteFile() Win32 API function supports this:
So should we just stick with CHM's and apply the above DeleteFile() fix?
NB. I downloaded an AppleWin.zip (from github applewin), and it has the ZID ADS. When I extracted using 7-zip, then the ADS was not applied to AppleWin.chm. So I assume only users that use Windows' built-in zip support get the ZID ADS attached to their AppleWin.chm file (or they have directly downloaded it from the web, eg. from the github applewin repo).
For what it's worth I strongly prefer the .CHM help file format. As do some of my colleagues.
Killing or otherwise setting the ADS to something else is a good solution. If and when I have "chm troubles" I usually right-click and select "unblock" and all is well. That on windows os.