Downloadable formats

Showing 1-12 of 12 messages
Downloadable formats Avdi Grimm 3/8/12 9:38 AM
You should all be receiving the download link for revision 9 in your inboxes. The big news is that it now comes in EPUB, Mobi (Kindle), and PDF instead of HTML.

These are not the final versions, but they are getting close. There are still some formatting nitpicks I'm working on ironing out in the next update.

It would be super helpful if as many people as possible could load their book format of choice onto their device of choice, and let me know if there are any problems with viewing it. Do the text and code listings look OK? Does the cover and table of contents come through? Do the images look OK?

Thanks!

Cheers,

--
Avdi
Re: Downloadable formats Adam 3/8/12 5:29 PM
For the PDF everything looks good in Preview on the Mac (10.6), and on the iPad in iBooks. The colors came out good and the links work. I haven't checked everything but overall it looks great.

A
Re: Downloadable formats bltavares 3/8/12 6:33 PM

Congratulations Avdi,

I've tried the Pdf and epub formats and they look great.

The colors and code format looks really nice on both formats. 



Sent from my BlackBerry® PlayBook™
www.blackberry.com





From: "Avdi Grimm" <avdi....@gmail.com>
To: "objects-...@googlegroups.com" <objects-...@googlegroups.com>
Sent: March 8, 2012 2:38 PM
Subject: Downloadable formats

You should all be receiving the download link for revision 9 in your inboxes. The big news is that it now comes in EPUB, Mobi (Kindle), and PDF instead of HTML.

These are not the final versions, but they are getting close. There are still some formatting nitpicks I'm working on ironing out in the next update.

It would be super helpful if as many people as possible could load their book format of choice onto their device of choice, and let me know if there are any problems with viewing it. Do the text and code listings look OK? Does the cover and table of contents come through? Do the images look OK?

Thanks!

Cheers,

--
Avdi
Re: Downloadable formats Rob Sharp 3/8/12 7:11 PM
Hi Avdi,

The .mobi renders pretty well on my Kindle when I view horizontally - the code wraps too often in vertical orientation to be useful.

I've noticed a few problems:

 - Figure 2.1 "What this is not" is rendered differently to the PDF,  with the .mobi using indentation instead of bold for line separation.

 - There's incorrect escaping of some symbols on code captions e.g. Exhibit.applicable\_to? should be Exhibit.applicable_to?, or Delegating \#exhibit instead of Delegating #exhibit.

 - Links appear to work correctly, as do images. However, there are occasions where image captions come through on a page on their own, for example "Validation error message" at the end of Chapter 10. I suspect there's little that can be done about that.

All in all though, it looks great!

Rob.
Re: Downloadable formats Avdi Grimm 3/8/12 7:21 PM
On Thu, Mar 8, 2012 at 10:11 PM, Rob Sharp <r...@sharp.id.au> wrote:
Hi Avdi,

The .mobi renders pretty well on my Kindle when I view horizontally - the code wraps too often in vertical orientation to be useful.

Hmm. Good to know. I'm not sure how much control I have for Kindle output; but on the off chance I can actually control the code font size, would making it smaller leave it still readable?
 
I've noticed a few problems:

 - Figure 2.1 "What this is not" is rendered differently to the PDF,  with the .mobi using indentation instead of bold for line separation.

OK.
 

 - There's incorrect escaping of some symbols on code captions e.g. Exhibit.applicable\_to? should be Exhibit.applicable_to?, or Delegating \#exhibit instead of Delegating #exhibit.

That's actually an issue in my toolchain which I've already addressed in my local version :-)
 

 - Links appear to work correctly, as do images. However, there are occasions where image captions come through on a page on their own, for example "Validation error message" at the end of Chapter 10. I suspect there's little that can be done about that.


Yeah, probably not :-/

 

All in all though, it looks great!


Thanks again for the feedback. I probably can't fix many of the issues above; the Mobi format is... how to put this... really, really awful to work with as a technical ebook author. It's basically HTML circa the 1990s and then stripped down for viewing on a PalmPilot. But I may fiddle with it a bit on the Kindle previewer.

Cheers,

--
Avdi Grimm
http://avdi.org

I only check email twice a day. to reach me sooner, go to http://awayfind.com/avdi
Re: Downloadable formats Rob Sharp 3/8/12 7:47 PM


On 9 March 2012 14:21, Avdi Grimm <av...@avdi.org> wrote:
On Thu, Mar 8, 2012 at 10:11 PM, Rob Sharp <r...@sharp.id.au> wrote:
Hi Avdi,

The .mobi renders pretty well on my Kindle when I view horizontally - the code wraps too often in vertical orientation to be useful.

Hmm. Good to know. I'm not sure how much control I have for Kindle output; but on the off chance I can actually control the code font size, would making it smaller leave it still readable?

I think so - the 'code' font is significantly larger than the font used for text, even when I set the system font size to it's smallest setting.
 

 

All in all though, it looks great!


Thanks again for the feedback. I probably can't fix many of the issues above; the Mobi format is... how to put this... really, really awful to work with as a technical ebook author. It's basically HTML circa the 1990s and then stripped down for viewing on a PalmPilot. But I may fiddle with it a bit on the Kindle previewer.
 
