Tutorial - How to Create a MobiPocket eBook

[HarryT]

The attached file is a detailed tutorial showing how to create a MobiPocket eBook using the freely available tools of Book Designer and MobiPocket Creator. It starts off with the assumption that you've already created and edited the book in Book Designer, and shows you how to go from the BD book to a properly-formatted MobiPocket book with large images, a functioning "Table of Contents" menu item, and so on.

Comments or suggestions for improvements are of course welcome.

There are two attachments: the tutorial itself in Word format, and a file "sample.zip" containing the sample files used in the tutorial, so you can "follow along" with it.

Hope that this is useful to people.

EDIT: Proofread the document and corrected a dozen or so minor typos. Uploaded v1.02.

This work is in the Canadian public domain OR the copyright holder has given specific permission for distribution. It may still be under copyright in some countries. If you live outside Canada, check your country's copyright laws. If the book is under copyright in your country, do not download or redistribute this work.

To report a copyright violation you can contact us here.

[Sparrow]

Thanks Harry - the tutorial worked perfectly - I'm looking forward to doing it for 'real'.

The only typos I spotted were:

you’ll see that the Creator was created a new folder
you’ll see that the Creator has created a new folder

you’ll see the “Build completed” screen
you’ll see the “Build finished” screen


Also, should there be an instruction to click the Build icon in:
"Again, click the Update button. This takes us to the “Build publication” page:" ?

[HarryT]

Originally Posted by Sparrow

Thanks Harry - the tutorial worked perfectly - I'm looking forward to doing it for 'real'.

The only typos I spotted were:

you’ll see that the Creator was created a new folder
you’ll see that the Creator has created a new folder

you’ll see the “Build completed” screen
you’ll see the “Build finished” screen

Thanks! I've corrected these errors and uploaded a new v1.01.

Also, should there be an instruction to click the Build icon in:
"Again, click the Update button. This takes us to the “Build publication” page:" ?

No. Clicking "Update" from the "Settings" page takes you straight to the "Build" screen.

[HarryT]

I should add, by the way, that there's considerable room for "shortcuts" in the process described.

If you've worked through the tutorial I'm sure you've realise that the "Mobi Creator" program is basically a tool for creating and editing the ".opf" file. This is an XML file which describes the contents and layout of the book "package".

If you stick with calling the book file "book.html", all you have to do to create a new book is:

1. Create a folder.
2. Copy the HTML file and any image files into the folder.
3. Copy the "book.opf" from your last book into the folder.
4. Double click the "book.opf" file to open it in Mobi Creator.
5. Edit the metadata - title, author, etc.
6. Build the book.

This is because everything in the opf file except the book's metadata is the same from book to book, provided you stick with the same naming for the book HTML file and its tags.

The tutorial mentions only one of the "custom tags" that you can put into your HTML document - the "<mbpagebreak/>" which forces a pagebreak. There are lots of other tags you can use to provide more detailed control over the formatting of your document - they are documented on the MobiPocket developer web site at the link below:

http://www.mobipocket.com/dev/articl...eFolder=prcgen

[PeterT]

Thanks I'm delighted to see this. I had looked at BD for making Mobipocket's and my main issue was the formatting. I really HATE fully justified documents; much preferring the use of non justified text.

Now it's time to sit down and really figure out HOW to use BD and I'm all set to go

[Strether]

Harry, what would happen if you didn't add the "start reading" tag? At first blush, it seems like you could get to the text just by clicking on Chapter 1 of the TOC?

I know that you say it's useful in the Mobipocket Reader, but if you're viewing the file in, say, a Kindle, is that tag necessary?

Jim

[HarryT]

Originally Posted by Strether

Harry, what would happen if you didn't add the "start reading" tag? At first blush, it seems like you could get to the text just by clicking on Chapter 1 of the TOC?

I know that you say it's useful in the Mobipocket Reader, but if you're viewing the file in, say, a Kindle, is that tag necessary?

Jim

The "Guide" items add entries to a navigation menu on MobiPocket Reader, and the CyBook Gen3, and enable navigation icons on the iLiad. The "Table of Contents" and "Start Reading" items are standard ones, but if you don't have them all that happens is that those items don't appear on the navigation menu on the Gen3, and the corresponding buttons remain disabled on the iLiad.

I don't know what use the Kindle makes of them or otherwise. You are absolutely right - "Start Reading" does seem a little pointless, but it does appear to be a "standard" item, and it's no real work to add it.

