Wednesday, 13 July 2016

Double book launch for The Leeth Dossier sf/f series

Well, Saturday was the big day, and my sister made a little video of the people speaking at the launch.  I hadn't done the whole "artistic release" business or gained approval in advance from attendees to film them, so it's a video of just the emceee, Jon Marshall, the guest speaker, Sandra Wigzell of Book Expo Australia, and myself, with a short reading from Wild Thing, at the end.  (From the scene that introduces Sara/Leeth, in which Dr Alex Harmon "acquires" her for his research.)

Considering that I hadn't explained how to operate the camera, I think my big sister did a fantastic job (thanks, Lisa!).  The little Canon Ixus170 did a pretty good job, too: it went from completely out of focus to nicely in-focus within 20 seconds, all on its own we think.  For the first 20 seconds, Lisa was getting it framed correctly, so I've replaced that portion of the video with a still shot taken by Alfred Bellanti (thank you, Alfred!) who came along with Lama Jabr (of Xana Publishing & Marketing), who has been very helpful to me, and Gabriella Kovac, Ehssan, and I think perhaps Andrew A. and others too.

Apologies also for missing the first few seconds of Jon's intro, in which he thanked everyone, and went on to say that because I dreamed up Leeth for an RPG campaign that we played for about five years in the early 90s, he'd known Leeth for a long time: longer than her age of around eighteen (by the end of Vol 2).

I've hesitated to admit the detailed genesis for Leeth, since my own experience of reading novelisations of role-playing game campaigns is that they've been uniformly pretty awful.  I feel that this (turning an RPG campaign into a novel) is what lay behind the only failure(s) - to my mind - of my literary hero, Roger Zelazny.  But some things from an RPG and a novel are in complete agreement - and that's the characters, first and foremost. And secondly, the world.  Or at least, the feel of the world: I completely replaced the RPG world with one of my own creation.

These fictional worlds shared the same blending of magic and science, and were set in similar time periods in our future; there's even some similarities in the mix of races, and how magic works. (Which is based on real world ideas of the hermetic and shamanic forms of magic, with interesting bits and pieces of Carlos Castaneda's curious experiences stirred in to spice things up.)  I think Shadowrun was a bit more dystopian than my own near-future world: for me, there are lots of good bits, too.  I think of it as a "mixtopian" future.

Some games really spark, and work brilliantly; our Shadowrun campaign was like that.  The character I played for some years was my most fun character ever; and his ending was as traumatic as it was dramatic.  Thinking about it now, I rather suspect that Leeth was my way of coping with that loss: I set myself the goal of inventing a character who would be even more fun and original and challenging to play than Mike d'Angelo - a big ask!

I took along some "show and tell" for the launch:

  • My original hand-written MS (of about 400 sheets of closely-written, mostly-A4 sheets of paper, each carefully numbered).
  • A fake scientific (sociological) paper about the disenfranchised people, the cast-offs of the advanced and successful society only a few miles away, who lived in the shattered and now undesirable parts of the city.  I did this half for fun, and half to clarify in my own mind how this second society functioned.
  • Leeth's original character notes, and the formal "character sheet" which included an illustration of what Leeth looked like, in the persona she was operating under for the campaign.  When you eventually see "Bonnie" turn up, you'll know I've finally started to delve into some of the actual experiences from the campaign!  I think some of the conversations may well appear in the books.  You'll then be able to judge whether or not I succeed in my approach to novelising a few parts from the game.
  • Notes on the personnel and purpose of the Institute for Paranormal Dysfunction, along with a map of the building and grounds.
  • Notes on the personnel and purpose of the Bureau for Internal Development (or at least, the ultra-secret Department concealed within it).
  • A kind of graph or time-line which I titled "The Genesis of Leeth", in discussion with my step-daughter Leonie ("Do you think it should have a title, Luke?") at about 2pm on the day of the launch.  It showed the thousands of hours of work put in to the creation of Leeth across the years, with significant events and milestones marked.

Anyway, I doubt that anyone really wants to know that much about all this.  And I've probably also put this on the wrong blog: it should be over on All About Leeth, not here on my blog on self-publishing

So let's leave it at that.  Thanks once again to everyone who was able to come along to the launch in person, and who made it such a happy event for me.  And best wishes to those who wanted to come along, but for whom circumstances or obligations conspired against them.

Double book launch for The Leeth Dossier sf/f series

Well, Saturday was the big day, and my sister made a little video of the people speaking at the launch.  I hadn't done the whole "artistic release" business or gained approval in advance from attendees to film them, so it's a video of just the emceee, Jon Marshall, the guest speaker, Sandra Wigzell of Book Expo Australia, and myself, with a short reading from Wild Thing, at the end.  (From the scene that introduces Sara/Leeth, in which Dr Alex Harmon "acquires" her for his research.)

Considering that I hadn't explained how to operate the camera, I think my big sister did a fantastic job (thanks, Lisa!).  The little Canon Ixus170 did a pretty good job, too: it went from completely out of focus to nicely in-focus within 20 seconds, all on its own we think.  For the first 20 seconds, Lisa was getting it framed correctly, so I've replaced that portion of the video with a still shot taken by Alfred Bellanti (thank you, Alfred!) who came along with Lama Jabr (of Xana Publishing & Marketing), who has been very helpful to me, and Gabriella Kovac.

Apologies also for missing the first few seconds of Jon's intro, in which he thanked everyone, and went on to say that because I dreamed up Leeth for an RPG campaign that we played for about five years in the early 90s, he'd known Leeth for a long time: longer than her age of around eighteen (by the end of Vol 2).

I've hesitated to admit the detailed genesis for Leeth, since my own experience of reading novelisations of role-playing game campaigns is that they've been uniformly pretty awful.  I feel that this (turning an RPG campaign into a novel) is what lay behind the only failure(s) - to my mind - of my literary hero, Roger Zelazny.  But some things from an RPG and a novel are in complete agreement - and that's the characters, first and foremost. And secondly, the world.  Or at least, the feel of the world: I completely replaced the RPG world with one of my own creation.

These fictional worlds shared the same blending of magic and science, and were set in similar time periods in our future; there's even some similarities in the mix of races, and how magic works. (Which is based on real world ideas of the hermetic and shamanic forms of magic, with interesting bits and pieces of Carlos Castaneda's curious experiences stirred in to spice things up.)  I think Shadowrun was a bit more dystopian than my own near-future world: for me, there are lots of good bits, too.  I think of it as a "mixtopian" future.

Some games really spark, and work brilliantly; our Shadowrun campaign was like that.  The character I played for some years was my most fun character ever; and his ending was as traumatic as it was dramatic.  Thinking about it now, I rather suspect that Leeth was my way of coping with that loss: I set myself the goal of inventing a character who would be even more fun and original and challenging to play than Mike d'Angelo - a big ask!