Haha, that's fair enough.

 - Rob

Re: Downloadable formats Avdi Grimm 3/8/12 7:50 PM
On Thu, Mar 8, 2012 at 10:47 PM, Rob Sharp <r...@sharp.id.au> wrote:
I think so - the 'code' font is significantly larger than the font used for text, even when I set the system font size to it's smallest setting.

Weird, since it's actually set explicitly to "small" in the stylesheet. I'll fiddle with it.
 
Re: Downloadable formats Nikolay Sturm 3/8/12 10:56 PM
* Avdi Grimm [2012-03-08]:

> It would be super helpful if as many people as possible could load
> their book format of choice onto their device of choice, and let me
> know if there are any problems with viewing it. Do the text and code
> listings look OK?  Does the cover and table of contents come through?
> Do the images look OK?

Something weird with the cover image in the android kindle app. In the
'Home' view I see the cover image, but in the 'On Device' view I just
get the placeholder image instead.

As with most epubs/mobi, the code is quite hard to read on small devices due
to linebreaks. If there's any chance to get the code font smaller, I'd
give that a try.

In the 'Summary' on the 2nd point you write 'Your need business
objects...'. This should be 'You need...'.

The 'List of Figures' in the PDF seems broken, I can only click on links
2, 3 and 5 in ezPDF.

With Aldiko, the epub's images don't scale down, they are all a little
too wide in portrait view.

HTH,

Nikolay

--
"It's all part of my Can't-Do approach to life." Wally

Re: Downloadable formats Kerry Buckley 3/9/12 12:44 AM
The Mobi version mostly works well on my Kindle, although as Rob said the code wraps a lot in portrait mode, even using the smallest font option on the device. I'm not sure how easy this is to fix – several eBooks where the code looks good (eg Growing Object-Oriented Software and The Rails 3 Way) actually display it as images, which sounds horrible but works surprisingly well.

Some other minor glitches with the Mobi rendering:

* The captions for code blocks are shown in italics, but those for images aren't.
* All underscores and hash symbols in captions have backslashes before them, eg "stub\_module" or "The \#picture? predicate"
* Where the text refers to a specific line in a code sample, the line number is missing, eg "Note the use of stub! at line nil" in the "adding timestamps" section. Oddly, there's one (the last bullet point in section 12.2) that says "line entrysave", with the "save" being subscript.
* Incidentally, was it intentional for the Mobi to show section numbers but not figure or listing numbers, but vice versa in the PDF?
* In section 12.3, "after_save hook" renders with no underscore and "save" as subscript (this is true in the PDF too).

I also spotted a few typos as I was reading through the latest version:

* On p17 of the PDF, in the first paragraph of "a note on scale", you use an en dash, rather than the em dashes used elsewhere.
* On p27 there's a missing space in "else'spost".
* At the top of p43, shouldn't that be the Post model, rather than Posts?
* In several places you refer to dependencies being "inject-able", even though injectable (without the hyphen) is a real word.
* A couple of rogue apostrophes have crept in: "in it's place" on p86, and "that's it's purpose" on p146.
* There might be some inconsistency in the way you refer to methods in the text (or more likely it's context-dependent and I've just missed the context). Mostly you use the #method_name convention, but sometimes you omit the hash (eg render_body on p150) or use parens instead (eg exhibit() on p152).
* On p155, I'm pretty sure the possessive of class should be class's, not class'.

One comment on the actual content: when you introduce the stub_module helper, you talk about how, if you just dumbly stubbed out the module, the real one might not get loaded in later tests. Am I right in thinking that for this to work, the Rails autoloader needs to be active before the first time you use stub_module? I've had problems in the past running rspec on a directory with a mixture of isolated and integration tests – Rails isn't loaded until it reaches the first file to include spec_helper, by which time it might be too late. I might be wrong, but I don't think stub_module would help in this case.

Thanks for writing this book, and for giving access to it as a work-in-progress. The incremental versions gave me the impetus to read most parts of the book two or three times, which I think helped the ideas sink in much better than if I'd just read the final version once.

Kerry

Re: Downloadable formats Joel Meador 3/9/12 2:19 PM
Looking at it in 2 pages mode in Skim on OSX. It looks good. The margins seem Really Big.

Just took around the section I was reading previously, so this isn't complete.

In Toward Self-Rendering Objects, p. 168, “blog.entries.render(self).” is bleeding into the margin
In Appendix A, p.177, there is a link bleeding into the margin. (Patterns of Enterprise Application Architecture).
In Appendix A, p.179, the same text is bleeding into the margin.
In Appendix A, p.180, the link to Crafting Rails Applications looks strange.
Re: Downloadable formats Kerry Buckley 3/10/12 2:00 AM
Also, I just noticed that when viewing the PDF in Preview on OS X, if
I select the "Table of Contents" view, I just see the filename in the
sidebar, rather than a ToC.

Kerry
Re: Downloadable formats James Thompson 3/14/12 1:21 AM
<3 <3 <3 for the Kindle version. Thank you :-)