"Table of Contents" is genuinely useful - I would certainly always add that one.

In case I didn't make it clear in the tutorial, you can add any extra items you want in "Guide Items" - they are just links to specific places in the book defined by anchor tags, so if you had a book which had some special places you wanted to be able to quickly jump to, you could add additional guide items to enable the user to jump directly to those places.

[Strether]

The Kindle menu doesn't have a "start reading" option, but just " go to toc" and "start at beginning." When I opened your new edition of Bleak House it opened at Chapter 1, which confused me. I had to backtrack to the book title, author's picture (which was what I was looking for to see how that had turned out), and toc. I'm guessing now it was responding to your second tag.

Since I don't especially want a book to open at the beginning text, I think the first one I try I'm going to omit that tag and see how it turns out. I'll try something without a picture, too.

Bleak House, by the way, looks terrific. I haven't read it in a while and I'll schedule it for an early re-read.

Jim

[HarryT]

Originally Posted by Strether

The Kindle menu doesn't have a "start reading" option, but just " go to toc" and "start at beginning." When I opened your new edition of Bleak House it opened at Chapter 1, which confused me. I had to backtrack to the book title, author's picture (which was what I was looking for to see how that had turned out), and toc. I'm guessing now it was responding to your second tag.

That's interesting, and does appear to be something that's specific to the Kindle. When you open a book for the first time on the Gen3, it displays the cover image and then starts from the beginning of the book; it's only by selecting the "Start Reading" menu item that you get taken to the Preface, which is the point defined to be the start of the "text proper" in that particular book.

I've followed the "documented procedure" for creating Guide items, so forgive me if I carry on creating books this way.

[tompe]

Originally Posted by HarryT

The "Guide" items add entries to a navigation menu on MobiPocket Reader, and the CyBook Gen3, and enable navigation icons on the iLiad. The "Table of Contents" and "Start Reading" items are standard ones, but if you don't have them all that happens is that those items don't appear on the navigation menu on the Gen3, and the corresponding buttons remain disabled on the iLiad.

Did you check that you did not get two "Start Reading" in the goto menu on the Cybook? I think I managed to get duplications of one of the entry that is always there when I played around with this a couple of weeks ago.

[HarryT]

I do get two of them, yes . I don't know of any way to avoid that - do you?

[tompe]

Originally Posted by HarryT

I do get two of them, yes . I don't know of any way to avoid that - do you?

No. But as I understood it you can call the action anything you want so maybe just calling it something else might avoid some confusion. Or maybe people will get more confused having two different entries for the same thing.

[HarryT]

Originally Posted by tompe

No. But as I understood it you can call the action anything you want so maybe just calling it something else might avoid some confusion. Or maybe people will get more confused having two different entries for the same thing.

I suppose it's a question of whether it's less confusing to have two identical menu items which do the same thing, or two different menu items which do the same thing. Doesn't really matter either way.

[tompe]

Originally Posted by HarryT

I suppose it's a question of whether it's less confusing to have two identical menu items which do the same thing, or two different menu items which do the same thing. Doesn't really matter either way.

I seem to remember now that in the example book I tested they were not identical. But maybe that was just that book.

[DMcCunney]

Originally Posted by HarryT

The attached file is a detailed tutorial showing how to create a MobiPocket eBook using the freely available tools of Book Designer and MobiPocket Creator. It starts off with the assumption that you've already created and edited the book in Book Designer, and shows you how to go from the BD book to a properly-formatted MobiPocket book with large images, a functioning "Table of Contents" menu item, and so on.

Comments or suggestions for improvements are of course welcome.

Harry, I read through it and it's clear and concise. Thank you.

Down the road a bit, I may experiment with the command line converter, and see about scripted Mobi file generation.

One question for the group mind, however: MobiPocket Creator offers three compression options: None, Standard, and High.

I played a bit, creating a test Mobi file with each option, and all were handled just fine on my device, which is a Palm OS PDA running v5.3 beta of MobiReader for PalmOS, and by the current 6.1 MobiReader for Windows.

My inclination is to create Mobi documents using High compression, simply because there's no such thing as enough storage space. My question is whether that is known to be supported on all devices that can read Mobi files. Yes, it takes a lot longer to generate Mobi files using High compression, but I don't care. My computer is doing the work.

Comments?
______
Dennis