I took along some "show and tell" for the launch:

  • My original hand-written MS (of about 400 sheets of closely-written, mostly-A4 sheets of paper, each carefully numbered).
  • A fake scientific (sociological) paper about the disenfranchised people, the cast-offs of the advanced and successful society only a few miles away, who lived in the shattered and now undesirable parts of the city.  I did this half for fun, and half to clarify in my own mind how this second society functioned.
  • Leeth's original character notes, and the formal "character sheet" which included an illustration of what Leeth looked like, in the persona she was operating under for the campaign.  When you eventually see "Bonnie" turn up, you'll know I've finally started to delve into some of the actual experiences from the campaign!  I think some of the conversations may well appear in the books.  You'll then be able to judge whether or not I succeed in my approach to novelising a few parts from the game.
  • Notes on the personnel and purpose of the Institute for Paranormal Dysfunction, along with a map of the building and grounds.
  • Notes on the personnel and purpose of the Bureau for Internal Development (or at least, the ultra-secret Department concealed within it).
  • A kind of graph or time-line which I titled "The Genesis of Leeth", in discussion with my step-daughter Leonie ("Do you think it should have a title, Luke?") at about 2pm on the day of the launch.  It showed the thousands of hours of work put in to the creation of Leeth across the years, with significant events and milestones marked.

Anyway, I doubt that anyone really wants to know that much about all this.  And I've probably also put this on the wrong blog: it should be over on All About Leeth, not here on my blog on self-publishing

So let's leave it at that.  Thanks once again to everyone who was able to come along to the launch in person, and who made it such a happy event for me.  And best wishes to those who wanted to come along, but for whom circumstances or obligations conspired against them.

Monday, 13 June 2016

Book publishing/launch todo list

My next planned post was going to be about preparing the print edition. But before I do that, I thought I'd slip in something much simpler. This is just my to-do list of the things I need to do, now that I have a few days breather in between finishing the 2nd draft (3rd? 4th?) and getting ready to actually publish the ebook and paperback editions.
Here is the Gleebooks link for the series launch.
I'll update this list as I progress (as the countdown proceeds).
I thought it might make a handy check-list for other people. Though your mileage may vary, since I'm using Amazon for the ebook, and IngramSpark for the print editions.
Notes:
WT = Wild Thing (1), HL = Harsh Lessons (2), SH = Shadow Hunt (3).
"*" means the task is completed.
This list is complicated by the fact that I'm doing a series launch (two books, not one), so it makes a bit more work for me.
I think a good planner would schedule this work to be spread out over at least two or three months.
I have learned to allow more time for the stuff, for future books!
Without further ado, the check-list. But because it looks a little daunting just presented as one great lump, I'll try to structure it a little to make it more digestible. I'll include estimates for how long each task should take, too.
Essential items
  1. * [1 hr.] Assign the ISBN for the new book. (Both ebook and print edition(s).)n Included in this is notifying the ISBN authority (in Australia, it means filling in the web forms in Thorpe-Bowker). This helps the book appear in publishing databases.
  2. * [1 hr.] Apply for the Catalogue in Print (CiP) entry for the new book. (ebook and print). This means the book will show up in more catalogues, including libraries, all around the world.
    Although this doesn't take you long, it may take a couple of weeks to receive the CIP text, so don't leave this until the last minute!
  3. * [2 hrs: er, no, 6.] MARKETING: Get Gleebooks RSVP info, site URL, for mail out to people I know who may be interested, and do so. Once only.
  4. * [1 wk? 2? Yes, it took a full 2 wks] Finish off the writing. For me, this means attending to the final critique from my editor. And I wanted to fiddle a bit with the title page.
    A normal person would schedule the book launch with ample time for this!
  5. * [2 hrs] Upload the book to the print edition publisher, IngramSpark, and to the ebook publisher, Amazon. Done: Harsh Lessons
  6. * [1 hr + detail check: 6 hrs] June 23: Order urgent proof copy of HL, and check it.
    A normal person would schedule the book launch with ample time for this, too. Got this done 4 days later than I'd hoped: paid a little extra, to rush the order to compensate.
  7. * [1 hr +6hrs?] June 30: get estimated no.s of attendees for launch and order an appropriate number of copies [Done for WT: Will do rush order on Monday for HL].
  8. * [2 hrs -> 1hr] MARKETING: Update list of people who earned/won free ecopy of HL (send iff given address), and gift people those people with free ecopies of Harsh Lessons, as I promised.
    (If you haven't promised this to people, then it's not a required Thing To Do!)
-- Bottom line: about 2 days of work. [Turned out nearer 3]


