An American Editor

August 23, 2019

Measuring and Managing for Greater Productivity and Profit

By Jack Lyon

The famous management consultant W. Edwards Deming is often quoted as saying “If you can’t measure it, you can’t manage it.” Here’s what he actually said: “It is wrong to suppose that if you can’t measure it, you can’t manage it — a costly myth.” (The New Economics, 35.)

An example of something that can’t always be measured (but can be managed) is the quality of copyediting on a particular manuscript. Two different editors might not always see the same problems or fix them in the same way. So how do you manage your effectiveness as an editor? Is it based on your consistency in styling citations? Does it depend on your knowledge of a manuscript’s subject matter? Could it have to do with the comprehensiveness of your reference library? Copyediting depends on a number of factors that can only be described as subjective.

But unless you’re editing only as a hobby, there is one thing you should definitely be measuring and managing: your income — to be specific, your effective hourly rate. American Editor Rich Adin has written about this at some length (see, for example, “Thinking About Money: What Freelancers Need to Understand” and “Business of Editing: What to Charge”), and you should definitely read and heed his advice about this. You’re probably someone who works mostly with words, so don’t be put off by the math in these articles! It’s really important to understand what Rich is saying.

I know editors who make just enough money to stay above the poverty line; I also know editors who consistently make an income of six figures (yes, really). Would you like to know what makes the difference?

Those in the first group charge by the hour.

Those in the second group charge by the project (or the page, or the word, or even the character).

If you charge $50 an hour for your editing services, the most you can ever make is $50 an hour. But if you charge $5 a page, your hourly income depends on how many pages you can edit during that hour. If you can edit 10 pages, you’ll still make $50 an hour. But if you can edit 20 pages, you’ll make $100 an hour. To do that, you’ll have to be more productive (while still maintaining your usual quality), which means you’ll need the Microsoft Word add-ins I provide at the Editorium, particularly Editor’s ToolKit Plus.

Daniel Heuman’s PerfectIt will add even more to your productivity by automatically ensuring the consistency of your work.

Rich Adin’s EditTools provides a wealth of features created especially for the working editor. I particularly like Never Spell Word and Toggle Word.

To manage your effective hourly rate, though, there’s one thing you really need to measure: how many hours you spend on every project you edit. Now, if only someone would invent some software specifically for editors to track those hours. Well, that’s exactly what Rich Adin has done in his latest version of EditTools.

Rich calls this new feature Time Tracker, and you’ll find it on the left side of the EditTools ribbon:

Time Tracker on EditTools Ribbon

Time Tracker on EditTools Ribbon

Time Tracker alone is well worth the price of admission, even if you never use any of the other features in EditTools (although you will). I won’t go into all the specifics about how to use Time Tracker, because Rich has already done so in an impressive series of articles at An American Editor called “It’s All About the Benjamins” (the complete 55-page Time Tracker Help file in PDF format is also available for download). And by “Benjamins,” Rich means money — which you should have more of, if you follow his advice and use this new tool.

By keeping careful track of the amount of time you spend and the amount of money you make on each project, you’ll soon be able take advantage of the PDSA (Plan-Do-Study-Act) cycle, made popular by our old friend W. Edwards Deming. The Deming Institute defines this cycle as “a systematic process for gaining valuable learning and knowledge for the continual improvement of a product, process, or service.” Making money, for example.

If you keep track of your effective hourly rate (EHR), you’ll be able to answer questions like these:

  • What kinds of jobs bring in the most money?
  • Which clients actually pay the best overall?
  • When during the day am I at my most productive?

Then, using the PDSA (Plan-Do-Study-Act) cycle, you can do things like this:

  • Focus on the kinds of jobs that bring in the most money, and turn down those that don’t.
  • Solicit more work from clients that pay the best, and drop those that don’t.
  • Work when you’re at your most productive, and do something else when you’re not.

As you continue to use this cycle of improvement, you should see dramatic improvements over time in your overall income. Others have done it, and you can, too. It’s simply a matter of measuring and managing, using the right tools to improve your productivity and efficiency, and collecting and analyzing the data.

Jack Lyon (editor@editorium.com) owns and operates the Editorium, which provides macros and information to help editors and publishers do mundane tasks quickly and efficiently. He is the author of Microsoft Word for Publishing Professionals, Wildcard Cookbook for Microsoft Word, and of Macro Cookbook for Microsoft Word. Both books will help you learn more about macros and how to use them.

July 5, 2019

Why Do You Edit?

By Daniel Heuman

When I present at editing conferences, I’ve started asking the audience one question: Why do you edit?

The answers I get back are amazing and diverse; for example:

  • I like helping people tell their stories.
  • I contribute to medical research and change lives.
  • It gives me a good work-life balance.
  • I make science happen.
  • I help people communicate.
  • I get paid to read books!

The one answer that I’ve never heard is “I like checking consistency of hyphenation.” Nobody has ever told me that their driving force, the reason that gets them out of bed in the morning, is “making sure abbreviations are defined when they are first used.” That’s why editors love PerfectIt. It makes the mechanical elements of editing faster and easier, so you can focus on what matters. And that’s why I’m excited to announce the details of PerfectIt 4, our first new edition for Windows users since 2015.

The Basics of PerfectIt

If you haven’t used PerfectIt, its core philosophy is that humans make the best editing decisions, and they always will. The role of software is to help people make those decisions faster. PerfectIt doesn’t know what’s right. Instead, it alerts you to points in the document that could be errors. It leaves every decision up to you.

Here are some of the errors that PerfectIt helps you find:

  • Inconsistent hyphenation (e.g., “email” in one place, but “e-mail” in another).
  • Abbreviations that haven’t been defined or have been used before they’re defined.
  • Capitalization inconsistency (e.g., “Government” or “government”).
  • Brackets and quotes left open.
  • Numbers in the middle of sentences (spelled out or in numerals).
  • Inconsistencies in list punctuation and capitalization.
  • Use of sentence case or title case in headings.
  • Different spellings of the same word (e.g., “adviser” or “advisor”).
  • Common typos that spellcheck won’t find (no more “line mangers” or “pubic consultations”).

You can also use PerfectIt to enforce house style rules. The program is customizable so you can build in your own preferences. That’s useful for both freelance and in-house editors. If you’re a freelancer, PerfectIt lets you build in a style sheet for each client so it’s easy to keep track of different preferences. For an in-house editor, PerfectIt helps you enforce your style manual. You can set up your team with PerfectIt and make sure everyone at your organization follows the style manual (at long last).

PerfectIt doesn’t do anything that you can’t do. You can find and correct every error described above manually. However, these errors are time-consuming to find and easy to miss — and checking them is not why you edit! Checking mechanical errors is necessary work, but every minute you can save on the mechanics is more time for substantive editing.

What’s New in PerfectIt 4

In PerfectIt 4, we concentrated on one thing: increasing that time saving. We did that in two ways: improving PerfectIt’s initial scan and changing the interface. You can see it here.

In the past, PerfectIt’s initial scan was when you could step away from the computer and treat yourself to a cup of coffee or check your social media. With PerfectIt 4, a scan that could take as long as 5 or 10 minutes is now over in seconds. Coffee and social media will have to wait!

The biggest change in the interface is that every location now has a separate fix button. That makes it easier to use the preview text to see context and make changes. The time saving is just a second or two for each fix. However, the effect is cumulative. If you save a second or two on each fix, that can be a minute or two on each document. When you add that up over the course of a year, it’s significant.

Time savings aren’t the only improvement. We’ve also made changes to PerfectIt’s styles. We’ve added support for GPO Style, and we’ve updated WHO Style, UN Style, EU Style and American Legal Style. In addition, you can now base a style on an existing style. So if you do legal editing, you can start with PerfectIt’s built-in American Legal Style and build your own preferences on top of that.

Do More of What You Love

We made saving time the focus of PerfectIt 4 because that’s what every professional needs. Time saved on mechanics is more time for substantive editing (or more time for family, hobbies, and things that have nothing to do with editing). Do something you love. Checking for consistency mistakes is an important part of the job, but it isn’t why you edit.

Daniel Heuman is the CEO and founder of Intelligent Editing. PerfectIt is available for a 14-day free trial or a $70 per year purchase at intelligentediting.com. You can purchase it for just $49 per year (30% discount) if you’re a member of one of these professional editing associations.

August 13, 2018

On the Basics — All the Backups

Ruth E. Thaler-Carter 

A recent Facebook group post from someone whose computer conked out when she was on deadline for a project reminded me of the importance of different kinds of backup. We’ve talked about backing up files, but that’s different from backing up equipment — perhaps because equipment can be so expensive, while backup systems can be free, or at least less expensive than buying an additional computer.

Because our ability to meet deadlines and keep our commitments to clients is essential to a freelancer’s business survival, it’s worth assessing what kinds of backups we need to make that happen. These suggestions might seem obvious, but should be useful reminders of practical basics for a freelance business.

The Ephemeral

First, the easy — and inexpensive — stuff. To make sure files and documents don’t disappear mid-project, open an online backup account on Dropbox, Box.com, Google Drive, or something similar so you can stash items as you go along and once you’ve finished them.

If you believe in “belts and braces” (both a belt and suspenders to hold up a pair of pants, even if just one or the other would do the job) as I do, back up to Time Machine as well as an external hard drive, disks, or any other physical backup system that you find easy to use. Backups to your backups are essential, because you never know what will continue to work and which providers will stay in business.

