Showing posts with label mobipocket creator. Show all posts
Showing posts with label mobipocket creator. Show all posts

Tuesday, July 16, 2013

New Adventures in Mobi Creation

No, not the whale, but the program that creates the digital book for Amazon’s Kindle (though at the moment I’m ready to put the great white whale’s last name to the whole evolution and refer to it by the crude vernacular). Since readers have their accounts set up and click a button to download their Kindle Book to their Kindle device all in a matter of seconds, an author needs her book in the Kindle Store. To get it there, she must create her masterpiece in .mobi format.

Getting my latest novel, Camellia Creek, a gothic mystery/suspense set against the backdrop of  Presidential Reconstruction at the end of the War for Southern Independence, into mobipocket, .azw format, took days, untold hours I wish I’d actually recorded so you could more clearly understand how absolutely anal I am. For those of you who have looked at my blog for “technical” advice, no matter how unintentionally spurious, you know that over a year ago I blogged extensively about my creation of the files required by MobiPocket Creator to build a mobi book. With those files—sitting in the folder for each individual book in the “My Publications” folder associated with MobiPocket Creator—I managed in 2011-2012 to upload my first four books and get them in the Amazon Kindle Store. Camellia Creek, thought I, will be a piece of cake.

Wrong. Oh, I created the files easily enough based on templates I’d created from my first four books—the .html version of my book, the .ncx file, a proper version of the .opf (MobiPocket Creator creates an .opf file automatically from whatever data one feeds it—if one feeds it no extra data, it creates it from the .html file itself and it always overrides whatever .opf file you place in the folder so you have to keep checking and cutting and pasting your good one over the one it makes. Suffice it to say, that evolution is time consuming and frustrating.). Then I added my only two graphics—the cover and my logo.

For four days I tried to get MobiPocket Creator to build my book. Now, I didn’t sit in front of my computer uploading and re-uploading the same files over and over during that time with the expectation of one time getting a winning result. That folks, is the definition of stupid. I’m just sorta stupid for sticking with it all that time. I’d make changes to the .opf and tried different renditions; I checked and rechecked all my files, my headers, my content, my “#$!%” html. I even removed MobiPocket Creator and reinstalled it—on both the computers I own with access to the internet. One thing I did discover was that every time I took the “failed” build and removed the .ncx from the mix, the book built. I knew the problem was with the .ncx or the .opf (which references the .ncx). I went to the online forums and studied and tried to replicate individual methods of inserting files into MobiPocket Creator and overcoming the Creator’s frustrating habit of messing up my .opf. At one point I created a .zip file of Camellia Creek’s files and attempted to insert that into the My Publications folder. That didn’t work either—works for epub, but not mobi. I kept the .zip file anyway.

Finally, on the fifth day, I removed the publisher version of  MobiPocket Creator and downloaded the “Home/Family” version. The MobiPocket Creator website said it was simpler to use. Personally, I didn’t see much difference from the “use” angle, but one thing that simple little sucker did when it, too, failed to build on my first try was point out one tiny error in the spelling in the “content src” for chapter seventy-four in my .ncx. I’d spelled “seventy” “seveenty”. I fixed it and Camellia Creek build on the next try, .opf, .ncx and all.

I don’t know that the misspelling caused all those wasted hours, not to mention stress, but the results rendered after its fixing indicates that was the problem. So why didn’t the “publisher” version point it out to me when the “simpleton’s” version was so quick to do so? Maybe the publisher’s version thinks publishers should know how to spell or are such thorough proof readers there is no way they’d let a screwball thing like three “e”s in seventy get by—this in a work of 79 chapters and an epilogue (Camellia Creek is twice the length of my previous books).

Oh, and now comes the really, really good part. I start uploading to Amazon—I get to Part 5 at the “Upload Your Book” window. The little pinwheel is purring, there’s a window there that says “uploading your book, this may take a few minutes” and wahlah—the KDP (Kindle Direct Publishing) platform rejects it. The window says, simply, that I used software other than that approved by Amazon. I’m confused—I sent them the .prc. KDP didn’t need to build my .prc. I SENT it one already done, darn it! And fifteen months earlier the KDP platform had accepted four of my .prc books built the same way—ok, this one was built with the “simpleton’s” Creator, but what the heck.

