Clarifying Source Files: How To Use Them

I’ve done a lot of talking about source files, and inadvertently confused some folks. I don’t mean to muddy issues–it just happens. So I made a chart! (Aren’t you glad you stopped by?)

The SOURCE FILE is just that. The source from which everything else springs. You don’t format it (beyond what is necessary for YOU to comfortably compose) because you DO NOT NEED TO. Essentially, while composing original works the more you act as if your word processor is a typewriter (except for tabs–no tabs!), the cleaner it will be and the easier it will be for you or someone else to format it for a specific use.

Once you have a Source File, you MAKE COPIES of it in order to format it for a specific purpose.

Let’s say you’re sending a manuscript to XYZ Publishing House. You need a printed document. You open the source file and do a Save As to make a copy. In that copy you will insert a cover page, header, page numbering, and adjust the margins and font according to the publisher’s guidelines. The source file remains intact, unchanged.

You want to self-publish your novel. You open the source file and do a Save As to make a copy. You can send that copy to a hired formatter and let them take it from there. You can format a .doc file in Word according to the distributor guidelines. You can hand code the copy in html. The source file remains intact.

I didn’t include every single way to format a file, but you get the picture, right? Let’s say you published your ebook. A reviewer would like a pdf file. You do a Save As, make a copy and format a pdf. You want to make an electronic submission? Do a Save As, add your address block, maybe change the font and line spacing, and you will submit a nice clean file that agents and editors can easily read on almost any computer or device.

If you look at my chart and think this is terribly complicated and I’m trying to make extra work for people, you are wrong. When it comes to digital files, there is no One-Size-Fits-All format. If you get in the habit of creating your original files in a no-frills, minimally formatted style it will save you work, save you time, and save you headaches.

I hope this clarifies things.

 

-SB-, -PB-, and Italics

So I’m chatting with a friend and she asks, “What you doing?” I sez, “Nuking tabs. Bwahaha! All gone.”

I was, of course, prepping a manuscript for ebook formatting. That means going through the manuscript and getting rid of everything that will screw up the ebook.

My learning processes are always convoluted, in the beginning overly complicated and then as I figure out what’s important and what is not, I streamline and pare down to the essentials. If you are a regular follower of this blog, you’ve seen my process regarding source files for writers. I’ve gone from suggesting writers set up and use style sheets (they should) to what I’m going to suggest today.

When creating a source file with the end goal of turning it into an ebook, all the writer needs to do, formatting-wise, are three things:

  • Indicate page breaks
  • Indicate scene or section breaks
  • Italics, bolding and underlining

When it comes to page breaks, “indicate” means exactly that. Don’t actually break pages either with inserted page breaks or multiple paragraph returns. Why? Because when you’re ready to format, you or the person you hire has to take them out.

The more formatting you put into your source file, the more formatting that has to be removed. The more that has to be removed, the greater the chances of something that might be missed (screwing up the ebook) and the more it costs in time and money.

When I get a manuscript to format, it’s generally been created with a word processor. Whether I’m going to format it for Smashwords (a Word file) or for everything else (html files), the very first thing I have to do is–

  • Remove extra spaces
  • Remove extra paragraph returns
  • Remove page and section breaks
  • Remove headers, footers and page numbers
  • Tag page breaks
  • Tag scene or section breaks
  • Tag special formatting

I don’t actually have to remove tabs because those are going to disappear when I transfer the text to a text editor, but it’s easy (one Find/Replace operation) and it gives me a clearer picture of the dangerous stuff.

Now, seriously, I’m a writer. I fully understand the NEED to make the manuscript look RIGHT. But writers, you have to understand that every effort you make to that end is going to have to be undone. Because of the nature of word processors, some of the fancy touches you include can actually corrupt the ebook.

The less you do–Honestly! Truly! I’m not lying about this!–the better the ebook will be.

So what’s a poor writer to do? Not much, actually. Use whatever font and font size you like. That’s not what will end up in the ebook, but use whatever is comfortable for you while composing. Line space however you like. It makes no difference in the end. Get out of the habit of using tabs. If you can’t stand not having indented paragraphs, set up a simple style sheet that indents the paragraphs with every hard paragraph return. Get out of the habit of two spaces between sentences. Get out of the habit of adding extra hard paragraph returns to space the text. Get out of the habit of making pages. There are no pages in ebooks.

How does one indicate a page break?

I use a code. -PB- It’s unique, the dashes keep it from melding with text, and thus it is easy to find. What my clean file looks like before I take it to the text editor is this:

Final line in chapter one.
-PB-
Chapter Two
First line in chapter two and so it goes.

Use whatever makes sense to you. If you want to make extra sure you or your formatter don’t miss it, spell it out. -PAGE BREAK- That’s it. That’s all you have to do. When you do the actual formatting, that’s when you center, bold, add graphics, extra spacing, etc.

Scene breaks are another place you should get in the habit of tagging–especially if your habit is to use extra paragraph returns to make a blank line. Those can be easy to miss. My little code is -SB-. The text looks like

Last line of scene or section.
-SB-
First line of new scene or section.

It doesn’t matter much what you use as long as you use something. Asterisks, a pound sign, plus signs, or spell it out -SCENE BREAK-. Use something so the scene break doesn’t get lost.

As for special formatting–italics, bolding and underlining–at some point, whether you do the job yourself or hire it out, you are going to have to tag the special formatting. I’ve gotten into the habit with my own writing to tag as I write rather than highlighting the text and italicizing (or whatever). It’s easier in the long run and I’m used to how it looks. Most writers are not going to want to do that. No biggie. If you are going to tag your special formatting, a few things I have learned–

  • If you’re going to format in html, you know to tag the special formatting with open/close codes.< i > and < /i >
  • If you are going to format your ebook in Word and are tagging for the purpose of stripping extra coding out of the document, do NOT use html tags. Using < i > TEXT or Wild Card < /i > in the Find box of a word processor can have… interesting results. Not the fun kind of interesting either.
  • For Word files I use -I- and -ENDI- to open and close italics. Easy to find and doesn’t give Find/Replace fits.
  • Make sure your special formatting is paragraph specific. In other words, don’t just highlight big blocks of text and toggle on italics. Highlight the necessary text within each paragraph, italicize it, then do the same in the next paragraph. Fewer chances for conversion programs to argue about what you really mean.

That’s pretty much it. To get the best results in your ebook, no matter who does the formatting, copy the following, print it out, and tape it to your computer monitor as a reminder:

This is a FILE not a document. Less is more. Less is good. The less you do now, the less you have to do later.

 

 

Cheat Sheets for Ebook Formatting

For all you brilliant people who write short, snappy, easy to understand How-To guides (about anything) I bow to your great talent. It’s hard to do!

For quite a while I’ve been promising to post cheat sheets on what I’ve learned and am learning about ebook formatting , but quite frankly, folks, writing something that doesn’t sound horribly complicated or even ridiculously complicated is damned hard to do. I’ve started them, revised them, chucked them out, started over, screeched in frustration and wondered what the hell is wrong with me that I can’t even explain something as simple as a search function without making it sound like building plans for the Sistine Chapel.

But I had the bit in my teeth and I was determined to keep going. What saved me was the knowledge that I can always change, update, refine and otherwise make the cheat sheets better as I get better.

What truly motivated me to keep going is the knowledge that ebook formatting—formatting beautiful functional books—is NOT THAT HARD. One should not have to be a computer whiz (which I am not) or a computer programmer (which I am not) or a graphic designer (which I am not) in order to turn one’s written work into an electronic file suitable for distribution into the major markets. There is a learning curve and it does require paying attention to details. What it doesn’t require is a degree in computer science, specialized equipment or expensive programs. If you’re composing your work on a computer and you’re reading this, you already have the tools you need.

The cheat sheets I’m posting are NOT comprehensive—know that up front. They are based on my experiences, things I’ve learned and obsessed about and tinkered with and actually tried. I’ve formatted about 50 ebooks so far and still have a lot to learn. That is a roundabout way of saying, I’m always open to suggestions. Tips, tricks, problem-solving, all are welcome. In fact, it would be fun and useful to make a feature along the lines of Tips From Readers. (hint, hint, folks, send them in—I post links…)

The cheat sheets are not just for formatters—they’re for indie writers. If you have a work you’re going to self-publish and you’re looking for information about how to go about it, but you intend to hire someone to format your book for you, you’ll find information about distribution and source files and organizing your book and how to work with a formatter. I’m breaking the cheat sheets down into components, so you only need to read what’s relevant to your needs.

Anyway, take a look at the header bar where it says CHEAT SHEETS FOR EBOOK FORMATTING. There’s a drop-down menu. There are three cheat sheets live already and more to come. So watch this space.

If you want to talk to me about your book or need some clarification, you can email me at

jayewmanus at gmail dot com

You Say Documents, I Say Source Files

A manuscript formatted for print, complete with header.

