Re: Editors

From: Beth (BethStone21_at_hotmail.NOSPICEDHAM.com)
Date: 02/28/04


Date: Sat, 28 Feb 2004 10:28:12 -0000

Roy Jones wrote:
> Beth wrote:
> > It's perhaps not so useful for the AoA stuff because that is meant
to
> > be a "cover to cover" kind of "linear" book...but the "reference"
PDFs
> > would be real useful if they could be compiled up into one of
those
> > "CHM" files...actually, Randy, do you already have these
references as
> > HTML files on Webster? I'll take a look...if there's something
> > appropriate there then I already have downloaded Microsoft's tools
for
> > this stuff (for any "documentation" or "help" for my own programs
:)
> > and I could try putting together the ".CHM" file for you,
perhaps...
>
> I've tried this with the html version of AoA32 off of Webster and
the CHM
> comes out to about 2 1/2MB. I haven't looked into how the index and
search
> portions yet.

I just spent the day doing it too from the big long HTML version Randy
has on Webster (nothing more than splitting it up into one HTML file
for each chapter...dealing with the "index", though, is going to be a
much more complicated task...but it would be nice to have that catered
for and automated ;)...and it's come out at only 454KB with me
here...were you working directly from the PDF file or doing like I did
and simply split up the big HTML version Randy's already got?

There's also room for improving this because the big HTML file is full
of automatically generated "<A></A>" tags everywhere for the "index"
stuff...but this stuff would need to be changed and fixed now that
I've split up the file into multiple smaller files (the URLs would be
all wrong :)...so, in creating the "index" - a tricky task because the
PDF works with "page numbers", which is awkward to convert...the other
stuff is pretty "automatic" to do (which is why something as big as
the HLA reference could be done reasonably well in just a day :) but
changing the "index" into an appropriate form for the CHM file (now
that all the URLs are basically "broken" because it's in multiple
files, not just one big one :) looks like it would have to simply be a
long, hard slog through each "index" entry and the page numbers,
putting in link targets and that sort of stuff _manually_ - this stuff
will have to be "corrected" on a case by case basis...not looking
forward to that...

But I've got the stuff as a whole bunch of HTML files, one for each
"chapter" and it's good enough to simply browse around and read...the
"index" doesn't work - although this is one of the better features
available that it should be fixed - but it's still a whole lot nicer
to navigate than the PDF files...

I was about to send an Email to Randy to see if he'd be interested in
this...450KB isn't too bad considering the size of the text...it was
only because I was thinking about the Linux people too - ".CHM" files
only work with Windows' help viewer thingy - that I was going to add
some "navigation" onto the HTML files themselves (you know, a bunch of
"previous", "next", "up" links at the top of each HTML page so that
they are all linked together and can be browsed _without_ the "table
of contents" widget thingy that CHM files have :) so that Linux users
can also have it but just as a bunch of loose, separate HTML
files...just stuff them into a ZIP file or whatever...this is one of
the better things in Microsoft's decision to go with HTML for their
newer "help" stuff than the WinHelp things they had before...as a CHM
file, then that's much better because of the "contents", "index" and
"search" tabs that are always available and the compression stuff
keeping the files all together compressed, much like a ZIP file...BUT
you can also re-use the same HTML pages on a web site or as a download
for non-Windows machines where the "CHM" files aren't supported...that
was the "delay" in letting Randy know I'd done this, really...I wanted
to "fine tune" it - double-check links, add "in-page" navigation for
Linux or putting it up on Webster directly - before handing it to him,
if he's interested...

But a 450KB download off Webster doesn't seem too bad, does it? In
fact, it's 1.29MB(!!) as just one long HTML file that it's actually
much smaller as a CHM file, due to the compression that these files
use automatically for the HTML pages...

Beth :)



Relevant Pages

  • Re: Loading Memory Addresses
    ... I put all Randy's AoA html docs into ... a chm and the size went from 10MB down to 3.45MB with a 16KB ... index (chi). ... Further compression into a zip format... ...
    (alt.lang.asm)
  • Re: Any RISC OS .chm file reader?
    ... The files are given an .chm extention and are 'Compiled HTML Help files' ... turned up a discussion saying that CHM relies on ActiveX and that Firefox ... There was also comments saying it is 'Compiled HTML' and platform specific:-( ...
    (comp.sys.acorn.apps)
  • Re: Any RISC OS .chm file reader?
    ... The files are given an .chm extention and are 'Compiled HTML Help files' ... turned up a discussion saying that CHM relies on ActiveX and that Firefox ... There was also comments saying it is 'Compiled HTML' and platform specific:-( ...
    (comp.sys.acorn.apps)
  • Re: CHM to PDF
    ... > I am looking for a Linux tool to convert MS's CHM documents into PDF ... For Microsoft's Compiled HTML format, ... unless the .CHM files are set up in ways that most .CHM ...
    (comp.os.linux.misc)
  • Re: Help System
    ... I did try searching but maybe used the wrong criteria - sorry. ... see the help on Outlook 2003. ... Others, like adobe for instance, seem to use HTML pages with their own ... Either way it seems the old chm 'search', ...
    (microsoft.public.dotnet.languages.vb)