I go to the “formatting guide” offered in the rejection window. Sure enough, .prc’s aren’t listed. I go to the Amazon “techies”. “Yes they are,” the “techies” say. Two day’s later the “techies” have it figured out—I needed to use KindleGen to build my .prc, not MobiPocket Creator.

During that two-day interim, I went back to that “zipped” file I’d fortuitously saved during my nightmare of working with the publishers version of MobiPocket Creator and uploaded it at Part 5 of the Upload Your Book window. It uploaded fine. Camellia Creek is at the Kindle Store.

Next, my pathetic adventures using KindleGen.

Saturday, March 17, 2012

Book Two in Mobipocket Didn’t Prove to be the Charm, But It Is Closer

     As promised, I’m updating y’all on what transpired when I created my second mobipocket book using the templates I created back in December 2011/January 2012.
    I’m pleased to announce that I uploaded Epico Bayou to Amazon’s Kindle Store this week. I’d given myself a week to get it done, but it took me eight days from beginning to actually building the .prc, but most of that time was spent formatting the book in .html.
     The good news is that the templates for my .toc.ncx file (navigational table of contents) and the .opf  file (open package ebook format) that I created with River’s Bend worked beautifully. All I had to do was copy them into a new document, change the name of the .html file embedded in them, and make any other necessary changes. For example: River’s Bend had two more chapters than Epico Bayou, so I removed a couple of the “nav points” from Epico Bayou’s toc.ncx file.
     The same was true for the embedded Table of Contents (TOC). I copied the entire .html formatted beginning of River’s Bend down to Chapter One, then pasted it into a new document. Then I added the text of Epico Bayou. That I got by taking my Smashwords Word.doc and converting it to a filtered Word (.html) document. I started formatting from there. That aforementioned beginning to all my books (and I imagine most of you out there are like me) is generic and includes the .html document head, style sheet, title and copyright pages, and Table of Contents. Again, it was simply a matter of changing the references from River’s Bend to Epico Bayou.
     Now that only works if the “copier/pasterer” [yeah, I know it’s not a good word, but you get my gist. I’m talking about me] and her subsequent modifications do not corrupt the .html. The .html code does not take kindly to errors--and oh, those errors can be so hard to find in all that code. But in this particular case, it wasn’t the code that got me.
     When I first built, or tried to build, Epico Bayou, Mobipocket Creator told me, in its extremely aggravating, abbreviated manner, that the cover link was missing and the TOC couldn’t be built. Darn it! The toc.ncx was fine and there was a link to the cover in it. And as for the TOC embedded in the book? Well, I not only could “see” it--I could click on it and it worked. There was no link to the cover, but there never had been, and Rivers Bend didn’t have one in it’s embedded TOC. Things like that are easy to see. I could not figure out what The Creator’s problem was. I kept tweaking, looking, then clicking the build button over and over with the same result. Finally, I pulled up the original .html for River’s Bend [not for the first time, but I could not see any difference in the two files], did a search on “cover,” and sure enough, right after the closing of the style sheet and the </head> there was a link to the embedded cover (which shows up in the toc.ncx, but not the embedded TOC at the front of the book). That link was missing in Epico Bayou. I re-added my cover link, which I assume I’d inadvertently deleted; Mobipocket Creator dutifully “built” my book; then I uploaded it to the Kindle Store. There was a glitch there, too, but that was on Amazon’s end, thank goodness, and they fixed it.
     For more information on how I created my mobi books for the Kindle Store, go back and look at my blog posts between 9 December 2011 and 27 January 2012. My point was to create the mobi files without the help of the Mobipocket Creator (The Creator’s files appear messy and confusing to me). I can now take the files I create, place them in the “build” window, then let The Creator build the .prc, which I upload to Amazon’s DTP.
     My goal is to create my mobi book without a hitch. The third time’s the charm, right? That would be Wolf Dawson.



Thanks for reading.


Charlsie

Friday, February 3, 2012

Mobi "Build" and EPUB "Zip"

Last spring (2011), I put my then most recently published novel, Epico Bayou, into ePUB format. Elizabeth Castro's EPUB Straight to the Point was my guide. I never got to Chapter 4, "Advanced EPUB Formatting", which had been my real goal. You see, I have a Nook, and on that Nook, I have the free "classics" Barnes and Noble provided with the eReader. I want my ebooks to look like those classics.