I’ve been creating manuscripts for well over twenty years. I can rattle off the formatting in my sleep. Double-spaced, one inch margins, header with page number top left corner, drop to middle of page to start a new chapter, blah blah blah. It’s a manuscript. A document to be printed and stacked and tucked in a box or an envelope and put in the mail. Who does that anymore? Oh sure, some agents and editors still insist on hard copies, but they’re in the minority and growing rarer by the day. Even though most agencies and publishers have gone digital, even though more and more writers are finding markets online and many are self-publishing either ebooks or POD, old habits die hard. Writers are still producing documents when they should be producing source files.

Whatever do you mean, Jaye?

Many writers, especially those who’ve been around a while, treat word processors like typewriters. We want to see on the screen what we want to appear on paper. Word processors are very accommodating that way. Most aren’t WYSIWIG, but pretty close. If we center text on the screen, it centers in the printout. If there are 24 lines on the screen, 24 lines print on the page. The printer doesn’t care if we indent lines with tabs, first line hanging or hit the space bar five or six times. It prints as an indent. If all you ever intend to do is create printed documents, then you can quit reading now. If you intend to submit electronically or create an ebook or a POD book or make pdf files, then listen up. It is time to break the document/manuscript habit.

You see, a clean source file can be copied indefinitely and used to create printed manuscripts, digital files for electronic submissions, ebooks, pdfs and POD books. With a clean source file an agent or editor can read your submission on a computer, smart phone, iPhone, iPad, Kindle, Nook, tablet or whatever else they might happen to have and your work will be readable. With a clean source file you can easily make a copy to create a professional looking printed document for that guy still living in 1973. And with a copy of that same file you can format an ebook that will convert cleanly for Smashwords, Amazon, Nook or whatever–or send it to a professional formatter who can turn it around in a matter of hours. Then you make another copy and format that for a slick pdf to send to reviewers. And you can snag a template off CreateSpace or Lulu and load it with your nice clean file and create a POD book. All the while that source file is sitting on your computer, nice and clean, and ready to be turned into whatever you happen to need next.

A Clean, Plain Jane, No Frills Source File, Created in MS Word

There is nothing difficult about creating source files. They are straight text files, nothing more. The difficult part is getting out of the mindset of seeing it as a printed document living on your screen. I know, I know, old habits die hard and writers, especially fiction writers, get a bit freaked out by the lack of page numbers, headers, page breaks and centered chapter heads. Trust me, get into the new habit of creating source files and it could save you from rejections (I wonder how many agents and editors have rejected submissions out of hand just because they couldn’t read the text on their iPhone or it turned into gobbledegook on their computer screen and rather than walk the writer through how to set up a file, they just said to hell with it); it can save you from the frustration of having Amazon or Smashwords reject your ebook (you followed their instructions!) or worse, getting it through the conversion process only to discover your ebook is live, but horribly corrupted; and it can save you money if you hire someone to format your ebooks or your POD book and they have don’t have to charge extra to clean the junk out of your file.

To create a clean source file:

  • Turn off all Auto-Correct/Auto-format functions in your word processor (especially if you use MS Word). Turn off widow and orphan control.
  • Set up a simple style sheet to take care of the font, line-spacing, and indents. Apply it to every source file before you begin a new project and use it religiously.
  • No tabs. NO tabs! NO TABS EVER NEVER NOT EVEN ONCE!
  • No extra spaces between sentences or at the ends of paragraphs.
  • No extra paragraph returns (if you have a scene break, indicate it with the pound sign or three asterisks). Do not use paragraph returns to drop your chapter heads to the middle of the page or to create a page break.
  • No page breaks–of any kind.
  • No centering text–not chapter heads, titles, poetry, nothing (easy way to track chapter breaks, use all caps CHAPTER ONE or bolding)
  • No special characters. Use “typewriter” characters such as two dashes to indicate an em dash and a slash mark for fractions. Avoid super- and subscript characters. If your text contains foreign characters, Anglicize the spelling and track the usages so the special characters can be inserted when the file is formatted for whatever purpose.
  • Even in Word, italics, bolding and underlining don’t seem to screw up a source file. Those are safe.

I’ve had people tell me, “But I need page breaks or nobody will know how many pages there are!” Nobody will be able to tell anyway unless you intend to print out the file on 8.5 x 11 20# bond. And then I’ve been told the writer knows how they want the document to look, so it’s okay. Trouble is, they know how it looks on their screen and how it looks coming out of their printer. They do not know how it looks on an iPad or iPhone or Android or Nook or Kindle or an agent’s Mac (you use a PC) or vice versa. Trouble is, every bit of formatting they do adds code to their file and that code can be misinterpreted or corrupted by another device. If you hire someone to create an ebook, they will look at your wonderful page arrangements, and tack on extra charges to the estimate because the first thing they have to do is get rid of everything you’ve done.