For me, I have to add whatever time it takes me to prepare the absolute final text for the book. (A sane person, or a good organiser, would schedule things so this list didn't even include that last slab of work!)  I'm not including the finishing of the writing/editing, since that's just the tip of the write-a-novel iceberg and doesn't belong in this list.

Useful but not essential
  1. [6 hrs?] Write some blog articles. (For me:
    * a status update [done],
    * this todo list [done],
    finish off the "preparing the print edition" article.)
  2. * [3 hrs] Research and buy new colour duplex laser printer. So I can produce decent press releases/posters. Brother HL-3150CDN sounds good, for Linux. $200. Buy, install, configure.
    Cost is a lot higher when you add a complete set of toner replacements (~+$600). Ubuntu 16.06 auto-install set it only as a text-only printer, nor could it print the test page. But the Brother web site provided installers for CUPS and lp, and that worked easily and flawlessly. Print quality is lovely!
  3. *[1 hr] For my situation, choose a suitable sample early chapter from Vol. 3 to include at the end of Vol. 2.
  4. *[2 hrs] Since I've improved Ch 1 in HL, and it's included as an excerpt at the end of Vol 1, update that in WT ebook and POD.
    (If it's your 1st book, or you haven't included a sample excerpt, this item goes away.)
-- Bottom line: about 3 days of work.
Nice to do if I have time
  1. [1 hr] MARKETING: Update WT press release.
  2. [2 hrs] MARKETING: Prepare press release for Harsh Lessons.
  3. [2 hrs] MARKETING: Print and send good press release with copy of WT to appropriate SMH reviewer.
  4. * [2 hrs: er, 4hrs] MARKETING: Make poster for where I used to work: the PDF for the poster is available here, for others to use.
  5. * [1hr] MARKETING: Update my old web site which succinctly lists what I've written and what I'm working on.
  6. * [15 min] MARKETING: Give poster to local newsagency?
  7. * [30 min] MARKETING: Give poster to local library?
  8. [2 hrs?] MARKETING: Prepare some give-away postcard or similar for book launch?
  9. [1 hr] MARKETING: Prepare and order new business cards.
  10. * [1 hr] MARKETING: Organise Amazon free days for WT to garner extra reviews.
    I mis-handled this, though: didn't promote it effectively beforehand, and did it as one lump of 5 days. But I learned a lot about the timzeons (plural) that Amazon works in. Also made a suggestion which they they seem inclined to implement.
  11. * [30 mins] MARKETING: Post Harsh Lesson draft to Amazon; set pre-release info.
  12. * [1 hr] Make the ebook available on Amazon from July 6 5
    Discover that you can't shift this date later if you realise you've given yourself too little time, without Amazon taking it very seriously: you lose the right to arrange another pre-order for a whole year. So I stuck with my original date. I hope I'm allowed to upload an improved version before the release date!
    Yes: but it can take a day for the uploaded revision to ripple through.
  13. * [10 mins] MARKETING: Contact local community radio (Radio Skid Row) re series launch, book 2, for interview. Note that various Linux tools for listening to streaming music did not work for me (banshee, streamtuner), but Clementine worked immediately after adding the URL for the stream, http://www.radioskidrow.org/mono32.asx)
    The interview will be lunchtime (prob. around 12:30pm) on Thursday 23rd June.
  14. [2 hrs?] MARKETING: Create a Facebook author page.
  15. [2 hrs?] MARKETING: Complete that convenience FB app. for Blogger.
  16. [2 days?] Read those two books on publishing/marketing I bought.
  17. [hrs?] MARKETING: Actions from marketing plan
  18. [1 hr] Practice reading, in case it's wanted for BL.
  19. [2 days ea?] Prepare an A-format (4"x7") edition of each book being launched (For me, Vols 1&2: WT, HL).
-- Bottom line: about 6 days of work.
Misc other vaguely related stuff that'd be nice to do, too
  1. [1 hr] Post copy of WT to replace lost copy, + HL, to Mirella. Choose trackable/signed delivery! Also post copy of HL to Dave.
  2. [1 hr?] Provide hardcopy WT to State Library? Ditto HL.
  3. [1 day] Do oomph analysis for Wild Thing.
  4. [1 day] Re-do oomph analysis for Harsh Lessons
  5. [day? ]Try character matrix idea?
  6. [1 day] Oomph analysis writing.
  7. [1 day] Type up some other not published pieces for the Marrickville Writer's Group review site.
  8. [days?] Aug: Start preparing for Book Expo, October
-- Bottom line: about 5 days of work.
So for me, all up, if I include every optional task, that's about 16 days of work. But just 2 days if I only do the essential items. I did need two weeks to attend to Dave's 2nd critique. It made excellent sense to do the essential stuff (including attending to the critique), and then work my way through the "nice to do things". The launch is now over, and was very successful (according to my modest goals), though I ran out of time to do many of the "nice-to-do" items. A few I'll carry on and do, even though it's now after the launch. If I hadn'tm caught a bad cold, with coughing when I tried to sleep, I think I would have achieved most of these things. Also, saying "Yes" to a solar panel installation and handling the consequences of how much planning and work that would involved was one of my stupid seat-of-the-pants decisions: to-ing and fro-ing about that cost me at least a day of productive work, until I postponed it all until afterwards.
At the time I first wrote this I had 25 days, so it looked a little scary but not too scary, even given my overly-optimistic planning and scheduling!

But the end result was happy. I'll put up a video from the launch on youtube in a day or two.

Saturday, 11 June 2016

Book 2 - Harsh Lessons - is almost ready

I should apologise for the long gap in items, but I don't feel too guilty about it, because life's rich pattern has been a bit too rich: with a wonderful wedding (congrats, Emma & Pete!), a significant health issue in the family and planning for serious surgery for that, the death of my wonderful and loving Aunt Patsy, and the birth of a new nephew (welcome to the world, Malachi). Family comes first, but my writing does come second, so that meant that pretty much everything else got squeezed out of the picture.

Executive summary: I've been very busy and productive, and I will be holding a series launch of the 1st two books, at Gleebooks on Sat 9th July 2016, 3:30pm for 4pm at Glebe, Sydney. Harsh Lessons (Vol 2 of The Leeth Dossier) should just be ready in time!

This is probably a good place to show the beautiful new cover, once again designed by the wonderful Mirella de Santana (https://www.facebook.com/mirellasantana.digitalartist and at http://mirellasantana.deviantart.com/).

So this is just a little filler piece before my next planned serious post, about preparing a print edition. I had drafted an article on that topic when I was preparing the print edition for Wild Thing (Vol 1 in the series), but simply didn't have the time to finish the article off and post it here. But since I'll be preparing Harsh Lessons (Vol2) in a week or two from now (epub and print), I thought it made sense to use that to freshen up my experience and finish off the article.

In the meantime, this article, which is just a "what I'm up to right now" article.

So, what's this mention of Book 2 being called Harsh Lessons? When did it change from Shadow Hunt? And why? Well, a funny thing about that…

So, after all that "oomph analysis" stuff in the previous post, how did Book 2 fare under Dave's (http://ThEditors.com/) critical view? The big worry was that the book was looking much too long, at I think 165k words – I think it was around 560 pages. And Dave said it sounded like I'd need to cut it by twenty to thirty percent.

So, what happened? Well, Dave liked the new stuff, especially the "Mean Girls" story arc. The idea behind that was to fix a small pacing problem, except it in itself turned into 50 pages. But he pointed out that the readers would probably be wanting Leeth to be developing and learning a bit faster than I had planned; and more importantly, he thought I'd taken the easy way out in an area related to that, which meant I'd missed a great opportunity for something quite compelling which would make a natural and satisfying climax if the book ended there. Which just happened to be around the mid-point. His second big suggestion was related to Leeth's fighting prowess compared to her sensei. We ended up compromising, there.

So, it was back to the plotting and writing, and I outlined how it would look, and discussed it with Dave, and then got stuck in. Ah, yes, so if you're just wondering "But didn't you also split the 1st book in two?", then I'd have to sheepishly confess that I had. And indeed, that was the 1st half of the initial MS, which I myself had split in half back in around 2000, I think.

Anyway, the split meant that I needed a new title, since Shadow Hunt fits the 2nd half very well (now, Book 3); but doesn't fit the 1st half (now, Book 2). So after much mulling and thinking, I realised Harsh Lessons was the right title for volume 2. Which of course means I'll need to revise the text at the end of Book 1, to update the mention of Book 2's title, and I've also since then (thanks to Dave's critique) tightened the sample chapter I included. The other thing I've been squeezing in, is organising a series launch. Since there was no way I was going to be able to meet my promised publication schedule for Book 2 if I took the time to arrange the launch for Book 1, it made sense instead to delay till July and launch the series, with both books. This is tight: Harsh Lessons has been with Dave for about a week now, and I'll be getting some feedback next week; so depending on how much he thinks needs to be done to it, I may have an impossible amount of work to do, or something achievable, for the July 9th launch!

The series launch. So the launch will be held at 3:30pm for 4pm, at Gleebooks, Glebe, in Sydney, Saturday 9th July: the week after the Australian Federal Election. And I'll update this blog post with the RSVP etc. information for the Gleebooks newsletter and website.

For the book launch, if you would like to come, it's important to RSVP to Gleebooks directly, using any of the mechanisms they provide: by emailing or by phone (calling (02) 9660 2333), or by going to the Gleebooks website (or is it the newsletter part of the site for July - now in preparation - at The Gleebooks Gleaner newsletter ?), and RSVP-ing by filling out the form that will be there. As Gleebooks are catering (and I'm paying, of course), we need to have a good estimate of how many people will be coming for both the catering side and so I can guess how many copies to bring along, in case anyone wants to buy one. They'll be available for $20, and I'll obviously be happy to sign them for people.

Sandra Wigzell of Book Expo Australia has kindly agreed to be the special guest star. Sandra noticed a few years ago that Australia had not had a Book Expo since the 1970s, believe it or not. So she has been organising and holding them for the last few years, and it seems to be growing nicely. Sandra is a big supporter of indie publishers, book reviewers (including "booktubers" – a lively bunch of people who review books and all related stuff in videos they make), the people who provide services to authors and indie publishers, and of course book lovers. It's a great place for talks and seminars, as well as a chance to meet and talk to authors and everyone else in the book creation world. This year's is on 8/9 October, at Rosehill Racecourse Pavilion. "Book Expo Australia is a dedicated event national and international publishers and authors to meet and interact with avid booklovers"

Thursday, 7 April 2016

Wild Thing Book Launch!

I had planned to organise a book launch for Wild Thing, early in May, 2016. But after some discussion with Elizabeth Allen, the events organiser for Gleebooks, I've altered my plans significantly.

It's now pencilled in for the afternoon of Saturday 9th of July, upstairs at Gleebooks (49, Glebe Pt Rd, Glebe, NSW). So that's half the change. The other half of the change is that instead of being a launch for Wild Thing alone, it's now going to be a launch for the series(The Leeth Dossier), with a double launch for Wild Thing, and the sequel, Shadow Hunt, which will be available at the end of June: barring disasters!

So I thought I'd better update this post with the new information (as of 4pm, April 14th). I will update this again with information about how to RSVP. If 50-80 people can attend, that would be ideal. Books will be available; Wild Thing will be $20 (5"x8" pbk). But by then I should have the 4"x7" edition available, too. I don't know how long Shadow Hunt will be, but both Dave and I are worried that the current 547pp is probably too long! Because I don't yet know the length, I don't yet know how to price vol. 2.

The poll, over on the right here, was to try to estimate how many people might attend if it were held in May. Since that's now been substantially re-scheduled, I'd just like to thank those who voted, but I'll need to take it down, since the RSVPs will have to be directed to Gleebooks so they can estimate food and drink amounts (and advise me of the number of copies they'd wish to have available on the day). I'll update this blog post with information about how to do that, when I have the info.

The idea of the launch is that I'll have some printed copies for sale (enough to go around for those who want to buy one, at A$20 a pop), and sign them if wanted, and to have some sort of little talk, and nibbles like wine and cheese. Just something low key.

The Wild Thing launch was delayed because I'd been concentrating the great majority of my energy on preparing the manuscript for Book 2, Shadow Hunt, to send to my editor Dave at ThEditors in the 2nd week of April. I sent the MS off to ThEditors.com in two parts: the 1st half at 9:30am (UK time), and I finished and sent the 2nd half at 4pm, UK time, April 14th. So I claim that means I met my deadline!

I've updated my notes here about what I call the "Oomph analysis" I did along the way. This is my now-being-invented analytical tool to try to distance myself from my own writing, to see if I can see where problems or weaknesses occur, standing back from it a bit. The idea grew from a question my brother Matthew asked me recently, when I mentioned that Dave, in his original critique around this time in 2015, said the pace had slowed in one section (of what was then the second half of a single novel). Matthew asked: "Do you ever graph the pacing of the book?"

That seemed an excellent question, and it instantly made me wonder "Why just pacing? Why not consider how moving a chapter is, or how funny, or how much it advances the plot, or ...?" My idea was to invent a bunch of categories I felt were important for my book, and then give each chapter a score out of five, in each category. Then colour code them and graph them all in parallel, across the entire novel. I discussed the idea with a couple of people, including Dave at ThEditors and Barbara of Amorina Rose and the world of writing, who each thought the idea seemed at least plausible. I'm about halfway through, and it seems to be working.

But how do you use the numbers? Well, I'm still experimenting. It seems like the "oomph" of a passage should drop as it got longer and longer, right; as it keeps going on and on? So therefore you need to reduce the "oomph" rating according to the length. On the other hand, doing that might unfairly weight short passages: if you just divided by the number of pages (N, say), then a 1-page chapter isn't automatically going to have N times the punch. You might even argue that the more beauty, or humour, or whatever, the higher the punch, so it should grow with the length! You see my dilemma. But I can play with different models or formulae once I've done the heavy work of rating it in each category.

Incidentally, for my book, the categories I decided on were: Pace (action), World building, Character development, Plot development, Emotion (moving), Humour, and Tension. I'm also making a one-line summary of each chapter in the spreadsheet I'm tossing all the numbers into. It's partly objective, despite being subjectively-based. Analysing a piece of my own writing to evaluate how funny it is, or how moving, is not that hard. I know there'll be stuff I think is snort-with-laughter funny, but which others won't "get"; and bits that I find terribly sad, but for which others will just shrug; but the fact that I think it varies means there is some variation there to be seen. (I hope!)

The value of the tool obviously depends on how brutally honest you can be with your own writing. A dishonest writer wouldn't gain much from the technique, though, for sure! ("Wow, look at that: 5s across the board, in every category I wanted a 5, for every chapter!")

I think someone else using the technique on my work would almost certainly give more objective ratings than I will be able to. But as long as I'm closer to an objective rating than to a just-plain-wrong rating, it should work as an analytical tool.

If anyone's interested, here's what the Oomph Analysis looked like at the end of the 2nd read through and revision:

I should say, by around Chapter 60, I was biting my nails, wondering whether the final chapters would be climaxy enough - but I didn't fudge my scoring system, and it came out looking good. (I basically gave myself a 5 for humour if I had several laugh-out-loud moments in the chapter, or on where I really cracked up; similarly, if I cried a fair bit, I gave that chapter a 5 for emotion; and so on.)

Here's what the graph looked like about half-way through my 1st read-through:

The graph above sets the "Oomph" number to set the sum of the seven category scores, divided by square_root(square_root(4+N)), where N is the number of pages and 4 is a fudge factor to prevent over-weighting short chapters as being more "oomph-y". I'm still wondering things like: should I do something that scales up the scores (to give greater weight to high scores); and the idea that the overall oomph perhaps should not jump if you just arbitrarily split a chapter in two (maybe the Oomph of each half-chapter should drop by half)?

At about the two-thirds point, it seemed very hard to see what was happening. I rather suspect that what's happening is that there's a sort of averaging effect going on, that's obscuring things. (Imagine you had a hundred categories: if you just added them up, it'd sort of blur out into a muddy brown, since only a few categories would likely be strongest, as those categories would presumably capture the essence of what you were trying to achieve in that passage.) I wanted to emphasise the high scores, to make them more visible. I did a mental calculation, considering squaring each score before adding them all together, but if I cubed them, then if say a chapter got a rating of 5 (yippee!) in one category, and a 4 in another, and 3s in the others, then the top two categories would total almost 200, and all the rest combined, just 135. That seemed about the right balance, to me. So I added an Oomph^N and set N to 3, and here's what the graph turned into with the scores now exaggerated:

The pattern is nicely emphasised so it's now quite visible: it's easy to see a difference between a 4-rating and a 5-rating, and an overall pattern stands out. I'm encouraged to see that it's rising and falling, and there are rises and falls in different categories too. I can't tell you what it means, but it somehow looks healthy, to me!

Anyway, stay tuned, if you think you may attend my little book launch in Sydney (hopefully upstairs in Gleebooks, on Sat 9th July, in the afternoon), as I'll update this blog post with information about how to RSVP: there will be a link to the launch on their website, where you will be able to RSVP. It will also be possible to RSVP by email to events@gleebooks.com.au, but I'd wait a little before trying that, as it's probably not yet been entered into their system

It was a busy day today: as well as completing the 2nd read through and revision of Shadow Hunt, and sending it off to ThEditors at 2am Sydney time, I got a haircut, organised a date for the book launch for the series, did the weekly shopping, and investigated the cover image issues caused by the winding-up of the site where I'd DollarPhotoClub. Which may be an interesting little extra bit of information to share...

I had licensed a further 91 images that I could choose from, to download, and as part of their closing down, the images have been transferred into Adobe Stock. Today (the final day) was the first day I'd had time available to do this. As part of the transfer, they offered a deal for signing up to Adobe Stock for a year, at a reduced rate. Unfortunately, when I checked the license conditions, they clearly state that you while you do have the right to use the image in printed material, you do not have permission to use the images for Print On Demand. Since I am producing the paperbacks through IngramSpark POD, that sounded like it was a deal-breaker as far as my needs. But I contacted Adobe, and a consultant checked. Unfortunately, it's correct: if you wish to use their images for Print On Demand, you need to purchase an Extended License (as it's considered High Volume), and when I had a little poke about, that meant each image's license costs US$99. So, no, not suitable.

Strangely, too, the owner of the images in Adobe Stock didn't seem to link to the copyright holder for the images, the photographer Pindurin Vasily (the images now claim the "author" is "chesterF"), so I may poke about further and see what's going on there.

Tuesday, 15 March 2016

Wild Thing: 1st printed copies

What, no text?

Well, I'm flat out preparing the MS for Book 2 - Shadow Hunt - to send to ThEditors by the 2nd week of April, to give me a good chance of meeting my deadline of publishing it in June. As a result, this blog has taken 3rd priority (1: family; 2: book).

I'm well aware I also promised, too long ago, to be about to write up what I've learned about preparing the printed edition(s), so I'll also get back to that as soon as I have some spare time (mid April). About the same time I'll be heavily involved in organising a small book launch for Vol 1!

Till then...

Tuesday, 12 January 2016

Adventure #1 in publishing: Creating the ebook!

Ebook conversion.

Hoo, boy! This should be the easy step, but I think this is where most of my effort went, in the ten days before my publication deadline. You need to convert your book to the ebook format required for the publishing platform you've chosen. This should be straightforward and painless, but I'm told it's anything but. My early experiments bore that out: but read on, I found a good and simple approach using Calibre.

Lest this sound a bit scary, I should cut to the chase and say that once you've cleaned up your source document, and entered the metadata into Calibre for your book (by typing in the blurb, ISBN, title, author, etc.), the conversion to epub or Amazon's .mobi using Calibre requires only a few minutes of effort, and produces a good and reliable result.

What you want is the ebook format to be as nicely laid out and as well-formatted as what you have in your word processor. But for a various reasons, the conversion can have major problems.

I was using LibreOffice 5.0.3 for my word processor, incidentally, at the time I wrote this blog post. Most people probably use Microsoft Word. A few people (especially if they're producing something like a photo book or a children's illustrated story) might use InDesign. I think InDesign is poorly suited to producing a reflowable ebook: InDesign is, after all, designed to do the opposite, to place each piece of text and artwork exactly where you put it, and not to be movable or resizeable. (That said, it would be great for non-reflowable ebooks, like children's picture books or coffee-table books with lots of images.)

In contrast, one of the biggest strengths of an ebook is that the reader can enlarge or reduce the font (or possibly change the font completely), to suit their eyes and/or the lighting conditions. So this means that you have to be careful about preparing your MS so this reader-directed reformatting can work well: you need to use true page breaks when you want a new page, and an indent or centring style when you want to indent or centre something. An awful mistake is to use spaces/tabs and blank lines to manually position some text so it looks right for you in your MS. Likewise, it's a bad mistake to make a piece of text look like a chapter title but not mark it as such. In short, you should be using paragraph styles exclusively. Doing so also means that if you decide you need to make a change to how you've laid out every instance of something, you need only change the paragraph style, not each paragraph!

Here are some problems I've encountered, using LibreOffice:

The HTML it produces is far more complex than it needs to be. I have basically two kinds of paragraphs (body text and chapter titles), and a few pieces of text that must be centred. I use italics for emphasis. But LO (currently) splits the runs of text into shorter spans of differently-named but identical styles (usually, showing where I went in and edited the text), and for my MS produced literally thousands of paragraph styles.

Worst problem for me was when I copied the whole MS into the new template I wanted to use: after resetting all the paragraphs to the correct body text style, and setting all the chapter titles to the chapter title style, it lost (randomly as far as I could see) about half the places where I'd applied the italic style. I delved into the XML and after a days work of writing some programs, was able to recover about 90% of the italics. The rest I just had to notice and re-do manually during one of my many read-throughs.

Conversion to Microsoft docx and back seemed to help somewhat: but then other aspects of the page formatting got messed up (left and right margins, footers, etc.). So that was a dead-end.

The table of contents generated for the ebook format was just bizarre. You don't want page numbers matched to chapters in the TOC, since page numbers basically don't exist in the ebook format (because the ereaders don't want to calculate this up-front and store and display the information: the technology may change in future). Anyway, not only did my chapters have page numbers, but after conversion, each chapter in the TOC occupied a separate page. Ouch!

Loading up the LibreOffice .odt file into Calibre for conversion also produced poorish results when I then used Calibre (v2.45) to convert it to epub and Kindle (.mobi) format. Calibre seemed to work better when I saved as a .docx and then loaded that up. But the formatting wasn't what I wanted, so more investigation was needed. I made this note to myself when I started this step:

"I have some notes on a page at Goodreads about tips for conversion to ebook formats, and a few web pages to read, as well as my own experiments to perform. Worst case, I may have to unzip the epub format and have a look at the raw HTML, and simplify it down to the bare minimum. This is not meant to be rocket science, after all."
(Which is what happened, incidentally.)

Oh, I also had a plug-in for LO that converted straight to ebook formats: but that seemed to have its own problems, so I uninstalled it.

Here's a very good explanation of self-publishing on Kindle.

Now, at this point I could have delved into the HTML side of things, since Kindle uses a subset of HTML as one of the possible input file formats for producing a book. (The others are PDF and mobi.) If you want to delve in and get your hands dirty, and take control of lots of aspects of the layout, then learning about the HTML may be the best approach. I didn't do that in the end, but rather than ignore all the tips I've gathered, I'll stick them in an "appendix" after this main article ("Kindle's HTML").###Fix this link

The approach I took in the end was much simpler, and I believe generally more useful, and should only continue to improve with time, so I'll focus mainly on that.

My approach was to rely on Calibre, since one of Calibre's important main functions is to perform ebook conversions.

I thought the best starting point was probably to see what it produced, and to look into any problems I found. In that way, if I found something that looked like a genuine problem in Calibre, I could inform its creator, Kovid Goyal. Or, it might point to problems in what I'd done.

Importing my .odt file and converting to epub was painless, as was reading the resulting epub version within Calibre – but I noticed quite a few issues. Here's a screen shot of Calibre in action, with Wild Thing imported into it:

Calibre is powerful, flexible, and has a well thought out user interface that makes it pleasant to use. But the flexibility (necessary to deal with all the different tasks it can perform), meant that I found myself at a bit of a loss as to work out what to do. Calibre also comes with lots of good documentation, including video demos.

Another thing I found was that Calibre itself has what looks like an excellent editor built in, with a well-written user manual available for free here. (I did what I normally do: "printed" the web page to a PDF file, then opened it in Adobe's "acroread" program, selected "booklet" printing, and sent that to the printer, stapling the result with my long-arm stapler to make a convenient A5 reference booklet for easy reference.) Obviously, editing the MS in Calibre is a last resort: if I make changes to the original MS and re-convert in Calibre, I'd need to make any edit in Calibre again – or else make the Calibre version the main source file for the book, which wouldn't be a good idea since then I'd have different "source file" for the print and the epub editions.

The trouble for me was that my deadline was now so close I simply didn't have the time to study and learn Calibre thoroughly. I needed some shortcuts.

Because I'm technical, I decided to poke about under the bonnet and see if I could work out what was happening. Now, most of this poking about was unnecessary and is merely a distraction: so I'm again going to put most of it into yet another "appendix" to this article ("Poking about in Calibre").###Fix this link, too

But one aspect of it proved so useful that I'll shortly describe some of my poking about, within this article proper.

The ".epub" file is actually a ZIP file with specific files and file formats inside it (that's good design!). One of the intentional consequences of this is that you can poke about inside. If you know what you're doing, and don't break the rules, you can even change things. (You just zip it all back up into an .epub file again.)

So I poked about and spent a while developing some scripts to try to fix what I saw as problems, and continued delving into and learning the technical details of how the .epub format worked, and what Calibre produced. I made some progress, but then reached a point where things looked sufficiently wrong that I filled in a bug report to describe what I was experiencing.

The three big errors I had were:

  1. After importing my LibreOffice MS into Calibre and converting to epub, the Table of Contents (of about 70 chapters), appeared as one separate line on each page: you have to page forward through 70 pages to get to the actual 1st page. Or, if you wanted to "jump" to chapter N, then you have to page forward N-1 to get to the ToC entry for Chapter N, and then click on the link.
  2. I was getting white square rectangles appearing for some of the non-breaking space characters when I uploaded the .mobi file to KDP.
  3. Lots more fonts than I expected in the output file, leading to strange changes in the paragraphs.

The developer of Calibre, Kovid Goyal, was very helpful. And, the executive summary of the long and detailed description of my trials and tribulations are that all the problems were caused by either a wrong setting I'd chosen in Calibre, or a genuine bit of messiness in my MS.

To fix problem (1), Kovid pointed out two simple corrections to what I was choosing for the conversion operation:

  1. He recommended converting from .odt to .docx format , and give Calibre the .docx file, since a lot more work had gone into the conversion from .docx. So I chose "Save a copy" as .docx and tried that.
  2. In the Structure Detection section of the conversion dialogue, either change the "chapter mark" to none, or change the chapter detection expression to "/". So I set the "Chapter mark" to "none", and also changed both the "Detect Chapters at" and the "Insert Page Breaks before" to just a "/" (this means, "disable this function").

Together, those two pieces of advice fixed pretty much all the errors I'd found in the conversion process – apart from errors obviously coming from my MS itself. Here's another screen shot, showing all three (changed) settings in Calibre:

For problem (2), it turned out to be a character I was occasionally (accidentally) somehow typing instead of a non-breaking space, in LibreOffice. The character appeared to be a non-breaking space in LO but was illegal for Kindle (specifically, it was the Unicode character U+FFF9). I just had to find and delete all those characters from my MS.

Problem (3) – fun with fonts! When I paged through the ebook in Calibre, doing a visual check, I noticed there were some sections in the wrong font. Checking back into the MS I found that, sure enough, there was a genuine font change in the MS – with a visual difference so small that it was almost undetectable in LibreOffice. But then I realised that finding all these by visual inspection (i.e., manually) was an unnecessarily laborious way of finding and fixing them. By manual inspection, I had learned that the font errors so far had been because some of the text was still in Garamond 9pt. Because Garamond is not installed on my system and the license costs for me to acquire it and pay the annual fees were prohibitive, I had changed the body-text paragraph style to Georgia 10.5pt. Anyway, the odd slippage back into Garamond 9pt would have happened because I must have done some manual formatting, so that when I changed the font style within the paragraph style, those manually-applied formatting changes persisted.

So I called up the Find&Replace dialogue, clicked on Format, and then on the Fonts tab. Now, since Garamond isn't installed, I couldn't pick it from the list. However (and this is really praiseworthy on the LO developers' parts), I was able to type Garamond (with leading cap) into the font text field, choose "Regular expressions, and then enter ".*" (no apostrophes, naturally) into the Search field.

Now, I could fix them one by one, by clearing direct formatting, after noting whether the text should be italic or not, and then setting it italic as needed, after clearing direct formatting. But that, too, was tedious. Useful to do a little, though, to get a feel for the errors and start correcting them.

I could see exactly how it had happened, and it had made sense at the time, but it did have this side-effect that I'd been unaware of. Anyway, understanding the types of errors, I then did a Find All (such a cool LO feature: you end up with multiple separate selections of the matching pattern throughout the document, so you can make changes to those pieces of text in one operation). LO told me it had 299 words and 1,457 characters selected, and I noted that the font size was 9pt in every case (by simply observing that "9" showed in the font size box on the main menu-bar), and then changed the font to Georgia and the point size to 10.5, and that was that!

(Except for LO bug 62603 – aarghh!)

The joy of the "stylesheet.css" file. I thought I'd do a search for other typefaces that might have crept in (Arial, Calibri, Times Roman). I found that there were a few places I'd unintentionally slipped into Times New Roman. Then I realised I could see every single font I had actually used just by looking inside the "stylesheet.css" file inside the .epub file.

And, yes, there were a whole bunch more there. Here's the list, for maximum self-embarrassment:

$ grep "font-family" WildThing-exp5.unz/stylesheet.css | sort -u
    font-family: "Liberation Sans", Arial;
    font-family: "Liberation Serif", serif;
    font-family: "Times New Roman";
    font-family: Calibri;
    font-family: Garamond, sans-serif;
    font-family: Georgia1, serif;
    font-family: Georgia;
    font-family: Times New Roman1, sans-serif;
    font-family: Ubuntu, sans-serif;

Actually, I couldn't make much sense of what was going on when I searched for Liberation Serif: it seemed like a high percentage of paragraphs in the document were in this font: I could clear the formatting so they weren't found, but doing so made no visible difference. And these weren't paragraphs that had proven to be a problem in the conversion. I wondered if some weird font substitution was still going on? The particularly weird thing was that these searches would also find the chapter and part headings – but when they were selected, the font showed as Times New Roman, not Liberation Serif. Yet when I'd searched for Times Roman, they hadn't shown up. (The only pieces of text in the whole MS in Times New Roman were the title and "by L. J. Kendall" on the title page. Because of a bug (feature?) in LO's ToC generation, I had had to add a space character to the end of each chapter title (to make the chapter names actually appear in the ToC). Because of that work around, it seemed like these were all appearing in Liberation Serif. Finding and fixing these was tedious. I couldn't do a Search& Replace because the word "Chapter" and the chapter number were supplied from the paragraph style (they weren't "in" the document body). It turned out that the text is provided via the Bullets and Numbering dialogue's Options tab; the font is kind of defined by the "Character Style" you choose; but I couldn't at first see where these character styles were defined (or modifiable). It was set to "None"; when I changed it to "Header Char", it changed to Liberation Serif, even though it appeared as Time New Roman because that was the font style defined for the Chapter Title style defined in the "Styles and Formatting" dialogue. A bit confusing, eh?

So, in the "Styles and Formatting" dialogue I needed to select the "Character Styles" section, and then change that to Liberation Serif. While there, I set the font size and colour, too. That changed all the auto-formatted chapter titles to be the same: I changed the Character Style for the Prolog to match, but chose not to do so for the Parts nor the Acknowledgement, nor Afterword etc.

So, I checked that after making that change, I checked to see if the "added space" to the title was still being detected as in Liberation Serif when I did my Find&Replace: it was, but I figured that since this was a non-printing character, letting it be changed to Georgia shouldn't make a visible difference. So I went ahead and did a Find All for the Liberation Serif font: this time, it worked harder, finding I think 66,000 words in that font. So I went ahead and changed the font to Georgia, and the font size to 10.5 for all of them. That seemed to make no visible difference, but now when I searched for Liberation Serif, there were no matches.

Whew!

Okay, next on the list of probably-spurious fonts was Liberation Sans: that found only the Acknowledgement and Table of Contents headings – good!

I then checked the others – none of them were used, except for Ubuntu in four places. So, after that, it seemed that I had (finally!) cleaned up my font mess. Oh: and in the Find&Replace dialogue I clicked on the "No format" button to clear the search for font, and also unchecked the regular-expression, so as not to accidentally confuse myself the next time I used the dialogue.

In Calibre, you update the book by choosing "Add files to selected book records" from the Add books menu, and then selecting the (preferably .docx file) for your MS.

I noticed some odd justification; checking back, I discovered that my two-space pedantry had come undone: all the occurrences of a non-breaking space followed by a normal space, between sentences, had been lost somehow. A quick regular expression Find& Replace fixed that. Oh, and for some reason, every paragraph was no longer fully-justified. Re-converting fixed not just the weird spacing problem but also the justification problem. Now all that remained was trying to work out how to centre the chapter headings for the auto-titled chapters (and ideally, add a little space below).

Ha – in checking, I found that the back cover image I'd inserted on the last page, and anchored to the page, had stayed on that page even when the font change had increased the number of pages. It now appeared about 50 pages before the end. So I fixed that, too.

After that, "all" that was required was about half a day of intense and error-prone work to find the single-character "smearing" of regular-into-italics and italics-into-regular caused throughout the MS in every place where there had been a style-change at the edge of where a Find&Replace had operated.

Sigh. But at least that was the last of my problems, and things proceeded smoothly from there.

Okay – once again, this blog post has turned out to be much longer than I expected, so I'll need yet another separate and new post to cover the topic of the nitty gritty of uploading the file to Kindle and making your Amazon Author page and making updates. So I'll leave it there, for today. Stay tuned!

A Nice Table of Contents

Oh, one thing I did to make the Table of Contents nicer was to delete the leader-characters and page numbers from the auto-generated table of contents, leaving just the (useful) hyperlinks for the ebook edition. I've also found a problem, due to LibreOffice's bad habit of breaking runs of characters into separate logical spans of text. This means that if you edit any text in your ToC, and new text you type in will be in a separate text span. This was very visible because I'd chosen a colour for my ebook chapter titles (not plain black), so edits became very visible, as thed edit was in black and the auto-generated text was blue.

Editing the ToC manually to delete the leader characters (the row of dots) and the page number reference (mostly useless in an ebook), after the 1st time, instead of doing it manually, I used the Find&Replace dialogue: I turned on the Other Options, selected Regular Expressions, put nothing in the Replace With field and this text (without the quotes) in the Search For field: "\[0-9][0-9]*", and then quickly replaced each one.

Poking about in Calibre and .epub

So I copied the .epub file Calibre had produced, into a temporary directory to play with. The 1st step was to unzip the .epub file. Now, I noticed there were far more "index_split" files than there were chapters, and so I opened the first few of these files, and the content.opf, page_styles.css, titlepage.xhtml, and toc.ncx files. I immediately noticed a few unexpected things: text was still being broken up into some very short runs of characters, with different paragraph styles for each run. When I got to the stylesheet.css file, things started becoming clearer. That file defines all the paragraph styles in a very human-readable format, and it became obvious that I apparently had sections of text that looked the same, but which weren't. Since the paragraph style names created by Calibre are pretty distinct (like p-p1, p-p2 and so forth), it meant it would be easy to search the html files to see where they were used. In that way, I could find where I'd used these odd styles, and change the original MS to remove the weird styling.

Now, the 1st problem in my epub version is that Table of Contents (TOC) puts each line of the TOC on a separate page! Looking in the toc.ncx file, I see it looks like this:

<navPoint id="ujwaAQQK4di35KOrpmPFchB" playOrder="1">
      <navLabel>
        <text>Prolog 1</text>
      </navLabel>
      <content src="index_split_004.xhtml"/>
    </navPoint>
    <navPoint id="utE7axnMMjYH5AzmPYfyOp2" playOrder="2">
      <navLabel>
        <text>Part I 14</text>
      </navLabel>
      <content src="index_split_005.xhtml"/>
    </navPoint>
    <navPoint id="uyHLH5SBCmIBt42iiswSe24" playOrder="3">
      <navLabel>
        <text>Chapter 1 15</text>
      </navLabel>
      <content src="index_split_006.xhtml"/>
    </navPoint>

So it looks like the page-breaks must be inside the actual content files like "index_split_004.xhtml". Looking inside that shows that the text is "Prolog 1" as you'd expect, but that instead of being a normal paragraph, it's defined to be a header element (H1). That seems odd. Look:

<h1 class="p-p18" id="calibre_toc_2">
   <a href="index_split_075.xhtml#anchor8" class="s-t">
       <span class="s-t4">Prolog 1</span>
  </a>
  <a id="anchor9" class="s-t"></a>
  <a class="s-t"></a>
</h1>

Another odd thing there is that there are three anchor points: the 1st with the text "Prolog 1" and ID "anchor8", a 2nd with no text/content but an ID of "anchor9", and a 3rd with, again, no text/content, all the empty anchors with class "s-t", the "Prolog 1" text with styles-t4. I don't understand that. Looking again at the stylesheet.css, I see that the "s-t" class defines a style with 0 margin, 0 padding, and a 1.2 line-height, and s-t4 is the same but with font-height 0.77419em.

Ahhh...! Perhaps because I manually reformatted the main block of the TOC to be 9pt, and the PARTs to be 10pt? And the 1st anchor is for the left text, the middle for the leader/spacing dots (omitted) and the 3rd for the page number? Sounds plausible, except the page number is in the 1st anchor, not the 3rd. Hmm. It kind of matches the definition at http://www.w3.org/TR/html5/text-level-semantics.html#the-a-element which says that if you leave out the actual link, "then the element represents a placeholder for where a link might otherwise have been placed, if it had been relevant, consisting of just the element's contents." So: why is the page number inside the 1st anchor, not the 3rd? The anchors are often used to indicate clickable content.

What is a class, anyway? Sitepoint says that an HTML element's name (like "h1" or "div" or "a" or "p" specifies headier, division, anchor and paragraph), the "class" attribute let's you specify one or more subtypes. These subtypes are used to label semantically-similar things for identification, so that CSS or JavaScript code can then do clever stuff like define some properties or do something to all elements in the whole document structure (DOM) that have that subtype.

It also means that if I want to auto-remove the page numbers from the TOC entries, I may have to remove it from both the index_split_004.xhtml file and the toc.ncx file – something to keep in mind. So: does this mean I should manually delete the TOC from the MS and regenerate one with page numbers turned off? Or write a script to do the edits, so I can keep a single MS file? Or maybe insert two TOCs, one designed for epub and one for print, and write a script to delete one or the other depending on whether I'm generating an ebook or a pbook? Or, is there a tweak in Calibre itself I could do? If you click on "Convert books" and then on the "Structure Detection" button, it shows you the code it uses to "Detect chapters" (which looks perfect to me), and also to"Insert page breaks", which again looks good, and explains where the 1-page-per-TOC-line problem is coming from: each line is of style "H1", so it's of course getting a page break.

So it sounds like a 1st step might be just to regenerate the TOC in the MS, and not fiddle at all with the formatting, and then see what Calibre produces.

Ah, and I see in Calibre's "Heuristic Processing" conversion option, one that says "Renumber sequences of <h1> or <h2> tags to prevent splitting" – that sounds like what I want, so the problem may become very simple to solve. Hmm: nope. It now has two lines of the TOC per page! An improvement but not a solution.

Oh, and while fiddling with fonts, noticed the paragraph indent was an absolute unit of measurement (cm) instead of relative (points). So:

To change the measurement units used in this dialogue, choose Tools - Options - LibreOffice Writer - General, and then select a new measurement unit in the Settings area.

Hmm, tried again after fixing up far more font-change issues than I expected: I did have several messes. Now, it's all in Georgia, 10.5pt. TOC still wrong. Changed an option to force it to use the auto-generated TOC – I assume that means the one in the .odt file…

"Appendix – Kindle's HTML"

Most of the text below (apart from the occasional editorial remark in italics) is directly quoted from the Support Indie Authors forum on Goodreads.

Never specify fonts or font sizes.

Use percents for indents and em's for margins.

Limit use of symbol characters (try to use HTML symbol codes) and in-line formatting. (We only use bold and italics -- not even super and subscripts.)

But Morris noted (good tips here http://www.morrisegraham.com/):

You can, and should specify font sizes for chapter and title headings. This is done by specifying size in the style part of your header by using a CSS style.

Like....

p.h1
{
font-size: 1.5em;
text-indent: 0em;
text-align: center;
font-weight: bold
}

note that when I use an h1 header in my body, it causes the text to be 1.5 em, which is 1.5 times the width of the letter "m." So when the customer on the end adjust font size in their ereader device, the titles and chapter headings stay relative in ratio and proportion to the deafult font size. You can only get this kind of control by doing your book in notepad and then converting it to eBook with a converter later.

But Owen then noted:

If H1, H2, H3 etc tags are used, each device will display them in their own different default size. You can of course define your own styles and adjust the sizes if you want to, but we've always been happy with the defaults.

Micah noted:

One thing that always bugged me about the KDP defaults is that they automatically stick a huge extra line of space between paragraphs. This makes intentional section breaks very difficult for the reader to interpret. To avoid Kindle sticking in extra space, you do this (presumably in the CSS section):

I just define the normal paragraph properties:

p
{
text-indent: 1.3em;
margin-bottom: 0.2em;
}

I found that setting the bottom margin to 0 seemed a bit too tight, and also thought the default text indent was too large for most eReaders. But you can adjust them as you like.

And he added:

Oh, and another thing which I find a bit odd about Amazon's eBook formatting: if you do not hard code in justified text, Kindle eReaders will justify the text by default.

That's not an issue, however what may be an issue is that this default justification does NOT show up in their Look Inside feature.

I have not hard coded justified text, so in the Look Inside preview, it appears as if my books have left justified text. But in an actual eReader they show up with fully justified text.

Owen shared lots of good info:

In our case, we specify a "normal" style in our style sheet for all normal text that is:

p.Normal, li.Normal
{margin-top:.60em;
margin-right:0;
margin-bottom:0;
margin-left:0; 
text-indent:5%;
}

Our paragraph style (which is hardly ever used) is:

p
{margin-top:0;
margin-right:0;
margin-bottom:0;
margin-left:0; 
}

Our heading styles follow this format:

h1
{margin-top:2em;
margin-right:0;
margin-bottom:.30em;
margin-left:0;
border:none;
padding:0; 
font-weight:bold;
}
h2
{margin-top:0.6em;
margin-right:0;
margin-bottom:0;
margin-left:0;
border:none;
padding:0;
text-transform:uppercase;
font-weight:bold;
}

h3
{margin-top:0.6em;
margin-right:0;
margin-bottom:0;
margin-left:0;
border:none;
padding:0;
font-weight:bold;
}

h4, h5, h6
{margin-top:0.6em;
margin-right:0;
margin-bottom:0.6em;
margin-left:0; 
text-align:right; 
font-weight:normal;
font-style:italic;
}

We've never set the text justification manually. I was unaware until Micah mentioned it that anyone would think this "unprofessional", since I would have thought that readers of eBooks would be aware that the Amazon "Look inside" feature formats things differently than eReaders. I don't think I want such people reading our books anyway (our characters often speak and act "unprofessionally" and that might annoy them?)

I have read that some readers find left justified text easier to reader. I suppose there might be some worth in not hard-coding the justification in case their device allows them to select that option?

And also:

Igzy wrote: "If it's not too much trouble could one of you offer an example of two properly formatted paragraphs laid out together? I'd be much obliged if I could see the tags in action, as I'm not familiar with HTML formatting. "

No problem. Of course GR interprets HTML code, so this example used parentheses in place of pointy brackets, thus ( = < and ) = > . This is how we begin a chapter, with notes after the ||:

(br clear=all style='page-break-before:always') || This tells the Kindle converter to break the page. Below are the headings: heading 3 for the main, and heading 4 for the sub, which is italic and aligned right.

(h3)(a name="_Toc410049128")Prologue: Zero Day(/a)(/h3) || name ID's the target for the TOC link.

(h4)Janin Station;(br) || br is a linefeed (line break)

Tau Verde, Vulpecula Region(/h4)

(p class=NormalBlock)It was make-and-mend day for the Halith Imperial Navy’s Kerberos Fleet ... ruled the lives of Halith mariners—especially when the fleet was lying up at a comfortable port like Janin. (/p) || This a paragraph container. HTML designates the beginning of a container with a code, just p here -- h3 above -- and ends it with a / in front of the code: /p. "class" defines the type of paragraph as defined in the style sheet. The is flush-left paragraph with extra space at the top. The CSS entry for it is below.

(p class=Normal)Watchstanding and sensor sweeps ... guarded by a ring of monitors. (/p) || This is a standard text paragraph. 


p.NormalBlock
margin-top:2.5em; || creates the extra space. Note there is no text indent. 
margin-right:0;
margin-bottom:0;
margin-left:0; 
}

That is 90% of an HTML text doc right there (with the CSS examples above, in the previous posts). Yes, you see a lot of godawful gibberish in the code here and there, like style="much gibberish" or (span style="much gibberish") (/span). Almost all the time, that is unwelcome. Word will put it in to try to mimic the exact look of a doc in IE -- not what you want.

And Amazon have their own guide which comes recommended:

"Building Your Book for Kindle", and the ebook is free.