Make sure your essential software programs are live and licensed on every computer you have, and that you have the original disks or downloads so you can reinstall them as needed. That way, if the software goes wonky on one machine, it should still work on another, or you should be able to reinstall it on a new one (or maybe even on a friend’s loaner, temporarily). Keep in mind that many, if not most, programs can be licensed for more than one computer. Know about those options before you need them.

Oh, and save-save-save! Remember to save as you work, the more often, (usually) the better. With lengthy and complex documents, consider doing a Save As with a different filename before Word gets cranky. You’ll have several versions of the document, but that’s better than losing even a few minutes’, much less several hours’, worth of work. The client only has to see the final version, and you can ditch the interim versions once you’ve turned it in.

The Physical

The reality is that computers are not infallible. Even the most-respected brands can develop problems, and my experience — as well as what I’ve observed among colleagues — is that they will break down when we have the fewest resources in terms of money, time, contacts, and material to deal with a crisis. In budgeting to launch or maintain a freelance business, the ideal is to save, set aside, or maintain enough funds and credit so you can have at least two computers with the same software on them, just in case one of them goes south or you can’t use one of them. If you have more than one computer, you can send current files to yourself so they’re accessible on both or all machines, and you can work on them no matter which machine is handy or which one goes rogue and stops working.

I have an iMac desktop computer and a MacBook Air laptop, with the same software programs on each, so I can switch between them as needed. I also have an iPad that my brothers gave me a few years ago that I can use for e-mail and some rudimentary other programs in a pinch. I even have an old MacBook Pro that doesn’t hold a charge on its own but still works when plugged in, just in case all of the other three give up the ghost at the same time. Not that I’m a pessimist, but you never know.

I’ve usually maintained two current computers because of needing to work in different locations, either within my apartment or on the road versus at home, but the old iMac conked out recently, making the laptop even more essential to keeping my work going than usual. I was lucky enough to have funds in hand to replace it right away, but if I couldn’t have done so, I could still get my work done and meet those deadlines.

The Collegial

There’s yet one other option to develop and maintain: offsite ways to work through colleagues. In case your electricity goes out, for instance, or something other event makes it difficult or impossible to work at home for a while, have alternatives already in place.

That can mean knowing where the nearest public library is with computers you can use, a cyber café, co-working spaces, etc. It also can mean having friends who might lend you a computer or let you come over and camp out at their place to get the urgent work done.

It also can be a lifesaver to belong to a local computer users’ group. Once you’re active in one, you can usually count on other members to help with troubleshooting, equipment loans, repairs at less than what retail vendors might charge, and similar hand-holding in a crisis.

If you’ve had a software or equipment crash in mid-project, how did you handle it?

Ruth E. Thaler-Carter (www.writerruth.com) is the editor-in-chief of An American Editor and an award-winning provider of editorial and publishing services for publications, independent authors, publishers, and companies worldwide. She also hosts the annual Communication Central “Be a Better Freelancer”® conference for colleagues. She can be contacted at Ruth.Thaler-Carter@AnAmericanEditor.com or Ruth@writerruth.com.

October 16, 2017

Lyonizing Word: Workflow for Writing

by Jack Lyon

