This is still a beta release (and is not yet shown on the I7 page on my website – the link above is the only way to get it). I’d very much appreciate it if two or three public-spirited citizens could give it a quick read and let me know about any errors or significant omissions. If you don’t have time to read the whole thing (which would certainly be understandable), it’s perfectly okay to pick a chapter or two and let me know about any problems you spot.
All of the code examples have been edited for 6L38 compatibility. Barring a typo or two, they should work. There are new explanations here and there, and I’ve adjusted the text where necessary to address various changes. (There’s no discussion of procedural rules or indexed text, for instance.) It’s not a complete rewrite, but it has been re-edited from start to finish.
PM me or just reply to this thread, your choice. All comments gratefully received.
HanonO, I’ve converted it using Calibre to an epub which I can use on my Kobo. I can post the resulting file here if Jim has no problem with me doing that, or you can always download Calibre and convert it yourself, if you prefer.
Thanks for the tip on Calibre. I have now converted the beta version of the Handbook from PDF to epub … but I don’t have an epub reader on my Windows PC, so I have no way to look at the converted file.
The epub readers I’m finding online don’t look promising. User reviews suggest they’re mostly crap, and try to install a bunch of other stuff during installation. (Hijackware, and yeah, I just made up that word.)
Can anyone suggest a good epub reader for Windows? (Preferably free, but I don’t insist.)
I believe Firefox has a good ebook-reading plugin (which of course works across platforms, but I cannot remember the name) but I’m not aware of anything except Calibre itself which opens ebooks on Windows or Linux.
I’ve done the Calibre thing and will sideload onto my Kobo Touch in a moment and report back.
The Firefox add-on can open the epub document exported by Calibre based on my PDF, but it’s a godawful mess. I have no idea whether the add-on is at fault, or Calibre, or whether I need to code my .odt file somehow to deal with the issue(s).
And in fact, Calibre’s own display of the epub file is crap. Weird line breaks, a complete loss of formatting in the code examples, page numbers floating in between lines of text – and if you click on any of the internal cross-reference links, you’re popped back up to the first page.
I’m certainly open to the idea of producing an epub-format edition, but since the Handbook is free, I’m not too keen to spend a bunch of money buying a capable epub-capable program. Suggestions welcome!
Turns out, if I convert directly from .odt to epub using Calibre, bypassing the PDF stage, the results are much better. But not perfect. The code examples are in blue (yay!), but all of their tab-based indents are lost (boo, hiss!). Text no longer wraps the graphics, but that’s okay. Loss of indents, not okay.