It takes some conscious thought to break old manuscript habits. You can get used to it. Just keep repeating: Source File, Source File, Source File…

In the Formatting Wars, How Writers Can Win

In my post earlier this week I talked about standardizing ebook formats. My friend, Jonathan Allen, did a pretty good job of explaining why there are so many platforms and proprietary formats for ereaders. Today he continued the explanation as to why it probably is going to take quite a while before we have ONE format and universal ereaders. Even though I now have a better understanding about how the situation turned into a mess and what it will take to untangle it, I don’t hold out much hope the situation is going to resolve itself anytime soon.

As a writer and ebook producer, this is not particularly heartening. I guess I hoped that if I turned my energies toward learning HTML, all my stress would magically disappear. Now I know that is not true. And it is stressful. I just finished a big project. (It turned out great, by the way, I am very proud of it–you can look at it here) The night before I had nightmares about the book being all messed up. After uploading it yesterday to Amazon, while it was in review, I tossed and turned and fretted all night that the book would be all messed up. Today I uploaded it to Smashwords and my stomach is clenched up with worry that I accidentally did something that will mess up the book.

All it takes is one little bit of wayward code that I can’t even see and weird crap could show up on some unsuspecting reader’s device.

Ay yi yi.

All is not lost. While the computer wizards are hashing it out, there is one thing we writers can do to make sure our ebooks don’t become casualties of the formatting wars.

Clean source files.

I bet 80% of the writers who read this post use a version of MS Word. As much as Word frustrates me because it’s so darned helpful, I love the way it produces documents. Therein lies the problem. To produce those gorgeous documents, Word uses a lot of codes, hidden and unhidden. In a printed document, it doesn’t matter how much junk is hidden in the file. Most printers have no beef with MS Word. In most cases, whatever you tell Word to print, it will gladly do so. Ebook files, however, are not documents. Much of that lovely formatting–tabs and extra paragraph returns and centering and font changes and special characters and headers and footers and page numbers and footnotes–will be interpreted by other programs as junk that needs to be fixed. Or some program, somewhere, might throw up its hands in despair and fill a screen with gobbledegook.

Writers who intend to publish their writing as ebooks–whether they do the formatting and conversions themselves, or hire someone else to do it–need to get out of the “document” mindset. What they need to start doing is thinking of the composition–the novel, short story, article, whatever–as a “source file.” Start thinking of formatting as a completely separate process. You compose a source file, then you use a copy of it to create a printed document, a pdf, an ebook or whatever else you require. There is no special formatting in a source file.

I repeat: THERE IS NO SPECIAL FORMATTING IN A SOURCE FILE.

The suggestions that follow are for Word users, but no matter what word processor you’re using, you can adapt to suit your needs.

  1. No tabs. Ever. Never ever use the tab key in a source file. Not even one for good luck. No tabs!
  2. No extra spaces. Not between sentences, not after paragraphs, not at the top of the page, not to indent a passage, not to set off text. No extra paragraph returns either.
  3. No page breaks. But, but, Jaye, what about between chapters? No. Not even one.
  4. No headers. No footers. No page numbers.
  5. Turn off Auto-Correct and Auto-Format. You are safe with leaving on italics, bolding and underlining, but everything else, turn it off. Even curly quotes can cause a problem, so turn them off, too.
  6. Use “typewriter” special characters. Two hyphens for an em dash. Three connected periods for an ellipses. (c), TM, (R) instead of the special symbols. Do not insert subscript and superscript characters. If you have words requiring umlauts, accents or whatever, keep track of them. They can be made right during formatting.
  7. No bullets or ordered lists or outlines.
  8. Set up a Source File style sheet. (I give instructions for how to set up style sheets in Word here) Make it simple, bare bones, with a font you like to work in. Use it religiously.

Source files are plain as milk and not particularly pretty. What they should be is clean. Make a copy of your source file to create a printed document with headers, footers, special characters, centering, specified page breaks, and whatever you desire. Make a copy of the source file to format your ebooks according to different platform requirements. If you outsource the work, include a set of instructions to the formatter as to how you want your book laid out, along with a list of special characters, symbols and any special formatting you desire.

That’s how we keep our heads during the format wars, Writers. Clean source files. Make those standard and we can endure the wait until the powers-that-be, whoever they are, get their act together and stop making things difficult for the rest of us.