At the time, Smashwords, where my books can be purchased in digital format for any eReader, had not come to an agreement with Barnes and Noble regarding distribution of Smashword's EPUB-formatted books, and Barnes and Noble was accepting uploads to its Pubit program, which converts books into EPUB for the Nook. I considered those good reasons to delve into EPUB formatting, with the added benefit of making my books as pretty as Barnes and Nobel's "classics."

Instead, my twenty-two-year-old daughter informed her father and me that she and her Israeli boyfriend were tying the knot, and they were coming home to Mississippi to do it. Needless to say, my goals involving Chapter 4 were set back, and I planned a beautiful wedding. By the time the dust had settled, my books could be purchased for the Nook from the Barnes and Noble Ebook Store, and I had my own web page at the Apple iTunes Store--like a rock star! Yessss. Mike Coker at Smashwords had been busy. See sidebar.

So completing that final chapter of Elizabeth Castro’s EPUB Straight... and making Epico Bayou as pretty as a Barnes and Noble "classic" faded in importance, and I turned my attention to getting River's Bend on the street (in print) and ultimately into the Kindle store as a mobipocket.AZW ebook.

Now, I spent a lot of hours with EPUB Straight to the Point last year, and I learned a lot--knowledge that proved invaluable when I started putting River's Bend into mobi format. From prior experience with Smashwords and its Formatting Guide, I knew how to format books in Word (.doc) for conversion to digital format, and I knew enough .html to convert that properly formatted Word document into .html, then clean it up. Converting Word to .html creates a messy .html document.

EPUB and mobipocket have a lot in common. In fact, from what this laywoman has been able to decipher from her internet research and the International Digital Publishing Forum (see sidebar), the former is an upgrade of the latter--or an upgrade from whatever the latter derived from. The EPUB format is more complicated in that it’s longer, the headers slightly more complex, and the content greater, but certainly manageable. The two biggest problems I had with EPUB were "validating" my EPUB file by downloading and running a java script in my "current" directory and "zipping" the EPUB files comprising my book.

I know what zipping is--compressing files to make them smaller so they take up less "cyberspace" when sent over the internet--or something to that effect. But I have trouble with it. I have trouble with the tools one uses to "zip" or "unzip". I dread dealing with either one, and every time I use one or the other, I am forced to relearn what I never really learned in the first place. I know it shouldn't be that hard. I have WinZip on my new computer. The program looks like it should be able to do everything one needs with one click of the button. Maybe some people can, but I can’t, which brings me back to what prompted this post to begin with: Mobipocket Creator.

I understand enough about the conversion of documents into eReader formats to be able to do it. More often than not I don't understand what the "converters" are doing to these carefully formatted .html, .txt, and graphic files during the conversion process, but I do know that EPUB files must be "zipped" together for the iPad/iPod/S4/Nook or whatever--the eReader--to display them as a book on the screen.

I know that with Mobipocket Creator, you put the files in the publishing window and click "build." That creates the .prc, which you can then upload to various places--in my case, to Amazon where the .prc is converted into mobi’s AZW format for Kindle.

In my mind, that "build" order is equivalent to the "zip" order. But I can't find anything to confirm that. Also, when you hit "build" in the Creator's publishing window, the Creator takes you to the next screen where you have to decide not only your encryption options but also your "compression" options--one of which (the one April Hamilton suggests you choose, as a matter of fact) is “no compression.” That rules out an inherent parallel between “build” and "zipping," right?

Whatever... If there’s anyone out there who knows what happens when you hit "build" and how that equates to what happens when you "zip" in EPUB, please let me know.

What I do know is this: If I find my new .prc book faulty in any way and need to correct it, all I have to do is go to my book's folder in the "My Publications" file on my hard drive, open the egregious file with Notepad++, fix it, close it, re-upload it to the Creator's publishing window, then "build" again. Everything is overwritten, and there’s the corrected .prc. None of that zipping and unzipping I dread so much.

And lastly, I need to download some information on that KF8 format for Kindle Fire--drop caps and embedded fonts. Now that's gonna be pretty!

Thanks for reading.

Charlsie

Saturday, January 14, 2012

Metadata

A Mobipocket publication is an Open Publication Format (.opf) file composed of one master eXtensible Markup Language (.xml) file and multiple .html and graphic files. The master file, bearing the suffix .opf, is a text (.txt) document and contains data that points to the content files (i.e. the book and cover graphic) and includes the book's manifest, spine, and guide sections. But before those, the .opf file contains the book’s metadata.