I do a lot of writing, and over the years I’ve investigated many a tool that’s supposed to help with that process. The most prominent of these, of course, is the bloated but powerful Microsoft Word. With my various add-ins at the Editorium, it can be a terrific editing tool. But for writing, something else is needed. Why? Because (as with most word processors) writing in Word is like scribbling on a scroll. Access to text is sequential rather than random (as I explained in my essay, “Changing Formats: From Scroll to Codex to eBooks”, although if you’ve used Word’s built-in heading styles, it’s possible to jump to those headings using the navigation window.

Rather than scrolling (or jumping) around a long, long document, I prefer to write in bits and pieces and then combine selected bits and pieces into a single document ready for editing. It’s possible to do this (kind of) in Scrivener using its “corkboard” feature (on both Mac and PC). Unfortunately, like Word, Scrivener strikes me as clunky, uncooperative, and overly complex.

Notebox Disorganizer

I’ve tried nearly every writing program out there, and the best solution I’ve found is the idiosyncratic and free Notebox Disorganizer from the Squirrel Technologist. (Sorry, Windows only — but please keep reading, as the other tools I’ll be discussing here work on Macintosh or Linux as well as Windows, and they’re well worth having.)

Notebox Disorganizer is a sort of spreadsheet for writers. It looks like this:

Notebook Disorganizer

The top part of the screen consists of boxes divided among rows and columns. Each box represents a separate document (although all of the documents are in the same file). We can move the cursor to the box we want to use and press ENTER. The cursor jumps to the document at the bottom, and we’re ready to write. To return to the boxes, we hit the ESCAPE key.

With Notebox Disorganizer, we can see the entire structure of our book laid out in a grid. Here, the book is broken up into parts that include the various chapters, but we could just as easily have each column be a chapter, and the boxes in that column be scenes. For nonfiction, each column could be a chapter, and the boxes could be sections of the chapter.

We can move boxes and columns around as needed. If we realize that scene 4 in chapter 2 should really be in chapter 8, we can cut the box and then paste it where it belongs. If we see that scene 4 should actually be scene 5, we can move it down. The program offers lots of flexibility. If you’d like to see the Notebox Disorganizer file in which I wrote this article, you can download it from the Editorium’s website.

(Note: The source code for Notebox Disorganizer is in the public domain and can be downloaded from the Squirrel Technologist website. So if you’re interested in customizing the program or incorporating its ideas into something else, the developer, Forrest Leeson, encourages you to do so.)

Markdown Syntax

Out of the box, Notebox Disorganizer uses Rich Text Format (.rtf) which means we can apply various fonts in various sizes and colors. Unfortunately, that encourages us to apply various fonts in various sizes and colors, when what is really needed is a proper document structure: headings need to be identified as headings, block quotes as block quotes, and so on. Directly applied formatting, no matter how beautiful, won’t supply that. To make that happen (and to keep writing rather than fussing with formatting), we can do two things:

  1. Change Notebox Disorganizer’s preferences (under Tools > Set Preferences > Misc > Forbid Formatted Text) so that it uses plain text only — no formatting allowed.
  2. Use Markdown syntax to specify (rather than apply) formatting — for example, use *asterisks* to indicate italic. Heading levels are specified with cross-hatches: # Heading 1, ## Heading 2, ### Heading 3, and so on. A complete reference for Markdown syntax (which is intuitive, human readable, and platform and program agnostic) is available as a downloadable PDF or online from GitHub.

Making a Manuscript

After we’ve written the various sections that make up chapters, it’s time to combine the text in all those boxes into a single document. To do that, we add boxes to the program’s “outbox” by selecting them and then pressing the spacebar. The result looks like this:

Outbox

If there are certain boxes we don’t want to include (research notes, for example), we just don’t include them in the outbox. After we’ve finished with our selection, we click File > Export the Outbox and give the document a name. Under “Files of type,” we select “Text.” Then we click OK, and the text is exported as a single text file, with Markup codes intact.

Turning Markdown into Formatting

Now that our document is finished, we need to turn it into a Word document. Why? Because that’s what publishers seem to want, unfortunately. But because it’s properly structured and marked up, we can just as easily turn it into a web page, a PDF, or just about anything else using the marvelous and (again) free Pandoc. (Pandoc works on Mac, Windows, or Linux.)

Pandoc is a tool that every writer and editor should have, as it can turn almost any document format into almost any other document format, which is something you might need to do sometime. For that reason, I’m going to ask you to try an experiment with me. It’s not hard, and I think you’ll like the results. Do this, in this order:

  1. Download and install Pandoc.
  2. Download and install Typora. (Typora, too, works on Mac, Windows, or Linux. Click the little arrow at the bottom of the home page; then click Download on the upper right.) Typora is an editing and rendering program for Markdown.

Have you finished installing? Great, then download from the Editorium website the Markdown document I created after writing this article. Put it on your desktop and then double-click it to open it in Typora.

Beautiful, no? Nice formatting and proper document structure. Just for fun, try some of the alternative CSS themes (click Theme) — or open the file in a plain old text editor to see the Markdown codes.

You can actually use Typora on its own to write just about anything (note the document outline on the left). As soon as you type something (using Markdown syntax), Typora renders it into an appropriate format. But we need a Word document, right? Well, one of the beautiful things about Typora is that it works automatically with Pandoc, so we can easily export our document as a Word file. To see this in action, click File > Export > Word (.docx). Now open the Word file (same folder and name as your Markdown document) and marvel at the result — a nicely formatted and structured document that any editor would be pleased to work on and any designer would be happy to import into InDesign. Please take a moment to contemplate how revolutionary that actually is.

Authors and Styles and Fonts, Oh My!

Now, if we could just get authors to write using Markdown, what a wonderful world it would be! Here’s why:

As you’ve seen, editors can easily convert a Markdown document into a Word document for editing, with all of Word’s tools at their disposal. The Markdown codes will be appropriately converted into Microsoft Word paragraph styles, with no extraneous formatting or messed-up footnotes to be cleaned up. Wouldn’t that be nice!

But what about authors? Why should they work in Markdown when they could just as easily work in Word? The reasons are many:

  1. They can’t just as easily work in Word. In fact, most authors have no clue about how to properly do so. Word makes it easy for authors to mess up a document almost beyond belief, with inconsistent and meaningless formatting, document corruption, fouled-up footnotes, incorrect AutoCorrect “corrections,” and on and on and on. Editors are left to clean up all that stuff.
  2. Microsoft Word is expensive — $149.99 for Office Home & Student 2016 (but doesn’t include newer versions as they’re released); if you go with Office 365 Personal (which does include new versions), you’re looking at $69 per year; for Office 365 Home, $99 per year. And those years add up.
  3. Markdown is intuitive — easy to learn, read, and use.
  4. Authors can create or read Markdown documents in any text editor or word processor (even Word) on any platform — Mac, Windows, Linux, Android, iPhone, whatever, without problems of compatibility.
  5. Markdown documents can easily be converted into all kinds of properly structured and formatted documents, including Word, XML, HTML, LaTeX, and PDF — true single-source publishing.
  6. Markdown documents will be readable and usable as long as text files are readable and usable — which is to say, forever.
  7. As Markdown documents are nothing but text, they’re small, taking up very little room on a hard drive or thumb drive, and they’re easy to send by email. In fact, you can use Markdown to write email.
  8. Perhaps most important, Markdown allows authors to simply write, without worrying about formatting and other complexities, thus increasing their productivity — which is something that benefits everyone.
  9. If you can persuade your authors to write with Markdown, the benefits should be great for all concerned. Well, for all except Microsoft:

Imagine there’s no Redmond;
It’s easy if you try.
No styles or wonky footnotes—
Something easy on the eye.
Imagine all the people
Writing stuff in peace! (No “helpful” automatic formatting, AutoCorrect, etc.)
You may say I’m a dreamer,
But I’m not the only one. (There are lots of Markdown editing and rendering programs out there.)
Just try to write with Markdown,
And you’ll see it can be done!

(Apologies to John Lennon.)

Jack Lyon (editor@editorium.com) owns and operates the Editorium, which provides macros and information to help editors and publishers do mundane tasks quickly and efficiently. He is the author of Microsoft Word for Publishing Professionals, Wildcard Cookbook for Microsoft Word, and of Macro Cookbook for Microsoft Word. Both books will help you learn more about macros and how to use them.

October 9, 2017

Thinking Fiction: The Novel-Editing Roadmap IV

by Carolyn Haley

In Thinking Fiction: The Novel-Editing Roadmap III, I described my approach to formatting client manuscripts (Stage 2 of a four-stage workflow). As in preflight (Stage 1), formatting gives me a preview of content while attending to technical preparation of the file, so when I finally settle down to edit (Stage 3), I can give content full attention.

Preflight is described in The Novel-Editing Roadmap I and II; formatting is described in The Novel-Editing Roadmap III.

Stage 3: Editing

Part of my rationale for not prereading a manuscript is to be able to see it as a regular reader would: start on page one and read to the end. I have a hint of what’s to come from preflight and formatting, just as a reader of the published book might have a hint from jacket copy and reviews. Beyond that, the novel is as unknown to me as it is to them.

My editing modus operandi is to read until I stumble. Depending on the manuscript, my stumbling may occur often or intermittently; and depending on the scope of work, I’ll emend, query, or ignore the stumble once I’ve identified its cause.

A stumble can be anything. Because different readers perceive the same book differently (i.e., reader subjectivity), it’s impossible for an editor to anticipate every conceivable stumbling point. Consequently, I frame my expectations according to genre conventions and commonly held standards of craft (writing technique and storytelling), and respond to what breaks my attention.

Where start-to-finish reading differs between me and the pleasure reader is that I stop and act at any stumble, whereas the reader reacts to stumbles by sliding past them or abandoning the book if there are too many of them. My job is to keep the reader attached to the story by removing stumbling points.

The first few chapters always go slowly, for that’s when characters are introduced, the plot and conflict(s) are established, and the writer’s skill or lack thereof becomes evident. It’s also when I construct the primary elements of the style sheet and decide upon its best layout. After that, things proceed more steadily and smoothly.

Simple corrections, such as spelling, punctuation, and minor deletions and transitions, can be popped in as I go. Stumbles that require more than a few seconds to address get highlighted in yellow. Some of them might be explained later in the story, so there is no point spending time on them prematurely. If a stumble is not explained by the end, I’ll have to do a bit of research, or give further thought to recasting or querying. I make these decisions in a dedicated pass after completing the main edit.

The need to highlight occurs so often that I created a macro to reduce multiple menu steps into a two-finger keyboard command that’s easy for me to remember. For yellow highlighting, I use the command CTRL+y, and to insert a comment balloon, I use CTRL+F11. My comments range from simple queries, such as selecting a word and suggesting an alternative with a question mark (e.g., in a description of a sword with an ornate handle, the query would be hilt?), to complex descriptions of a story problem and suggesting solutions. Other queries are just requests for clarification of ambiguous phrasings or actions.

I also use some of Word’s built-in keyboard shortcuts, such as ALT+F6 to jump between open Word documents (e.g., the manuscript and style sheet), and ALT+Tab to move between applications (e.g., between Word, email, reference websites, and a search engine). This saves a lot of mouse clicking.

One of the most time-saving macros I’ve found is one of the hundreds provided in Paul Beverley’s macro collection, Computer Tools for Editors. I overlooked it until Louise Harnby wrote about it in “How to never forget you’ve switched off Track Changes!” in her Proofreader’s Parlour blog. Once the macro has been installed, it places a symbol on Word’s toolbar, which upon clicking changes screen color to signal that Track Changes is OFF. This alert has saved me hours from having to backpedal and reedit after getting crossed up with Track Changes’ active/inactive status. The alert plus two single-key commands I recorded for showing and hiding tracking (F10 to show, F12 to hide), put an end to Track Changes fumbles.

Another big time-saver came from purchasing access to Merriam-Webster’s online unabridged dictionary. I used to check spellings in my paper copy of Merriam-Webster’s Collegiate Dictionary, 11th ed., until I realized how rapidly seconds were adding up to minutes and hours. I recovered my cost for the online version in the first book I edited afterward. I’ve not yet made the paper-to-online switch with my primary style guide, Chicago Manual of Style, because in fiction adherence to style is more flexible than in nonfiction, and I use CMS much less often than the dictionary. Nevertheless, I gained efficiency through an online/hardcopy combination. I’ve always found the CMS index to be confusing, and therefore time consuming, so I was prone to not consulting the reference when I should. I’m also frugal, so I didn’t want to spend for a resource I wasn’t going to heavily employ. Now I use the online CMS site as an index (no charge) by searching for a topic. That usually brings up the relevant chapter number and section, leading straight to the information I want in the book.

Second pass

After completing the main edit, I review everything I highlighted and address whatever the highlights flagged. That may require rephrasing clumsy wording, or investigating a questionable fact, or composing a technical explanation about a hitch in scene logistics and suggesting solutions. At first I searched for each highlight by scrolling; then I tried opening the Find/Replace window and searching for Highlight. That required a tiresome number of menu steps, so I recorded a macro for keyboard commands that advance to the next highlighted text and remove its highlighting. The pair of close-together key sequences (CTRL+Shift+| for find highlight and ALT+\ for unhighlight) lets me use my nonmouse hand to rapidly jump to and clear highlighting. (This combo is also useful during preflight when reviewing the many highlights inserted by Never Spell Word.) When I want to mass-clear highlighting or catch any highlight I failed to remove manually, I run EditTools’ Remove All Highlighting macro. Although this tool can remove particular highlight colors on demand, I don’t differentiate colors during my process so have not employed that option.

Next I review my comments and queries, to make sure they are courteous and clear. This, too, I previously did by scrolling, but now I use EditTools’ Comment Editor. This tool puts all comments in one window and lets you jump to whichever one you want with a click.

Last, I attend to miscellaneous. Throughout the main edit I jot notes about items I don’t highlight or query in the manuscript because they might not fall within scope of work. Usually they involve the writer’s technique. For instance, if the manuscript was loaded with fuzzy phrasing, like he made his way through the crowd (vs. he wove or shoved through the crowd); or weak phrasing, like he was running (vs. he ran) or he started to run (vs. he ran); or the author has a pet word or phrase that’s been overused (one of my memoir clients hopped on his bike about two hundred times, when he could have gotten on, jumped on, or mounted the bike occasionally), I might run searches for the phrases in question and reconsider them for editing or querying.

Once every note is crossed off my list, I tidy up any lingering mechanical and consistency details.

Stage 4: Cleanup

I start cleanup by making another copy of the file, then work down a checklist.

Quotation marks come first, owing to the prevalence of dialogue in fiction and the myriad typos it can contain. Using a series of search strings I haven’t bundled into a macro yet, I ferret out missing punctuation inside quotes (Find: ^$”) and missing periods at paragraph ends (Find: ^$^p), then switch to wildcard searches for incorrect punctuation between the quoted matter and the speaker, such as, “I’ll go to the store.” she said (Find: .^0148 ([a-z]), with variations on caps and period/comma). I also make sure all quotation marks and apostrophes are “curly” typographer style rather than straight (Find: ^0034 for ” and ^0039 for ‘).

Finally, I run Paul Beverley’s MatchDoubleQuotes macro to catch any quotation mark pairs that are incomplete. I use another Paul Beverley macro to find duplicate phrases, since Word’s spellcheck will only find duplicate single words (e.g., the the). The Duplicate Phrase macro finds two-word repeats and three-word repeats, including a variant that highlights them, to catch such errors as she went to went to the store. However, it can’t find illogical sequences resulting from clumsy revisions, like he the will. For those, I must reread the document and hope my eye will catch them second time around.

It’s been suggested that I save the illogical phrases as I come across them to an F&R Master dataset in EditTools, which is a good idea that I plan to try. No such phrases have popped up since I received the suggestion, so I can’t yet testify to the utility of the idea. In the meantime, I’ve tried different settings in Word’s grammar checker, and investigated other grammar checkers on the market, but not found anything to help catch my worst and most frequent editing error (he the will and its ilk). I therefore never promise a client a perfect job.

Before my own proofreading pass, I run PerfectIt to find consistency errors in spelling, hyphenation, abbreviation, and capitalization, followed by Word’s spellchecker to catch the last typos and dropped spacing between words or sentences. When that’s done, I set up for proofreading: change the font (and eyeglasses), move to a different computer and chair, hide the tracked changes and comments from showing onscreen, and read the book from start to finish. Leftover bloopers and questions reveal themselves during this phase.

Last, I play it safe by manually checking for little mistakes I might have introduced during the edit, such as extra spaces between words or before punctuation — but I don’t rerun File Cleaner, having done so in preflight. At the end of the edit I’m afraid to do anything involving a global replace as I will not see the whole manuscript again and deeply fear an ugly surprise when the author reviews it.

Closure

Before delivering the edited manuscript, I take an extra spin through the comments to make sure they meet the three p’s: polite, professional, and precise. That’s the final editing step. For delivery, I prepare two files: the first with all edits showing, to demonstrate that I’ve done my job and let the author accept or reject whatever they please; the second with all edits accepted and only comments showing. Most clients work with the second document because they are satisfied with the edits and want a clean version of the manuscript to enter their own revisions into.

Finally, I organize and pretty-up the style sheet and prepare a cover letter to the author (or project coordinator for a publisher job). With new clients or iffy payers, I create a PDF of the all-changes-showing file and send it with the bill. With proven clients, I just send the final Word files and the author sends back a check.

The job usually ends here because most of my jobs involve copyediting or line editing and the client moves on from there. Sometimes I get the book back for revision checking and commentary, and I always keep the door open to author questions. Many of them keep in touch regarding their progress. Better yet, they come back with their next project.

By the time I receive the author’s next project, I’ve learned another tool or trick and refined my procedure — although not always for the better. Learning is as much about figuring out what doesn’t work as what does. The route to finding out what editing process works best for oneself is to acquire the proven software tool packages — EditTools, Editor’s ToolKit Plus, PerfectIt, and Paul Beverley’s macro collection, Computer Tools for Editors — and start experimenting. Also, take classes, read how-to books and blogs, and participate in forums where colleagues discuss their methodology. It’s a dynamic process that never really ends and can be adjusted as one’s skill set matures.

Carolyn Haley, an award-winning novelist, lives and breathes novels. Although specializing in fiction, she edits across the publishing spectrum — fiction and nonfiction, corporate and indie — and is the author of two novels and a nonfiction book. She has been editing professionally since 1977, and has had her own editorial services company, DocuMania, since 2005. She can be reached at dcma@vermontel.com or through her websites, DocuMania and New Ways to See the World. Carolyn also blogs at Adventures in Zone 3 and reviews at New York Journal of Books.

September 18, 2017

Lyonizing Word: Corruption

by Jack Lyon

Alas, poor Yorick! I knew him, Horatio, a fellow of infinite jest, of most excellent fancy. He hath borne me on his back a thousand times, and now, how abhorred in my imagination it is! My gorge rises at it. . . . Now get you to my lady’s chamber and tell her, let her paint an inch thick, to this favor she must come. Make her laugh at that.

Hamlet, act 5, scene 1.

Corruption is never funny, especially when you’re on deadline and the Word document you’ve been editing starts doing not-so-funny things, such as:

  • Repeatedly renumbering pages.
  • Repeatedly rebreaking pages.
  • Showing incorrect layout and formatting.
  • Showing strange or unreadable characters.
  • Producing error messages.
  • Omitting text that should be there.
  • Displaying text that shouldn’t be there.
  • Hanging your computer.

All of these are symptoms of document corruption, which is most often caused by one or more of the following:

  • Tracked changes in documents moved from PC to Macintosh or vice versa.
  • Master documents.
  • Nested tables.
  • Automatic list numbering.
  • Automatically updated document styles.
  • Fields, especially cross-references.
  • Deleted note reference numbers (in the notes themselves, not in the main text).
  • Saving when resources are low.
  • A corrupt printer driver (Word often crashes when printing).
  • A corrupt document template, especially Normal.dotm.

Early word processors, such as WordPerfect, kept track of text and formatting as a clean, continuous string of characters and codes that looked like this:

WordPerfect Reveal Codes

When creating Word, Microsoft took a different approach, using numeric pointers to specify what was going on in a document. For example, characters 7 through 15 of paragraph 10 might be given the attribute of italic. (That’s not technically exact; I’m just trying to convey the general idea here.) The problem is, those pointers can — and sometimes do — get out of whack and end up pointing at the wrong thing. A typical Word document has thousands of these pointers, which are stored in paragraph breaks and section breaks. Pointers for the document as a whole are stored in its final paragraph break, and this is often where corruption occurs. The usual solution is to “maggie” the document (a process named for Margaret Secara from the TECHWR-L mailing list). Here’s how:

  1. Back up your document, so if something goes wrong, you’ll have something to go back to.
  2. Select all of the text in the document.
  3. Hold down SHIFT and press the left-arrow key to deselect the final paragraph mark.
  4. Copy the selected text.
  5. Create a new document.
  6. Paste the text into the new document.
  7. Use the new document rather than the old one.

That, however, may not be enough. If your document has section breaks, they too can hold corruption, which means you’ll need to maggie each section separately—selecting its text, deselecting the section break at the end, and copying and pasting the text into a new document, adding new section breaks as needed. If you have lots of sections, this will take lots of time.

A better solution might be to use a macro that will automatically maggie each section (including the final paragraph mark). Here is such a macro that I hope you’ll find useful when corruption strikes. Note that when using the macro, you should have open only one document — the one you want to maggie.

Sub AutoMaggie()

Dim s As Integer
Dim secType As Integer
Dim secCount As Integer
Dim myDoc As Document
Set myDoc = Documents(ActiveDocument.FullName)

Documents.Add DocumentType:=wdNewBlankDocument
Documents(myDoc).Activate

secCount = ActiveDocument.Sections.Count
For s = 1 To secCount - 1
    secType = ActiveDocument.Sections(s + 1).PageSetup.SectionStart
    ActiveDocument.Sections(s).Range.Select
    Selection.MoveEnd Unit:=wdCharacter, Count:=-1
    Selection.Copy
    ActiveWindow.Next.Activate
    Selection.Paste
    Selection.InsertBreak Type:=wdSectionBreakContinuous
    ActiveDocument.Sections(s + 1).PageSetup.SectionStart = secType
    myDoc.Activate
Next s

'Copy and paste final section
ActiveDocument.Sections(secCount).Range.Select
Selection.MoveEnd Unit:=wdCharacter, Count:=-1
Selection.Copy
ActiveWindow.Next.Activate
Selection.Paste

End Sub

Now let’s look at the macro to see how it works.

Sub AutoMaggie()

That first line simply gives your macro (technically a subroutine, or “Sub”) a name, which can be anything you like.

Dim s As Integer
Dim secType As Integer
Dim secCount As Integer
Dim myDoc As Document

Those four lines set up (dimension) four arbitrarily named variables, which simply hold information. (If you remember high school algebra, you were always trying to solve for the variable X.) Here, s, secType,  and secCount are defined as integers (whole numbers); myDoc is defined as a document.

Set myDoc = Documents(ActiveDocument.FullName)

That line assigns the name of your soon-to-be-maggied document to the variable myDoc.

Documents.Add DocumentType:=wdNewBlankDocument
Documents(myDoc).Activate

Those two lines create a new blank document and switch back to your original document (whose name is stored in myDoc).

secCount = ActiveDocument.Sections.Count

Here, we count the number of sections in the active document (our original) and assign the number to the variable secCount.

Now the fun starts:

For s = 1 To secCount - 1

That tells word to do whatever comes next a certain number of times, starting with the number 1 and ending with one less than the number of sections in our document. Why one less? You’ll see in a minute.

secType = ActiveDocument.Sections(s + 1).PageSetup.SectionStart

Here we get the type (continuous, next, odd, or even) of the next section (“s + 1”) and store that information in the variable secType.

ActiveDocument.Sections(s).Range.Select
Selection.MoveEnd Unit:=wdCharacter, Count:=-1
Selection.Copy

In those three lines, we select the text of the section specified by s: If s is 1, we select the first section; if 2, the second section; and so on. After selecting the section, we move the cursor one character to left so that we’re not selecting the section break (which could hold corruption). Finally, we copy our selection.

ActiveWindow.Next.Activate
Selection.Paste

Here, we switch to our new, clean document and paste the text that we copied from the section in our original document.

Selection.InsertBreak Type:=wdSectionBreakContinuous
ActiveDocument.Sections(s + 1).PageSetup.SectionStart = secType

Next, we insert a continuous section break. Oddly, the first line alone won’t do what we need, even if we specify the Type using the variable secType. We must add the second line, which needs an existing section break in order to work. It turns that break into whatever type we stored earlier in the variable secType. (It took a lot of experimenting to pin down this wretched fact.) Again, we have to add 1 to the section number (“s + 1”) because we’re inserting the breaks after the section text.

myDoc.Activate

Here, we switch back to our original document.

Next s

This is the line that has been incrementing the s variable that we specified earlier in the line “For s = 1 To secCount – 1”.

ActiveDocument.Sections(secCount).Range.Select
Selection.MoveEnd Unit:=wdCharacter, Count:=-1
Selection.Copy
ActiveWindow.Next.Activate
Selection.Paste

We select the last section in our original document, move back one character, copy the text, move to our new document, and paste.

End Sub

Finally, we end the macro.

After running the macro, you’ll be left with your original document (unchanged) and a new, unnamed document that is identical to your original but without the corruption.

That’s it! There are ways to make this macro more elegant and efficient, but, to paraphrase Blaise Pascal, I would have written a shorter macro, but I did not have the time. Nevertheless, the macro works for me; the next time you encounter corruption, I hope it works for you.

________

How to Add a Macro to Word & to the QAT

Here’s how to put this macro (or any other) into Microsoft Word so it will be available when you need it:

  1. Copy the text of the macro, starting with the first “Sub” and ending with the last “Sub.”
  2. Click the “View” tab on Microsoft Word’s ribbon.
  3. Click the “Macros” button.
  4. Type a name for the macro in the “Macro name” box — probably the name used after the first “Sub.” For this macro, that’s “AutoMaggie.”
  5. Click the “Create” button.
  6. Delete the “Sub AutoMaggie” and “End Sub” lines that Word created in the macro window. The macro window should now be completely empty (unless you already have other macros in there).
  7. Paste the macro text at the current insertion point.
  8. Click “File,” then “Close and Return to Microsoft Word.”

To actually use the macro:

  1. Place your cursor at the beginning of the document.
  2. Click the “View” tab on Microsoft Word’s ribbon.
  3. Click the “Macros” button.
  4. Click the name of your macro to select it.
  5. Click the “Run” button. (If you wanted to delete the macro, you could press the “Delete” button instead.)

Here’s how to put the macro on Word’s QAT (Quick Access Toolbar):

  1. Locate the QAT (it’s probably on the top left of your screen either above or below Word’s Ribbon interface).
  2. Right-click the QAT.
  3. Click “Customize Quick Access Toolbar.”
  4. Under “Choose commands from:” click the dropdown list and select “Macros.”
  5. Find and select your macro in the list on the left.
  6. Click the “Add” button to add it to the QAT.
  7. Click the “OK” button to finish.

Jack Lyon (editor@editorium.com) owns and operates the Editorium, which provides macros and information to help editors and publishers do mundane tasks quickly and efficiently. He is the author of Microsoft Word for Publishing Professionals, Wildcard Cookbook for Microsoft Word, and of Macro Cookbook for Microsoft Word. Both books will help you learn more about macros and how to use them.

September 11, 2017

Thinking Fiction: The Novel-Editing Roadmap III

by Carolyn Haley

In Thinking Fiction: The Novel-Editing Roadmap I and Thinking Fiction: The Novel-Editing Roadmap II, I introduced the four stages of my editing process — preflight, formatting, editing, and cleanup — then discussed the first stage: preflight. Preflight involves document setup for the job, then mechanical tidying-up of errors and inconsistencies using editing software tools, so I can focus on content while reading the manuscript. The next stage in my process, formatting, serves the same purpose but focuses on different aspects.

Stage 2: Formatting

Aside from story content, formatting is the biggest variable among the manuscripts I edit. Whereas publisher manuscripts usually come groomed and styled so I don’t have to do anything except copyedit, indie-author manuscripts can arrive in any condition, and I usually have to clean them up in some way beyond editing the words.

Some authors have studied submission requirements to agents or publishers, and send their manuscripts to me in “industry standard” format of one-inch margins all around, double spacing, and conventional font such as Times New Roman 12 (with a few still using the now old-fashioned monospace font, Courier). Other authors present their work with a gaudy cover page, autogenerated table of contents, headers and footers, and fancy typefaces, with the text in single space or something — anything! — else. Many older authors know how to type and spell but have no word processing skills, so they use manual tabs or spaces for paragraph indents and insert extra returns for chapter breaks; other authors, lacking knowledge of conventional publishing practices, use all caps and/or bolding and/or underlining for chapter titles and emphasis.

These flourishes must be removed from the manuscript before it’s published or, in many cases, before it’s submitted to an agent or acquiring editor. Consequently, I offer preproduction formatting as one of my editorial services. I spent years as a typesetter and enjoy that kind of work. As well, it’s more efficient for me to format a manuscript than to teach someone to do it or wait while my client has someone else do it, as would be the case if I insisted on specific formatting before accepting the job. I am frequently the last (or only) person to handle a file before my client submits it anywhere, so I like to deliver it ready for its fate. In situations where the author plans to pay someone for formatting, the author gets a better deal having it done as part of editing — and I get a better paycheck for the extra work.

Where I remain inflexible is with file format, meaning, which software created the document. A few maddening, time-wasting, unprofitable experiences with Pages and OpenOffice files moved me to only accept files created in Microsoft Word. PC or Mac doesn’t matter, release version doesn’t matter, but the file must be native to Word — this is nonnegotiable! This policy is not only to avoid problems for myself, but also for the production people after me, whose layout programs are designed to play nicely with Word. The day will come when I’ll have to change my policy, but until it becomes obvious that I must adapt to demand or lose work, I’m holding firm on this requirement.

Formatting as a supplement to preflight

Formatting the manuscript myself has an additional benefit. As mentioned in Thinking Fiction: The Novel-Editing Roadmap I, I have a blind spot to work around. Because of the way my memory functions, I can’t preread a manuscript without dulling my eye to editing it. Formatting provides a passive preview that gives me a sense of the book and lets me spot oddball elements not picked up during preflight, while keeping the story fresh to discover during editing.

I don’t use any editing software tools for formatting beyond Word’s built-in Styles features and menu. They serve for my approach, so I don’t feel compelled to change. I like to crawl through the whole document with nonprinting characters and coding showing, with Word’s Styles pane open and set to show what styles are used in the document. I may do this in Print Format view or Draft view; which view alters with circumstance and mood.

During the crawl, I look for and fix anything that wasn’t caught during preflight. There’s almost always something aberrant, and I can’t predict what it might be. The most common irregularities pertain to numbers. Examples include time indicated in different ways (e.g., 2:00 PM, 4 p.m., seven o’clock), variations in measurement (e.g., five-foot six, 5’6”, five-feet-six; or 20 miles vs. twenty miles), different styling of years (e.g., the sixties, the 60s, the 1960’s, the Sixties) or firearm terms (.45, 45-caliber, a 45; or 9mm, 9-millimeter, nine millimeter). In each case I need to choose which style to use and apply it consistently through the manuscript. Sometimes it’s a matter of correctness (e.g., changing the 60s to the ʼ60s); most times it’s a matter of whose preference to follow (mine, Chicago Manual of Style’s, or the author’s). Whatever I decide goes onto my style sheet, which contains a section specifying which types of numbers are spelled out and which are expressed in numerals, including examples of each. Attending to these types of consistency elements during formatting reduces the number of details I must notice and address during editing.

Styling

My dual aims in formatting are to make the manuscript easy for me to read and navigate, and to make it clean and consistent for future production. If the document arrives neatly put together, all I do is style the chapter heads with Heading 1, one of Word’s default styles. The Heading 1, 2, 3 (etc.) styles appear in Word’s navigation pane, enabling me to jump back and forth between chapters with a click instead of scrolling or searching.

I also make sure that chapter breaks are formed by a “hard” page break (either manually by CTRL+Enter or with “Page break before” selected when establishing the Heading 1 style), rather than any kind of section break or insertion of returns. This is to help whoever follows me in the chain. The production person, for instance, may need to do a global find/replace for some styling or layout purpose I’m not privy to. Consistency makes that task much easier, so I ensure that there’s only one return between the last paragraph of every chapter and the page break for the next, and no returns preceding the next chapter number/title.

For messier manuscripts, I’ll get in deeper, if scope of work allows. Many times I style the body text and chapter heads using Word’s defaults: Normal for text, and Heading 1 (2, 3, etc.) for chapter number/title/subtitle. This combination is a reasonably safe, generic setup for when I don’t know the book’s ultimate configuration. I modify the fonts, line spacing, and indents of these styles to suit the job, but might change them during editing for easier viewing onscreen. For example, the job may need to be delivered in Times New Roman, but I find that font hard to read, especially punctuation. My eye is more comfortable with a sans serif font, such as Calibri. By using Word’s Styles for text and headings, I can change fonts simply and swiftly, then enlarge them onscreen as needed.

With the basics done, I focus on italics, which are heavily used in fiction for emphasis and many forms of silent communication, as well as for media titles and ship names, noises, and foreign or alien words. To ensure that italics survive any font changes or cross-platform file moves during the manuscript’s progress from creation to publishing, they need to be set in a character style rather than a paragraph style. Although italics set with Word’s default tools (taskbar icon, menu commands, or keyboard combo [CTRL+i]) hold up well during most manuscript manipulations, they sometimes come undone for no apparent reason, and it’s a miserable waste of time to restore them.

I avoid this random possibility by one of two means. If the manuscript comes in clean, then I just create a character style for italics and globally find Word’s default italics and replace them with the character-style italics. Using a character style makes the italics always identifiable because even if the text doesn’t appear italic, the text that is supposed to be italic can be located by finding the text to which the character style is applied. If the manuscript is really messy and I must change something in Normal or any different style(s) the author used, I first globally find/replace the default italics to put them into color and then do whatever else I have to do (sometimes clearing all styles and restoring just the ones needed). Finally, I replace the colored italics with the character-style ones. For technical reasons I don’t understand, font color survives heavy text manipulation, whereas the default italics setting sometimes does not. By using one of these methods, I don’t lose the italicization even if I have a corrupted file to salvage or foul things up with my own mistakes.

Upon completion of formatting, I create a new copy of the manuscript and plunge in to discover its story.

Carolyn Haley, an award-winning novelist, lives and breathes novels. Although specializing in fiction, she edits across the publishing spectrum — fiction and nonfiction, corporate and indie — and is the author of two novels and a nonfiction book. She has been editing professionally since 1977, and has had her own editorial services company, DocuMania, since 2005. She can be reached at dcma@vermontel.com or through her websites, DocuMania and New Ways to See the World. Carolyn also blogs at Adventures in Zone 3 and reviews at New York Journal of Books.

June 5, 2017

Lyonizing Word: You Have Options

by Jack Lyon

Microsoft Word is packed with options, which is both a blessing and a curse. It’s great to have them, but it’s hard to know how to set them to best meet your needs. To see the options available, click File > Options. Then click the kind of option you want to see (General, Display, Proofing, and so on), using the menu bar on the left. You’ll see the associated options on the right.

“But how,” you ask, “do I know what all these options actually do?”

Detailed explanations are available from Microsoft’s website as follows:

Options Article Title
General Word Options (General)
Display Word Options (Display)
Proofing Select grammar and writing style options in Office 2016

Select grammar and writing style options in Office 2013 and earlier

Save Word Options (Save)
Language Customize language features in Word 2013 and later
Advanced Word Options (Advanced)

Unfortunately, Microsoft’s explanations of the Advanced options are not detailed. For a few of those options, you can get additional information by resting your cursor over the little “i” icon to the right (you can enlarge an image in this essay by double-clicking on the image):

Information icon

The function of many of those options is self-evident, which may be why Microsoft doesn’t provide much explanation. (Actually the Editor Options [Advanced] page at the Microsoft website does give details for many of the options, even though it’s meant for use with Outlook 2007.) Some of the options definitely need more explanation, which I’ll try to provide here for the ones that look like they might be of interest to editors. (Some that look like they might be actually aren’t.)

Obscure Options Explained

Editing options

Use smart paragraph selection

All this means is that when you select a paragraph, Word makes sure that the final paragraph mark is also selected. That’s useful if you want to retain the paragraph’s formatting and settings, but not if all you’re after is the text itself, so you’ll need to decide which option is best for you.

Use smart cursoring

If you use the mouse and scroll bar to move to a different page in your document and then press one of the arrow keys, this feature places your cursor on the page to which you’ve scrolled. I see little use for this feature and keep it turned off. But now you know what it does.

Prompt to update styles

If you directly format some text, this option tells Word to ask you if you’d like to update the text’s underlying style to match the formatting you just applied. This could be handy if you’re designing a document, but not if you’re editing one.

Keep track of formatting

This option keeps track of your formatting as you work. It’s useful if you’re cleaning up a document with inconsistent formatting (which means most manuscripts), because you can then right-click some text and then click “Select Text with Similar Formatting.” At that point, you can change or clear the formatting or apply a style to all of the chunks of text that are selected. You can also display a list of the formatting used by clicking Options on the Style pane; then select the paragraph, font, and bullet and numbering formatting you want to track.

Mark formatting inconsistencies

This option is available only if the previous one has been selected. It tells Word to mark inconsistent formatting with a wavy blue line, which may give you some guidance about which text you should right-click and change, as described in the previous paragraph.

Enable click and type

This feature allows you to click anywhere on a blank (or otherwise) page and start typing at that point (if you’re in Print Layout or Web Layout view). For editors, this seems completely useless.

Default paragraph style

By default, Word uses Normal as the default paragraph style. If you’d like to use a different style, like Body Text, you can specify that with this option. If your document is headed for InDesign after editing, your typesetter might appreciate being able to use something more meaningful than “Normal.”

Show document content

Show picture placeholders

Have you ever received a manuscript that’s supposed to include graphic images, but when you open it, the images are replaced by empty boxes, like this?

Picture placeholder

What you’re seeing is a “picture placeholder,” which exists to keep Word from slowing down as it tries to display graphic images. This rather unintuitive feature should have been named something like “Hide graphic images to improve performance,” but I’m guessing someone at Microsoft didn’t like the implication that Word ever gets bogged down. You can stop chuckling now.

Even worse, if you edit in Draft mode, you won’t see an image or a placeholder; all you’ll see is what looks like an empty paragraph. If you delete it, you’re actually deleting the image, so watch out.

Show field codes instead of their values. Microsoft Word uses fields to generate things like indexes and tables of contents. If you activate the option to show field codes, you won’t see the index or table of contents; instead, you’ll see the field that generates it. For example, the field code for a table of contents looks like this:

{ TOC \o "1-3" \h \z \u }

The field code for an index looks like this:

{ INDEX \c "2" \z "1033" }

Each of those codes includes “switches” that change the display of the generated text. Information about table of contents switches can be found in the article “Field codes: TOC (Table of Contents) field” at Microsoft’s website. Information about the index switches is found in this article, “Field codes: Index field.”

Word uses field codes for lots of things. The article “List of field codes in Word” goes into greater detail.

Display

Style area pane width in Draft and Outline views

This is a very cool feature that I use all the time. In the little box to the right of this option, enter a value — two inches (2″), say. Then switch to Draft or Outline view. When you do, you’ll see the style area pane on the left of your document, with the name of the style that’s applied to each paragraph. No more guessing! If you want the ultimate experience editing in Word, try using this feature with the Cockpit in Editor’s ToolKit Plus 2014.

Style area pane

Save

Prompt before saving Normal template

The Normal template holds Word’s styles, macros, and lots of other important stuff, so if you change any of that stuff, Word saves your changes in the template. This option allows you to choose whether or not Word does that automatically.

Hidden Options

Microsoft Word also includes some options that you can’t access through a menu, although they are accessible via macro, as discussed in the next section. Here are a few that might be useful to editors.

ContextualSpeller

The contextual speller identifies the structure of words and their location within a sentence to determine if spelling is correct. It can find errors that the standard spelling checker can’t. For example, if you type the words “superb owl” instead of “super bowl,” Word checks the context of the sentence and determines that the correct words are “super” and “bowl.” This looks like a fantastically useful feature; the problem is that it makes the change automatically as you type, so if you decide to use it, you’ll need to watch it carefully.

EnableMisusedWordsDictionary

This option looks for the following when checking for misused words during a grammar check: incorrect use of adjectives and adverbs, comparatives and superlatives, like as a conjunction, nor versus or, what versus which, who versus whom, units of measurement, conjunctions, prepositions, and pronouns.

EnableProofingToolsAdvertisement

This option tells Word to notify you when additional proofing tools are available for download.

Changing Options with a Macro

To use options like those requires a macro. For example, here’s a macro that will toggle ContextualSpeller:

Sub ToggleContextualSpeller()
   Options.ContextualSpeller = Not Options.ContextualSpeller
End Sub

Line 1 specifies the name of the macro (subroutine), which is ToggleContextualSpeller, although you could name it anything you like.

Line 2 gets the value of the ContextualSpeller option and changes it to the value that it currently is not. For example, if the ContextualSpeller option is set to True (that is, it’s active), the macro changes it to False. If the option is set to False, the macro changes it to True. Hey, it’s a toggle!

Line 3 ends the macro.

To use a different option in the macro, just change Options.ContextualSpeller to the option you want to use. For example, the following macro toggles the option for EnableMisusedWordsDictionary:

Sub ToggleEnableMisusedWordsDictionary()
   Options.EnableMisusedWordsDictionary = Not Options.Enable
       MisusedWordsDictionary
End Sub

You’ll find a complete list of Word’s options for use in macros at the Options Properties pages (for Office 2013 and newer) and Office 2010 of the Microsoft website.  If you find yourself changing a certain option a lot, you might create a toggle macro for it and then put that macro on a shortcut key for easy access. No more digging through menus!

How about you? Which options do you love? Which do you hate? I’d love to hear about the options that work best for you.

How to Add a Macro to Word & to the QAT

Here’s how to put this macro (or any other) into Microsoft Word so it will be available when you need it:

  1. Copy the text of the macro, starting with the first “Sub” and ending with the last “Sub.”
  2. Click the “View” tab on Microsoft Word’s ribbon.
  3. Click the “Macros” button.
  4. Type a name for the macro in the “Macro name” box — probably the name used after the first “Sub.”
  5. Click the “Create” button.
  6. Delete the “Sub [macro name]” and “End Sub” lines that Word created in the macro window. The macro window should now be completely empty (unless you already have other macros in there).
  7. Paste the macro text at the current insertion point.
  8. Click “File,” then “Close and Return to Microsoft Word.”

To actually use the macro:

  1. Place your cursor in your text.
  2. Click the “View” tab on Microsoft Word’s ribbon.
  3. Click the “Macros” button.
  4. Click the name of your macro to select it.
  5. Click the “Run” button. (If you wanted to delete the macro, you could press the “Delete” button instead.)

Here’s how to put the macro on Word’s QAT (Quick Access Toolbar):

  1. Locate the QAT (it’s probably on the top left of your screen either above or below Word’s Ribbon interface).
  2. Right-click the QAT.
  3. Click “Customize Quick Access Toolbar.”
  4. Under “Choose commands from:” click the dropdown list and select “Macros.”
  5. Find and select your macro in the list on the left.
  6. Click the “Add” button to add it to the QAT.
  7. Click the “OK” button to finish.

Jack Lyon (editor@editorium.com) owns and operates the Editorium, which provides macros and information to help editors and publishers do mundane tasks quickly and efficiently. He is the author of Microsoft Word for Publishing Professionals, Wildcard Cookbook for Microsoft Word, and of Macro Cookbook for Microsoft Word. Both books will help you learn more about macros and how to use them.

May 22, 2017

Thinking Fiction: The Novel-Editing Roadmap II

by Carolyn Haley

In Thinking Fiction: The Novel-Editing Roadmap I, introduced my four-stage work routine — preflight, formatting, editing, and cleanup — then began a discussion of the first stage in my editing process: preflight.

Preflight’s purpose is to prepare the manuscript for reading, minimizing the number of elements my eye needs to attend to during editing. For the mechanical tasks involved, I use the following software tools:

Editoriums FileCleaner

I use FileCleaner,  which is included in Editor’s Toolkit Plus 2014, for general cleanup of extra spaces and returns, curly versus straight quotation marks and apostrophes, and the like. Once I’ve selected which elements I want the tool to address, it takes seconds to do so and I can enter the file confident that I don’t have to watch for those things.

EditToolsDelete Unused Styles

I use the Delete Unused Styles macro to remove style clutter that comes with the file. In publisher manuscripts, somebody has already addressed styling, but indie-author manuscripts are usually messy and need some housekeeping. When the incoming manuscript is really messy, I address it during the next stage, formatting.

EditTools’ Change Style Language

I use the Change Style Language macro to ensure that Word’s styles in the incoming file are set for American English, so the correct dictionary is utilized by Word’s spelling checker. (This is particularly handy with one of my regular nonfiction jobs. The files I receive for that job are provided by multiple authors and often have different language settings. Most of my fiction work comes already set in American English, but there are just enough random exceptions to make this speedy preflight step worthwhile.)

EditTools’ Never Spell Word

I use Never Spell Word (NSW) to catch typos I’m prone to overlooking, such as form/from, let’s/lets, its/it’s, hang onto/hang on to, vice/vise, woman/women, lead/led, your/you’re, quiet/quite, and many others. I add words to the list every time I recognize a repeat mistake or one I haven’t made yet but easily could.

NSW highlights every occurrence of the designated words, which forces me to look at them and choose. I can either jump from highlight to highlight on a dedicated pass through the document, or pause during the edit to accept or fix each one as it appears. I’ve tried both approaches but discovered that I have a tendency to ignore the highlighted words when absorbed in story flow. Now I dedicate a pass to examining these highlights, usually scrolling rather than jumping so the context flows by. In this way I also pick up the gist of plot and characters, gaining a passive preread that helps me spot storycraft issues to pay extra attention to during editing, such as pacing, tense changes, or multiple viewpoints, while remaining ignorant of the details so I can discover them as a reader.

EditTools’ F&R Master

F&R Master lets me find and replace up to 10 terms and characters in one background run, instead of stopping to examine each and make a decision. With F&R Master I’m looking for irregularities I can safely change globally, and my list includes both words and punctuation.

For example, American indie authors intermittently use British spellings; I, however, always adhere to American spelling according to Merriam-Webster’s Collegiate Dictionary, 11th ed., unless directed otherwise before the job starts. Certain British spellings crop up so often among diverse indie novels that I’ve created an F&R Master dataset for them and run it on all manuscripts. This dataset comprises words ending in -wards (e.g., towards, backwards), which I replace with their s-free American spellings (toward, backward), and the color grey, which I change to gray. The changes get called out on my style sheet.

Other British spellings appear so randomly that I’ve not yet assembled a list for them to enter into a macro. They tend to be either very obvious in the text and I deal with them when I encounter them, or they get caught later by PerfectIt or Word’s spelling checker.

At present I’m building a list of terms that might be British, and/or American archaic, and/or American alternate spellings that keep popping up in fantasy novels — e.g., leapt, dreamt, burnt — along with words I have to look up repeatedly to confirm which is contemporary American spelling, such as knelt vs. kneeled, shined vs. shone, lit vs. lighted, façade vs. facade, décor vs. decor, and their ilk. Most likely I will put these under their own tab(s) in NSW after I’ve finished gathering and organizing them so they will be flagged in the document.

The punctuation changes I do globally using F&R Master are inserting the terminal comma before too, anyway, though, either, and as well (at least one of these occurs in every manuscript), and adjusting ellipses and dash styles (which vary among manuscripts and often within a manuscript). When the author does not have a preference, or I know the manuscript will be submitted to traditional print publishers, I use ellipses with spaces before, after, and between the points, and em dashes without spaces on either end. In cases where I know the author will be self-publishing an e-book, or the author specifies a preference, I use Word’s glyph for ellipses, and en or em dashes with spaces. I’ve set up and saved the F&R Master options not only to switch from one dash or ellipses style to the other in different combinations, but also to find occurrences in dialogue where the space after an ellipses point or dash needs to be dropped before a closing quotation mark, as occurs when a character’s speech trails off or gets interrupted.

Some find/replace combinations, such as possessives for words ending in s, remain best done manually, because there are enough exceptions to make it risky to fix them globally. I always do a quick search for s’ and ‘s to make sure Travis’ dog is Travis’s dog, the 1960’s are the 1960s, and so forth; also that the author hasn’t pluralized dogs by adding an apostrophe (dog’s). During both preflight and cleanup I also search for inverted apostrophes — open single quotes — in constructions like truncated dates (the ‘60s) and dialect (I hit ‘im ‘ere).

Paul Beverley’s ProperNounAlyse

I originally used ProperNounAlyse (PNA) to lay the foundation for a style sheet, but getting the results I wanted ended up requiring so much manual labor that I’ve reduced PNA’s role in my process to a single worth-its-weight-in-gold step.

PNA builds a list of everything it recognizes as a proper noun (e.g., Chicago, Henrietta), including name pairs (e.g., John Smith). The idea of it thrilled me, because my style sheet includes every person and place name in a manuscript, and saving time in gathering those would reduce style sheet labor by half.

Unfortunately, the macro takes “proper noun” too literally, forming a list of names and any capitalized word at the beginning of a sentence. That means if you want, for example, Achilles, Adams, and Adirondacks, you have to dig through entries like About, Absolutely, Actually, and And to find them. You also get first and last names individually along with the full name (e.g., John, Smith, John Smith). Any proper noun of more than two words is likewise captured in components but doesn’t produce the needed set, such as New York City (New, York, City, New York, and York City), which reduces the macro’s utility. The list it creates also includes extraneous words, colors, and characters (see discussion and image below).

If I were macro-savvy, I could probably customize the tool to eliminate the extras, or even write my own script. But I have the same trouble understanding macros as I have understanding algebra, which is why I buy editing software tool packages designed by pros, or use free macros that other people have figured out. In the case of PNA, I don’t know how to constrain it from giving so much I don’t need; but if I let it do its thing, then manually delete the extras and organize the rest, I end up with a comprehensive list of character and place names, plus some terms that may be unique to the manuscript (e.g., Wankel [engine], Luger [pistol]), miscellaneous terms that usually need to be changed and thus included on the style sheet (e.g., OK to okay, Alright to All right), and some that might be capitalized in one context but lowercase in another (e.g., Captain, Mother, Earth).

This is great — but it takes longer to build the list and then take it apart again to place each item in the right category on my style sheet than to build my style sheet the old way, item by item as I come across each in the manuscript. For the sake of time, I reverted to the old way, and now use PNA solely to find misspelled versions of a proper noun. I still generate the list, but instead of manipulating it for the style sheet, I just delete the highlighting so I can read what’s underneath, and scan for near duplicates. Then I fix any obvious errors before editing, and query the author where needed.

The macro proved its power when I had a novel featuring a character named Philippa, whose name appeared in the story spelled different ways. I found them all hard to read, because of the multiple i’s and l’s together. The PNA-generated list helped me isolate the three wrong spellings, but this is what I had to sort through to find them (double-click on image to enlarge it):

Sample results produced by ProperNounAlyse

Since one of the most embarrassing blunders a fiction editor can make is to misspell an author’s or character’s name, I’m glad to have a tool that helps avoid making such a blunder. Even the long and convoluted means of preventing the blunder, as described above for style sheet building, is worth the effort to ensure I never make that mistake.

It’s been suggested that I approach proper noun correctness from the opposite direction, trading ProperNounAlyse for Never Spell Word. In NSW I can enter the correct form of Philippa and have it highlighted in the manuscript, leaving any alternate versions obvious because they would be unhighlighted and thus easy to identify and correct. Or, enter every variant I can think of and have them all flagged for review. This is a good idea that doesn’t work for me, for reasons that may not seem sensible to others.

But, unlike others, I happen to be a super-duper high-speed typist who’s been word processing since before Word 1.0 was a gleam in Microsoft’s eye. It’s faster and easier for me to type multiple find/replaces for the wrong spellings I see on a list (especially since PNA tells me how many of each there are) than to open EditTools and NSW, set up a dataset I’ll probably never use again, figure out what color to highlight what, and then look through the manuscript for whatever I decided to flag, assuming I can remember what I decided by the time I’m done. In the case of Philippa, I can opt to just find “phil,” which will snag them all — worth considering, since PNA won’t catch one that starts with a lowercase p.

The point is, I have to type the same words whether I enter them in a dataset or a find/replace window, with the same risk of mistyping. My eyes and hands work better with conventional find/replace, so that’s the route I take.

It’s also been suggested that I perform the preflight tasks in a different, more strategic order, to maximize their efficacy. I need to contemplate that idea more, having never considered it. I established my routine from a checklist I compiled years ago from scribbled notes that amounted to “remember to do these things before starting.” As my routine stands, no step depends on any other; they are just things I want done before beginning the edit. I’ve been experimenting with different ways to cover them and am sure I’ll eventually find the ideal one. Right now, my steps accomplish what I desire: getting the manuscript workably clean so I can read without that nagging sensation of things lurking in the shadows behind me.

Taking care of as many consistency elements as possible before editing leaves any aberrations obvious enough to spot during the read. I like to keep some challenge to my eye so it doesn’t get jaded, just as I like to keep my fingers limber so I remain a super typist. I’ve arranged my preflight tasks so that postediting cleanup problems can be identified and decided upon per occurrence; I never do a background function if I’m done going through the manuscript. A background function invites nightmares like what happened to me once in a secretarial job. A careless moment with global find/replace led to “best” becoming “bestiality” in an environmental science report!

In those days, I was lowest person on the totem pole but on salary, in an environment where mistakes were forgiven unless they cost the company huge amounts of money. Now I’m a self-employed professional editor for whom any error has a price. Astute readers will note that some of my tool choices serve the peculiarities of my mind as well as accomplish specific editorial purposes. I must accommodate both in order to deliver an excellent job that clients are happy to pay for — every time.

This rationale applies during Stage 2: Formatting, which is discussed in Thinking Fiction: The Novel-Editing Roadmap III.

Carolyn Haley, an award-winning novelist, lives and breathes novels. Although specializing in fiction, she edits across the publishing spectrum — fiction and nonfiction, corporate and indie — and is the author of two novels and a nonfiction book. She has been editing professionally since 1977, and has had her own editorial services company, DocuMania, since 2005. She can be reached at dcma@vermontel.com or through her websites, DocuMania and New Ways to See the World. Carolyn also blogs at Adventures in Zone 3 and reviews at New York Journal of Books.

May 15, 2017

Thinking Fiction: The Novel-Editing Roadmap I

by Carolyn Haley

I was thunderstruck when I read An American Editor’s The Business of Editing: The AAE Copyediting Roadmap I and saw the project scale he works on: 1,500 to 20,000 manuscript pages in a single project. Yikes! Translating that into word count comes to 375,000 to 5 million words. Per book.

In contrast, the novels I work on run 50,000 to 200,000 words. Only once has a manuscript come close to the low end of AAE’s projects; the common range is 70,000 to 120,000 words.

Yet for projects great or small, we different types of editors use the same skills and tools to edit our clients’ manuscripts. I need only a fraction of the electronic tools available, not having to deal with references and figures and tables and all, but as time goes by I increasingly use electronic tools. Learning from other editors’ tips, tricks, and processes helps me become more efficient and meet my business goal of doing the best-quality job in the least amount of time with the least expenditure of labor.

Tools also help compensate for a flaw in my reading skills. I’ve learned that once I’ve read something, I stop seeing individual words and punctuation if I read the material again soon after the first time. This means that reading a manuscript completely through before editing it can be counterproductive, so it’s better for me to skip that step and use tools to prevent and later catch errors and omissions. Although I find and address most everything needed during the editing pass, that single read-through isn’t good enough for a professional edit.

My mental blind spot goes away if I wait a few weeks or months between readings. However, my clientele aren’t willing to wait that long. Therefore, I concentrate my attention on where it’s needed most — editing — and use different software tools before and after editing to catch mechanical details my eyes might miss. I’ve settled on a four-stage work routine comprising preflight, formatting, editing, and cleanup. I adjust the routine according to each job’s parameters, using the full process for indie-author clients and reducing or adapting it for publisher clients, who usually provide specific instructions for a job and do some of the steps before submitting the manuscript.

The Four Stages

I work primarily with indie novelists, most of whom are first-time authors still finding their way. For these authors I offer substantive editing, often called line editing or developmental editing by other editors. Sometimes I offer a variant I call a teaching or mentoring edit. Such jobs require the detail precision of copyediting as well as heavy commentary and queries pertaining to content. To handle the dual role effectively, I need to encounter the story as a reader would, not knowing who’s who and what happens next. So I first use tools to make the manuscript clean and consistent, then I read until I stumble, edit accordingly, and continue, using tools to sweep up behind me when done.

This process serves for copyediting finished manuscripts, too. When I copyedit for publishers, there’s usually one or more people in line after me to review the book. For indie authors, however, I’m often the last eyes on novel before it goes out into the world. I counsel all clients to hire a proofreader before they release their work, but in many cases they choose not to, whether it’s because they’ve exhausted their budget on editing or just believe that editing plus their own tinkering and reviewing are adequate. I can’t control what they do after I’ve delivered the manuscript, so during the edit I cover as much ground as possible within the parameters of the job, relying on software tools to cover my back.

Stage 1: Preflight

“Preflight” is a term I picked up during my catalogue production days. Coworkers in my department and personnel at the print house used “preflight” to cover tasks specific to the phase between finishing a layout in InDesign and preparing the file for the printer. There’s also a Preflight function on a pulldown menu in InDesign. The combination embedded the term in my mind.

Now as an editor I use “preflight” for the work I perform on a Microsoft Word manuscript. Preflight in this context means preparing the file for the author’s production, which might be submission to an editor, an agent, or a contest, or releasing it through self-publishing.

My preflight involves two substages: document setup for the job, such as creating folders, working files, style sheets, and notes to myself to guide the edit; then mechanical tidying up of errors and inconsistencies. For the mechanical tasks I use a combination of editing software tools to tackle the nitpickery that would otherwise slow down the edit and distract me from the content elements no computer can address.

When a manuscript arrives, the first thing I do is make a new copy of the file and rename it to indicate it’s an edited version. The author’s original is never touched again, and always available in the event of a document or computer crash. Because Word is unpredictably quirky, and heavy use of track changes sometimes provokes problems, I keep making new, numbered copies of the file over the course of the job.

In case there’s a problem with a file I have open during a work session, I also allow Word’s automatic backup feature to run. The autobackup file is instantly available and contains the most recent edits, should I need to recover anything. At the end of the day’s work session, I copy all files used that day to a secure site provided by my ISP. That way, if my computer dies or house burns down, I can access a current version of the job from any computer anywhere with Internet access. At intervals I back up my whole system onto a removable hard drive that is stored a fire safe. I live in a rural area and have no secure or convenient location outside the house to keep spare copies.

Next I set up the style sheet for the job. If the author has provided a list of character and place names, and/or special vocabulary, I plug those in under the relevant headings. If not, then I fill the style sheet during the edit.

With my work setup in place, I move on to electronic grooming of the file. Before I learned about software editing tools, I compiled a list of things to search for and fix one at a time. As I found ways to automate some of these tasks, I began consolidating them into batches, and experimenting with alternative approaches. Some tools I find easier to learn and apply than others, which influences my choices. Once I find a tool that solves a particular problem, I add it to my kit and use it until a better way presents itself.

The smart plan would be to allot time for a compare-and-contrast of all features of all the editing tool packages available, but I have not yet invested that time. (If anyone does, I’ll eagerly buy your book!) For now I adopt tools according to need and opportunity. Electronic editing tools are similar to Word in a general sense, in that you’re given multiple ways to perform certain functions: You can use a pulldown menu, a keyboard command, assign hotkeys, or run built-in or customized macros. There is no right way; rather, there are alternative ways to accomplish the same task, to be used according to personal preference and appropriateness to the project.

Thinking Fiction: The Novel-Editing Roadmap II will elaborate on the individual tools used in my preflight process.

Carolyn Haley, an award-winning novelist, lives and breathes novels. Although specializing in fiction, she edits across the publishing spectrum — fiction and nonfiction, corporate and indie — and is the author of two novels and a nonfiction book. She has been editing professionally since 1977, and has had her own editorial services company, DocuMania, since 2005. She can be reached at dcma@vermontel.com or through her websites, DocuMania and New Ways to See the World. Carolyn also blogs at Adventures in Zone 3 and reviews at New York Journal of Books.

Next Page »

Create a free website or blog at WordPress.com.