The metadata section includes information about the book: author, publisher, description, identifier, etc., which allows the buyer to find the book. This section also has a subset, which includes the output encoding, the embedded cover graphic, and the price of the book.

The metadata section begins with two metadata namespace attributes: Dublin Core metadata specifications (dc-metadata) and “open ebook” specifications (oebps), which keeps the .xml document valid. The dc-metadata elements, oebps elements, and x-metadata were deprecated with the launch of the ePub format in 2007, but the Mobipocket format continues to use them.

Here’s what those statements look like:

<metadata>
<dc-metadata xmlns:dc="http://purl.org/metadata/dublin_core" xmlns:oebpackage="http://openebook.org/namespaces/oeb-package/1.0/">

And here’s the rest of River’s Bend’s metadata section:

<dc:Title>River's Bend</dc:Title>
<dc:Language>en-us</dc:Language>
<dc:Identifier id="uid">978-09769824-8-7</dc:Identifier>
<dc:Creator>Russell, Charlsie</dc:Creator>
<dc:Publisher>Loblolly Writer’s House</dc:Publisher>
<dc:SubjectBASICCode="FIC014000">Historical Fiction</dc:Subject>
<dc:Description>Thirty years following the War Between the States a handsome stranger comes to Mississippi and marries a cast-away beauty in exchange for a now decrepit antebellum home steeped in dark history and rumored to hold the secret to a fortune in missing Yankee gold. Mystery, suspense, and romance that will keep the lights on and the pages turning until the final mystery is solved.</dc:Description>
<dc:Date>12/21/2011</dc:Date>
</dc-metadata>

<x-metadata>
<output encoding="utf-8" content-type="text/x-oeb1-document" </output>
<Embeddedcover>RBcvrkindle.jpg</Embeddedcover>
<SRP currency="USD">2.99</SRP>
</x-metadata>
</metadata>

For those of you who want to delve further into the “why’s” of a mobipocket book, here are the sources I used: Joshua Tallent’s Kindle Formatting, April I. Hamilton’s Indie Author Guide To Publishing For the Kindle..., the Mobipocket Development Center website, the International Digital Publishing Forum website, the Dublin Core website, and good ole Wikipedia.

I love it when this stuff starts making sense, even if just “sorta.” Next week I'll discuss the “manifest, spine, and tours.”

And if anyone is interested in how my baby looks on Kindle I'd love for you to go over and take a look at the Kindle Store.





Thanks for reading,

Charlsie

Saturday, January 7, 2012

Mobipocket's OPF File Part 1

Of the three .txt files making up the mobipocket version of my first Kindle book, River's Bend, I found the .opf file the hardest “to get right.” The .opf or open (ebook) package format has a number of sections, all different, but related, making its structure confusing. Accuracy, however, is critical.

Mobipocket Creator produced River’s Bend's original .opf file in a subfolder on my hard drive way back in November when I first hit “build” in the Creator’s publishing window. The book built with 56 warnings and three errors and it continued to produce a significant number of warnings and errors “build” after “build”. The warnings I soon associated with my chapter heads and pages containing front and back matter. Mobipocket Creator identified the errors as a missing cover and missing table of contents (the latter, no doubt, the cause of those 56 warnings). The problem (and solution) was the .opf file. Simply put, the .opf file is the glue that holds the digital book together--it’s what makes the e-reader (Kindle, Nook, ipad, whatever) work. It’s the “brain” of the digital book, and if its circuitry isn’t right, the book is screwy.

The .opf file is an .xml (eXtensible markup language) file, which, as I understand it, is a container file within which .html and .xhtml/.css (used for EPUB) languages are placed. I have no idea what else .xml files are used for, but certainly they contain .txt documents belonging to digital books, because that’s what the mobi and epub .opf files are--.txt files. Regardless, .xml is equal to, but different than the formatted text that goes into them. Think of the combo as “language within a container”--assuming you want to think about it at all. For our purpose here, you really don’t have to. Suffice it to say, the format for this file is rigid, if simple. All you have to do is get the letters, numbers, and goofy-looking characters in the right place and you can create your own .opf file from scratch.

BUT, Mobipocket Creator can create one for you based on the data you feed its publication window.  River’s Bend’s first .opf file I liken to a shell. The Creator produced a perfectly formatted header for me as well as all the sections, but a lot of needed information was missing. Further, the file was not well structured. The solution was to edit it. Given the .opf file is a .txt document, the ideal editor is Notepad++. If you don’t already have that particular software, go here for a free download.

I edited River’s Bend's .opf file from the dc:identifier down. I also broke down the sections so I could "see" them. My Mobipocket Creator-produced file ran from the left to the right side of the screen, then disappeared from view. It’s hard to work with that, and even scrolling doesn’t organize the sections so I can tell where one section/subsection ends and the next one begins. Clearly, carriage returns were needed.

The mobi .opf file consists of five sections wrapped up within a package.
The sections are:
(1) Metadata
(2) Manifest
(3) Spine
(4) Tours (unused)
(5) Guide

Over the next several weeks I intend to detail the .opf file section by section. I’ll start next week with metadata. My goal to produce a mobi book evolved into a plan to create a template whereby I could produce from scratch the files required to build a mobi book. By this, I mean, not using Mobipocket Creator to create the “files.” I think I’ve accomplished that--I'm happy to announce that River's Bend is now for sale at the Kindle Store.

Using the Creator to produce the .prc book for upload to the DTP is a different matter and will be the subject of a later post. Thanks for reading.

Charlsie

Friday, December 30, 2011

Table(s) of Contents and Kindle Books

Simply put, there are two of them, one embedded in the book and one, the Navigable Table of Contents (toc.ncx) housed in its own file.

At one point during the creation of my first Mobipocket book, I had three Tables of Contents associated with my book. One was the Table of Contents (TOC) I embedded near the beginning of my .html book. This embedded TOC is the standard, run-of-the-mill contents page which links to front matter, back matter, and chapters by way of simple anchors; Mobipocket Creator spat out the second TOC during the build stage; and the third TOC was the “navigable” (toc.ncx) file, which I created from scratch.

For creating/formatting the embedded Table of Contents (TOC) and the toc.ncx, I again refer the reader to April L. Hamilton and Joshua Tallent.

I looked for a good definition for the toc.ncx file and came up with Table of Contents Navigation Center eXtended, courtesy of the International Digital Publishing Forum (IDPF). No, this doesn’t define the .ncx file, merely breaks out the acronym. As best I’ve been able to figure, an .ncx file allows reading systems (by that I think the powers that be are referring to devices such as Nook, Kindle, iPhone, etc.) that recognize “auxiliary” content to navigate to that auxiliary content. Otherwise, the reader (the human holding the device) couldn’t get to it. In other words, the .ncx file “extends” the content that the device can access/show/read. Kindle 2, I assume, fits that category of devices; hence, Amazon requires an .ncx file for its Kindle books.

In the case of a simple fiction novel such as my River’s Bend, the toc.ncx doesn’t extend accessible content by much. For example, the .ncx file will take my readers two additional places that the regular TOC does not: River’s Bend’s cover and its (embedded) Table of Contents.

The cover is not present in the book’s embedded TOC because it’s not part of the book’s content, and the second item...well, I don’t really need to explain that, do I? In other words, the embedded TOC provides links to the book’s content and the .ncx file provides links to “auxiliary” content--it gets the reader to the book’s cover if he wishes to see it (and what reader doesn’t?) and to the Table of Contents, which gets the reader everywhere else in the book. Of course, the toc.ncx also gets the reader “everywhere else,” which begs the question, is the embedded TOC really needed? Probably not, but it is part of the book’s content right?
Actually, in my print version of River’s Bend, there is no Table of Contents and that’s true of the majority of fiction books these days. Nevertheless, the reader cannot “fan” through the pages of an eBook--an alternative method is needed.
I inadvertently created that aforementioned Mobipocket Creator-produced TOC (identified by the suffix .mbp) early on, when first getting acquainted with the Mobipocket Creator Publication Files window. I’ll admit, I struggled with what to do with the thing for hours. It was one line--said “Table of Contents”--then the page was blank. Of course, it was blank from lack of data that only I could provide. In point of fact, I now understand that the Table of Contents tab in the Publications Files window is for the publisher’s convenience to automatically create the book’s TOC, which I’d already done from scratch and embedded in my book. I know now that just because a tab appears in the Publications File window that doesn’t mean I have to use it.

Oh, duh!

Next week I’ll talk about River’s Bend’s OPF (open publishing format) file. The “glue” that holds the digital book together.

Thanks again for reading,
Charlsie