An American Editor

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.

March 13, 2017

The Business of Editing: The AAE Copyediting Roadmap IV

I ended The Business of Editing: The AAE Copyediting Roadmap III with a discussion of Style Inserter and with my repeating an earlier comment about how the smart editor creates the wheel once and reuses it instead of recreating the wheel with each new project. (I do understand that if you are doing one-off projects it is more difficult to create a reusable wheel, but there is a lot to editing that is repetitive across projects, even across one-off projects.)

One of the tools that I tried to use in my early years of editing was Word’s bookmarks. I would come across something that I thought I was likely to need to relook at as editing progressed and I would add a bookmark. The problem was — and remains — that Word’s bookmarking is primitive and not all that helpful. Of what value is a list of dozens of bookmarks that are nondescriptive, can’t be organized, and are so similar that it is hard to tell which is the one you need to go to? Before EditTools’ Bookmarks, I found using bookmarks to be very frustrating. (For previous essays on bookmarks, see The Business of Editing: Using & Managing Bookmarks and Bookmarking for Better Editing.)

EditTools’ Bookmarks are much more powerful and usable than the standard Word bookmarks. A detailed description of the Bookmarks macro is available at the wordsnSync website; here I want to address how I use bookmarks in editing.

My first use is to mark callouts of display items in the text. It is pretty easy to recall that Figure 1 was called out in the text when a manuscript has only one figure, but if a chapter is 50 pages long and has ten figures and six tables (and perhaps other display items), using bookmarks makes it easy to confirm that all are called out in the text. I insert a bookmark at the first instance of an in-text callout of a figure or table (see arrows [#1] in figure below) (you can make this image, as well as other images in this essay, larger by clicking on the image).

EditTools' Bookmarks dialog

EditTools’ Bookmarks dialog

When I get to the section of the manuscript that has, for example, the figure legends, I match the callout bookmark to the figure legend — that is, when I am styling/coding the legend to Figure 3, I make sure that there is a callout in the text for Figure 3 by looking at the above dialog to see if there is a bookmark fig 003. If there is, I use Move Bookmark (#2 in above figure) to move the bookmark from the callout to the legend. I do this is so that when I am editing the manuscript (rather than styling/coding), I can go from a figure’s callout to its legend (I insert a temporary pause bookmark at the callout so I can easily return to that spot), edit the legend and make sure the figure and the text are aligned (addressing the same issue), and then return to where I had paused editing. If there is no bookmark for the callout, I search the text for it; if it remains unfound, I query the author. Using bookmarks at this stage of the editing process gives me an easy way to check that all display items are called out in the text.

I also use bookmarks to mark something that I think I may need to check later. For example, if I see that references are going to be renumbered and that Table 1 includes reference callouts, I can insert a bookmark similar to that shown here (#3):

Descriptive bookmarks

Descriptive bookmarks

I keep the Bookmarks dialog open while I edit, so reminders like this are always visible and it is easy to add a bookmark. If a bookmark will be used repeatedly, like the “fig” bookmark, I create a custom button (#4) so that I can insert it with a single click, rather than repeatedly typing. (See Bookmarks at wordsnSync for more information about the custom buttons.)

There are two other things I do with bookmarks that help with editing. First, when I have edited a display item, such as a table, I rename the bookmark — I do not delete it because I may need to return to the item and this is an easy way to navigate. Renaming is easy and I have chosen a default naming convention as shown below (#5).

My default renaming convention

My default renaming convention

This renaming convention tells me that I have edited the display item, which I would not have done if the display was not called out in the text. It also leaves me a bookmark that I can use to navigate to the item in case there is a need to make a correction or add a comment that surfaces after additional editing. (You can create your own default naming convention or manually rename the bookmark using the Bookmark Rename dialog shown below. Using the Rename dialog you can create standardized renaming conventions and choose among them which is to be a default. You can choose a prefix or a suffix or both, as I did. The advantage to creating a default is that in three mouse clicks the renaming is done: one to select the bookmark to rename, one to click Rename, and one to click OK — quick and easy. Try renaming a bookmark using Word’s Bookmark function.)

Bookmark renaming dialog

Bookmark renaming dialog

Bookmarks that I no longer need, I delete. I like to keep lists that I need to check to a minimum. Thus, for example, once I have rechecked the reference numbering in Table 1, I will delete the bookmark that acts as both a reminder and a marker.

In my editing process, I use bookmarks extensively, especially as reminders to do certain tasks before I decide that the editing of the manuscript is complete — essentially a to-do list for the document I am editing. Unlike Word’s Bookmarks, EditTools’ Bookmarks lets me use plain-English descriptive bookmarks and organize them. Note that the bulleted “Recheck” bookmark appears as the first entry and the “x” (to signify edited) renamed bookmark has moved to the end of the list.

The next step in my editing path is to create my project-specific Never Spell Word dataset. When I first begin a project, this dataset may have only a few items in it, but it grows as the project progresses. Never Spell Word is the subject of The Business of Editing: The AAE Copyediting Roadmap V. Never Spell Word is a key item in my editing roadway.

Richard Adin, An American Editor

February 14, 2017

EditTools 8 Released

EditTools 8 is now available for download.

EditTools 8 is a free download for current registered owners of earlier versions. To download EditTools 8, click this link and click on the head: Download EditTools v8.0. EditTools is Windows only and does not work with 64-bit Word. EditTools 8 is works with any Windows version of Word — 2007 and newer. It does not work with Word 2003 or any MacOS versions of Word.

If you do not already have EditTools, EditTools 8 can be purchased for $69 directly from wordsnSync or as part of the Editor’s Toolkit Ultimate special package that includes the latest version of EditTools, PerfectIt, and Editor’s Toolkit Plus (for more information on this package, click this link).

Also available is a new starter dataset package for EditTools. The EditTools Datasets package contains multiple starter datasets, such as Drugs (5800+ entries), Organisms (10,600+ entries), and Journals (215,500+ PubMed/AMA style; 212,000+ AMA with Periods style; 120,000+ APA/Chicago style entries; 149,000+ ACS style; and 118,500 Harvard style). Also included are starter datasets for commonly misspelled words, “confusables” (e.g., complement and compliment), symbols, language, and more. The datasets give you a quick start toward creating your own comprehensive datasets. They are not comprehensive datasets themselves — they are starter datasets. The starter datasets are available for $29.

You can learn more about EditTools, including what is new in version 8, by clicking on the links found in the Read More box.

Richard Adin, An American Editor

November 21, 2016

EditTools: Duplicate References — A Preview

The current version of EditTools is nearly 1 year old. Over the past months, a lot of work has gone into improvements to existing functions and in creating new functions. Shortly, a new version of EditTools will be released (it will be a free upgrade for registered users).

New in the forthcoming version is the Find Duplicate References macro, which is listed as Duplicate Refs on the References menu as shown here:

Duplicate Refs on the References Menu

Duplicate Refs on the References Menu

The preliminaries

The macro works with both unnumbered and numbered reference lists (works better when the numbers are not autonumbers, but it does work with autonumbered lists). It also works with the reference list left in the manuscript with the text paragraphs and when the reference list has been moved temporarily to its own file (it works, like other reference-specific macros in EditTools, better when the references are moved to a separate, references-only file).

Like all macros, the Find Duplicate References macro is “dumb”; that is, it only finds identical references. The following image shows references 19 and 78 as submitted for editing. (For all images in this essay: For a larger, more readable image, right-click on the image and click “Open link in new tab.” This will open a larger version of the image in a new tab that can be kept open as you read the description of the image.)

Original References

Original References

As the image shows, although references 19 and 78 are identical references and are likely to appear identical to an editor, they will not appear identical to the Find Duplicate References macro. Items 1 and 2 show a slight difference in the author name (19: “Infant”, 78: “Infantile”). The journal names are different in that in 19 the abbreviated name is used (#3) whereas in 78 the name is spelled out (#4). Finally, as #5 and #6 show, there are a couple of differences in the cite information, namely, the order, the use of a hyphen or en-dash to indicate range, and the final page number.

Because any one of these differences would prevent the macro from pairing these references and marking them as potentially identical, it is important that the references go through a round of editing first. After editing, which for EditTools users should also include running the Journals macro, the references are likely to look like this:

The References After Editing

The References After Editing

If you compare the same items (1 and 2, 3 and 4, 5 and 6) in the above image, you will see that they now better match. (Ignore the inserted comments for now; they are discussed below.) One more step is required before the Find Duplicate References macro can be run — you need to accept all of the changes that were made. Remember that in Word, when changes are made with Tracking on, the material marked as deleted is not yet deleted; consequently, when the macro is run, the Tracked items will interfere (as will any comments, which also need to be deleted). The best method is to (1) save the tracked version, (2) accept all the changes, (3) use EditTools’ Comment Editor to delete any comments, and (4) save this clean version to run the Find Duplicate References macro.

After accepting all changes and deleting the comments, the entries for references 19 and 78 look like this:

The References After Changes Accepted

The References After Changes Accepted

Running the macro

When the Find Duplicate References macro is run, the following message box appears.

Find Duplicate References Message Box

Find Duplicate References Message Box

To run the macro, the macro has to be told where to begin and end its search. If the references are in a separate file from the rest of the manuscript, check the box indicating that the references are in a standalone document (#5) and click Run (#6). If the references are in a file with other material, use bookmarks to mark the beginning and ending of the list as instructed at the top of the message box (#1). To make it easier, the Bookmarks macro now has buttons to insert these bookmarks:

The dupBegin and dupEnd Bookmark Insert Buttons

The dupBegin and dupEnd Bookmark Insert Buttons

The Find Duplicate References macro matches a set number of characters, including spaces. The default is 120 (#4) but you can change the number to 36, 48, 60, 72, 84, 96, or 108 using the dropdown arrow shown at #4 in the Find Duplicate References message box above.

The macro does a two-pass search, one from the beginning of the reference and another from the end of the reference, which is why a list of duplicates may have repetitions.

The results of the search appear like this:

List of Possible Duplicate References

List of Possible Duplicate References

(They appear as tracked changes only if the macro is run with Tracking on; if Tracking is off, the results appear as normal text.) Note the title of the duplicates is “Duplicate Entries (Nondefinitive).” The reason for “Nondefinitive” is to remind you that the macro is “dumb” and there is no guarantee that the list includes all duplicates or that all listed items are duplicated. Much of the macro’s accuracy depends on the consistency of editing, including formatting.

For the examples in this essay, the Find Duplicate References macro was run on a list of 735 references and the list of possibilities shown represents those likely duplicate references the macro found. Note that references 19 and 78 were found (#19 and #78 indicate the portions of those references found duplicated by each pass of the macro); however, if, for example, in editing the page range separator in #19 was left as an en-dash in reference 19 and in reference 78 as a hyphen, the macro would not have listed the material at #19 as there would not have been a match. Similarly, if the author name in reference 19 had been left as “Infant” and in reference 78 as “Infantile”, the macro would not have listed the material at #78 as there would not have been a match.

The next step is for the editor to determine which of the listed possibilities are duplicates. This is done using Word’s Find Navigation pane, as shown here:

Verifying Duplicate References

Verifying Duplicate References

Copy part or all of what was found (#1) into the Find field (#2). Find will display the search results (“3 matches”) (#3); clicking the Browse button (the rightmost button at #3) lists the three matches found (#4 to #6). The first entry (#4) is always the text in the duplicates list (#1), which means that, in this example, the possible duplicates are #5 and #6. Clicking on the text marked #5 to see the complete text of that entry. Then compare that text to the text of the reference at #6. (It is possible for the macro to find more than two possible matches for the same text — and all, some, or none may be duplicates.)

Tip: Use comments to track duplicates


When I find a duplicate, I insert a prewritten, standardized comment (using EditTools’ Insert Query) to tell the client that references x and y are duplicates and that I am deleting one and renumbering it (see image below for a sample comment). I insert the comment at each of the duplicate references, although I slightly modify the comment so that it is appropriate for the reference to which it is being attached. The comment shown below is inserted at reference 78 and its language is appropriate for that reference. It tells the client that references 19 and 78 are identical and that reference 78 has been deleted and renumbered as 19. This type of comment is added to the version (e.g., the Track Changes version) of the reference list that will be given the client. The comment is added to the appropriate references as duplication is confirmed.

The Inserted Comment

The Inserted Comment

The comment, in addition to serving as a message to the client, serves as a reminder message during editing of the manuscript. Duplicate references require renumbering so as to keep reference callouts in number order. For example, it may be that reference 78 is called out after the callout for reference 10 and before that for 19. In that case, reference 78 would be moved to position 11 in the list and renumbered as 11 and the comment would be modified (easy to do using EditTools’ Comment Editor). A prewritten note (another new EditTools feature) would be inserted at point 78 in EditTools’ Reference Number Order Check and reference 19 would be marked as deleted, the inserted comment (see above) would be modified, and a note would be added to Reference Number Order Check at point 19. (See the discussion below about the report.)


When editing of the manuscript is finished, have the Reference Number Order Check macro export a renumbering report to send with the edited file to the client. A partial sample report is shown here:

Sample Partial Renumbering Report

Sample Partial Renumbering Report

Every report bears the creator’s identification information (#1) and file title (#2). You set the creator information once and it remains the same for every report until you change it using a manager. The file title is set each time you create a report.

As the report shows, reference 78 was deleted and all callouts numbered 78 were renumbered as 19 (#3). The prewritten, standard message (a new feature) can be inserted with a mouse click; only the numbers need to be inserted or modified. The report shows that the renumbering stopped at callout 176 (#4) and started again at 197 (#5). Number 6 shows another deletion and renumbering.

Clients like these reports because it makes it easy for authors, proofreaders, and others involved in the production process to track what was done.

The Find Duplicate References macro is a handy addition to EditTools. While it is easy in very short reference lists to check for duplicate references, as the number of references grows, checking for duplicates becomes increasingly difficult and time-consuming. The Find Duplicate References macro saves a lot of time, thereby increasing an editor’s profits.

Richard Adin, An American Editor

May 18, 2016

The Business of Editing: Uniqueness & Being Valuable to Clients

Editors gain work by being skilled. But with all of the competition for editorial work, being skilled is not enough both to gain business and to charge (and be paid) higher rates. Recently, Louise Harnby wrote about generalization versus specialization and its effect on a freelancer’s job prospects (see The Proofreader’s Corner: The Generalist–Specialist Dichotomy and the Editorial Freelancer). Another facet to being valuable to clients and to getting them to pay higher rates willingly is providing unique skills and services that those clients see as valuable.

I have been negotiating a contract with a major client. The negotiations have been ongoing since December and are about to conclude to my (and presumably also to the client’s) satisfaction. Although it has taken nearly 6 months, both sides were willing to stick with the negotiations because each side views the other as valuable.

What makes me valuable are the usual editorial things, such as highly skilled editing that evokes praise from my client’s authors. For example, last week a client wrote, “The authors have started reviewing pages, and they have been pleased, so thanks for the quality work!” What also makes me valuable are some of the unique services I provide. (Unique is being used relatively, to say that I am providing services that few editors provide, not that I am the only editor who provides the services.)

An example of a unique and valuable service I provide to clients concerns the renumbering of references. One of the more difficult tasks an editor may undertake is renumbering references in both the reference list and in-text callouts. It isn’t too difficult or confusing when a chapter has 20 references and three need to be renumbered, but the situation changes when the chapter has 258 references in the reference list with more than 300 in-text reference callouts and they all need to be renumbered. The renumbering becomes even more complex when it is scattered: for example, instead of 0 becoming 1, 0a becoming 2, and 1 becoming 3, 0 becomes 21, 0a becomes 76, and 1 becomes 5.

Not only does this become difficult for the editor to follow, but it is also a significant problem for authors during their review of the editing and for proofreaders, one that can lead to expressed dissatisfaction and complaints about the editor’s work if the authors discover a renumbering error.

A vast majority of editors simply go slowly, renumber, check it twice, and make a note to the client or authors that references were renumbered and the renumbering should be checked. To track the renumbering, the editors use pencil and paper, which further slows the process, especially when there are a lot of references requiring renumbering, as is often the case for me.

I offer my clients something unique — a “report” that details the renumbering. It is a separate file that accompanies the edited chapter and bears a title that references the chapter. For example, if the edited chapter file is Jones Synthetic Fibers 19e chapter 13 edited.doc, the renumbering file is 13 Jones Synthetic Fibers 19e Ref Num ReOrder Checklist.rno.txt. The renumbering file is a comma-separated list, with the all the original reference numbers listed to the left of the comma, including a, b, and c references (e.g., 1, 1a, 1b, 2), and the the new number, if any, listed to the right of the comma. For example,

Original Ref Number,Renumbered to
1,8
1a,2
1b,3
2,9
3,10
4,11

Because I use EditTools’ Reference # Order Check macro, creating the renumbering file is easy — I just export the list I use to track the renumbering as I edit.

It is worth noting that using the Reference # Order Check macro to track references called out in the text — even when no renumbering is needed — makes it easy to catch skipped in-text callouts. Another chapter in the recent project of mine that I mentioned earlier has 199 references. Most of the references are called out in order, so no minimal renumbering was required (in fact, only eight references required renumbering). However, five reference callouts were skipped — 54, 99, 107, 125, and 161 — which I easily found using the macro. Here is a portion of the report that will accompany this chapter:

Original Ref Number,Renumbered to
160,
161,text callout missing
162,169
163,162
164,163
165,164
166,165
167,166
168,167
169,168
170,
171,

(If a reference number is called out only once and only in number order, I can easily find the missing callouts, too. But in the texts I edit it is not unusual for callouts to be repeated even though initially called out in order — for example, 90, 91, 92, 93–96, 92, 94, 97 — which can make order tracking more difficult.) In instances where a text callout is missing, I usually insert an Author Query as follows:

AQ: Reference 106 is cited above, but there is no callout in the text for reference 107. Please either (1) insert a text callout for reference 107 between the callout for 106 above and the callout for 108 here, or (2) delete the current reference 107 from the reference list and renumber all references from this point forward.

If there are a lot of skipped numbers, in addition to the AQ at the location of the skipped callout, I compile a mini-report and insert it as a comment at the beginning of the document. Where references have been renumbered, I insert a comment similar to this at the beginning of the document:

AQ: Please note that some [or ALL capitalized if all rather than some is appropriate] references in this chapter have been renumbered. In addition, several references do not have in-text callouts. Please see the file “13 Jones Synthetic Fibers 19e Ref Num ReOrder Checklist.rno.txt” for details on the renumbering and the missing text callouts.

This is one example of additional value that I provide clients. Clients have remarked on this, especially noting that the authors and proofreaders are appreciative. One client told me to be particularly careful about renumbering references because the authors were very unhappy with the poor renumbering another editor had done on the prior edition. I received the large project because the client knew I would provide a high-quality edit along with a report with each chapter that required renumbering, both of which would please the authors. More importantly, it also helped ensure that I had done the renumbering accurately.

Okay, we have determined that this is a valuable service, but what is its benefit to me? Here it is: clients seek me out because I make their life easier. They want to send me the types of projects I want to edit. And they are more willing to negotiate with me, whether about schedule or money or both or something else. Clients seek out my services because what I can offer is unique and of value to them. My clients are packagers and publishers. Both have tight schedules they want or need to meet, and both want work done that requires minimal redoing or fixing. Over the years I have heard many publishers and packagers complain about not meeting schedules because of mistakes made in such tasks as reference renumbering. And when they do not meet schedules, they lose money.

These clients — at least the ones who give it some thought — consider it better to pay me a little more and take advantage of the unique services I can provide than to save a little on the editing expense but then have to pay even more to fix avoidable errors later. It is also valuable to them to have happy authors.

Do you offer unique services to your clients? Do you find that doing so makes you more valuable to your clients? Does being valuable to your clients result in long-term benefits to you?

Richard Adin, An American Editor

February 17, 2016

EditTools & My Editing Process: Part III

Part I introduced the preediting steps (Steps 1 to 3). Part II discussed the remaining two preediting steps (Steps 4 and 5) and then discussed the first editing step (Step 6) in my editing process, which is editing the references. Part III finishes the editing process with Step 7, which focuses on editing the main text.

Step 7: Editing the Text

I use a three-monitor desktop system for editing. When I edit the text, I have the primary document open on the first monitor, the online stylesheet open on the middle monitor, and other needed documents, such as the references, open on the right-hand monitor. I also have open several of the EditTools tools I use while editing (see below for an example), such as Bookmarks, Click List, Reference # Order Check (if the references are numbered rather than name–date style), and Toggle Specialty Manager. Once I start adding author queries using the Insert Query macro, I may add Comment Editor to the open tools mix.

Sample of EditTools Macros

Sample of EditTools Macros

I keep these tools open on the desktop because I use them often. Bookmarks are both navigational aids and tracking aids. The Reference # Order Check provides a way to track reference callouts and renumbering them if renumbering is required. Click List provides a quick-and-easy method for inserting text or symbols. Toggle Specialty Manager lets me add to the active Toggle list new project-specific terms that I encounter while editing.

As I edit, I know that decisions will need to be made. For example, should I let an acronym stand or should I replace it with its spelled-out version? If the client has a rule governing usage, I need to be able to apply it. So, for example, when I come across travel risk management (TRM), I run the ESCR (Enhanced Search, Count, & Replace) macro, shown below, to determine how many times in the document the phrase travel risk management appears and how many times TRM appears.

ESCR looks for these variations (I can add additional ones)

ESCR macro

ESCR macro

and provides this report

ESCR Report

ESCR Report

Using the report screen, I can make changes to the text. For example, in the above report, travel risk management appears 10 additional times in the document. I can also see that the acronym TRM is often used. Consequently, for consistency, assuming that TRM is acceptable to the client, I need to change travel risk management to TRM. Thus I type TRM in fields #1 and #2 and I check the highlight box (#3) next to TRM. I also leave TRM3 as it is, because that is different from TRM and needs to be defined and searched for separately. Clicking OK then lets the macro change all 11 instances of travel risk management to TRM with tracking on. The macro also yellow highlights the 37 instances of TRM. As I edit the document now, when I see the yellow-highlighted TRM, I know that it has already been defined earlier in the chapter and that the decision was made to use the acronym rather than the phrase. Had the report come back saying there were only two instances of TRM, then the decision might have been to use the spelled-out version instead of the acronym.

If travel risk management (TRM) is not in my Word Specialty dataset, I add it (I also add it to the online stylesheet if it is not already there), using the Acronym/Phrase entry system (shown below).

Toggle Word Acronym/Phrase entry system

Toggle Word Acronym/Phrase entry system

In the future, if I come across an instance of TRM that needs to be spelled out, I can click Toggle Word and choose from among several options, as shown here:

Toggle Word Choice Menu

Toggle Word Choice Menu

If I need to query the author or make a comment to the compositor, I use Insert Query (see below). With Insert Query, I can call upon a previously written query that I have saved, or create a brand-new query, which I can save, or not, to the dataset for future reuse.

Insert Query

Insert Query

If I want to alter a query for any reason, or even if I want to delete a query — whether it is located 20 pages ago or where I currently am — I use Comment Editor, shown here:

Comment Editor

Comment Editor

Comment Editor lists all of the queries I have inserted in the document (#1). There is no limit to the number of queries Comment Editor will list. One of the nice things about Comment Editor is that I do not need to go to the page where the query is located to edit it. I select the query that I want to edit and the complete text of the query appears in the Text box (#2), where I can edit or completely rewrite it. If I want to go to the query in the manuscript, I can click Go To Comment (#3). That will take me to the query’s location. To return to where I was in the document, I click Return to Before (the name is odd but it refers to the bookmark that was inserted). I can also delete a query by selecting it and clicking Delete (#4). With Comment Editor I do not need to spend time trying to locate the query I want to modify, going to it, and then returning to where I was in the document.

As I indicated earlier, I use the Bookmarks macro as a way to track figures, tables, and text boxes. I also use it to mark items I need to return to for some reason. Unlike Word’s Bookmark feature, EditTools’ Bookmarks lets you use descriptive language. That helps greatly when, for example, you want to bookmark a sentence to recheck. With EditTools’ Bookmarks you could insert “Recheck this sentence – has TRM been mentioned?”, as shown here:

Bookmarks

Bookmarks

I use the Bookmarks renaming function for tracking. If Figure 1 has been called out in the text and I have edited the figure and its caption, I rename the bookmark. I select the bookmark and click Rename (#1), which brings up the renaming dialog shown here:

Bookmarks Renaming Dialog

Bookmarks Renaming Dialog

The renaming dialog tells me which bookmark I am renaming (#1). Because I have selected certain items to be the defaults (#2 and #3), the new name automatically appears in the To field (#4). I could choose a different prefix or suffix, add new ones, change the defaults, and even choose None (meaning either no prefix or no suffix is to be used). If the default is what I want, I click OK and the change is made, as shown below, but the bookmark remains in the same location.

After Renaming

After Renaming

When I am done editing the document, I bring the reference file back into the main document using Word’s Insert File feature. I then run one last EditTools macro, Remove All Highlighting, which is found in the Other menu on the Highlight menu, as shown here:

Remove All Highlighting

Remove All Highlighting

Running that macro will remove all the highlighting I have added during editing. It has no effect on Track Changes, just on the highlighting. If I need to keep certain highlighting, I instead run the Choose Highlighting To Remove macro. When I run that macro, it searches through the document to determine what highlighting colors are used in the document and lists them, as shown here:

Choose Highlighting to Remove

Choose Highlighting to Remove

I select the colors I want removed and click OK.

That’s pretty much the process I follow and the way I use many of the EditTools macros. I haven’t mentioned several macros, because they are not part of my usual editing process. I do use them, just not with the frequency of those described above. Under the right circumstances, these other EditTools macros can be very useful.

If you are a user of EditTools, share your experience with EditTools and tell us which macros you use and when you use them.

Richard Adin, An American Editor

_______________

Looking for a Deal?

You can buy EditTools in a package with PerfectIt and Editor’s Toolkit Plus 2014 at a special savings of $78 off the price if bought individually. To purchase the package at the special deal price, click Editor’s Toolkit Ultimate.

February 15, 2016

EditTools & My Editing Process: Part II

Part I introduced the preediting steps (Steps 1 to 3). Part II discusses the remaining two preediting steps (Steps 4 and 5) and then discusses the first editing step (Step 6) in my editing process, which is editing the references.

Step 4: Moving the References

Most of the projects I work on have extensive reference lists. Sometimes a chapter will have a relatively short reference list of 50 or so, but most are at least 100 references, and sometimes are more than 1,000 references.

After the preliminary steps and before running Never Spell Word (Step 5), I move the reference list to its own file. I do this for several reasons. First, some of the macros that I use during editing can affect the references, creating undo work for me. Moving the references to their own file avoids this problem.

Second, I like to edit with Spell Check on. However, Spell Check sees many author names and foreign spellings in journal names and article titles as misspellings. That wouldn’t matter except that it often leads to the message that Spell Check can’t be used because there are too many spelling errors and so Word will turn off Spell Check — for the entire document. By moving the references to their own file, I almost always avoid that particular problem. (Yes, I am aware that I could turn off Spell Check just for the references — for example, by modifying the styles used in the references, which is what many editors do — but I like Spell Check to be on even for the references.)

Third, I want to be able to run my Journals macro unimpeded and as quickly as I can. The more material the Journals macro has to run through, the longer it takes to complete.

Fourth, I want to be able to run Wildcard Find & Replace on the references without having the macro also affect other parts of the document.

And fifth, moving the references to their own file makes it easier to check text reference callouts against the references because I can have both the primary document and the references open concurrently and on different monitors.

I do not edit the references in this step; I simply move them to their own file.

Step 5: Project-Specific Never Spell Word

The next preedit step is to create my project-specific Never Spell Word (NSW) dataset, which is shown below. Every project has its own NSW dataset (#13). The only time I use a previously created dataset is when I have edited a previous edition of the book. I assume that word usage decisions made in previous editions will continue in the current edition. This is generally reinforced when the client also sends me a copy of the stylesheet I prepared for the prior edition (or tells me to use it, knowing I have it available on my website). I do, however, go through the NSW dataset to make sure there are no changes that need to be made as a result of changes in the applicable style guide or in other pertinent guidelines (e.g., changing over-the-counter and OTC to nonprescription).

Never Spell Word dataset

Never Spell Word dataset

If I cannot use a previously created NSW dataset, I create a new one using the Never Spell Word Manager shown above. Note that when I speak of the NSW dataset, I am really speaking about the one tab in the Manager — the Never Spell Words tab (circled). Although the other tabs are part of the NSW macro, they are not project specific as I use them; however, they can be project specific, as each tab can have multiple datasets, and the tabs also can be renamed.

In the example NSW, the dataset has 70 items (#15). These items were specifically mentioned by the client or the author(s) (e.g., changing blood smear to blood film, or bone marrow to marrow) (#14), or things I noticed that will need changing (e.g., changing Acronyms and Abbreviations that appear in this chapter include: to Acronyms and Abbreviations:) (#14). As I edit and discover more items that should be added, I add them through this Manager.

The NSW macro has multiple tabs, some of which may not be relevant to the current project. Running the NSW macro brings up the NSW Selector, shown below. Here I choose which tabs to run. The default is Run All, but if I need to run only the NSW and Commonly Misspelled Words tabs for the particular project, I check those two and click OK and only those two parts of the macro will run.

Never Spell Word Selector

Never Spell Word Selector

After the NSW macro is run, it is time to begin editing.

Editing Steps

Step 6: The References

My first task is to edit the references that I moved to their own file in Step 4. I deal with the references before editing the text so I can determine whether there are “a,b,c” references (e.g., 57a, 57b) or if the references are listed alphabetically even though numbered. This is important to know for setting up the Reference # Order Check macro, found on the References menu and shown below, for tracking callout order and for renumbering if needed.

Reference # Order Check

Reference # Order Check

After I set up the Reference # Order Check macro, it is time to look at the references and see if the author followed the required style. Occasionally an author does; usually, however, the author-applied or -created style is all over the place. So the next macro I run is Wildcard Find & Replace (WFR) (shown below) and the appropriate scripts I created using WFR. The scripts focus on specific problems, such as author names and order-of-cite information (e.g., year first or last).

Wildcard Find & Replace Scripts

Wildcard Find & Replace & WFR Scripts

The scripts cure a lot of problems, but not all of them. Following the scripts, I run the Journals macro. Depending on which dataset I use, running the Journals macro may well fix nearly all of the journal names.

After running the Journals macro, I go through the references one by one, looking for remaining problems that need fixing, such as completing incomplete citations. If I come across a journal that was not in the Journals dataset, which I know because it is not color coded, I verify the journal’s name. I also go to the Journals Manager enhanced screen, shown below, so I can add the journal to multiple datasets concurrently.

Journals Manager Enhanced Screen

Journals Manager Enhanced Screen

Once I have finished editing the references, it is time to begin editing the main text (Step 7), which is the subject of Part III.

Richard Adin, An American Editor

_______________

Looking for a Deal?

You can buy EditTools in a package with PerfectIt and Editor’s Toolkit Plus 2014 at a special savings of $78 off the price if bought individually. To purchase the package at the special deal price, click Editor’s Toolkit Ultimate.

February 10, 2016

EditTools & My Editing Process: Part I

I have been asked to describe how EditTools fits in the editing process. I have avoided doing so because each editor works differently and the way I edit suits me but may not suit someone else. However, I have been asked that again as part of a question about EditTools, and I have decided that perhaps the time has come to explain how I use EditTools in my editing process.

Usually the manuscripts I edit — all nonfiction, with a majority being STEM (science, technology, engineering, and medicine) — come to me in groups of a few chapters. Occasionally I will receive the entire book, but even then it is usually divided into chapter files. When the book is given to me as a single file, I divide it into chapter files.

I know some editors prefer to work with a single file that represents the whole book. I do not, for a number of reasons, not the least of which is that the books I usually work on are much too long to effectively edit as a single file — sometimes a single chapter runs more than 400 manuscript pages. In addition, Word is not the most stable of programs, and the larger the file (and the more that goes on in the file), the more likely it is that Word will crash — and keep on crashing. More important, however, is that by working on chapter-size files, I can add to my EditTools datasets and have those additions applied in future chapters. Without reading every word, I cannot know in advance every decision that I need to make.

Before-Editing Steps

Step 1: Delete Unused Styles

I receive basically two types of files: ones that the authors designed and ones that the clients have manipulated before sending them to me (in my work, authors are not my clients). Sometimes I need to apply a template to the file. In the case of the author-designed file or a file to which I need to apply a template, the first thing I do is run the Delete Unused Styles macro (#1) shown here:

Delete Unused Styles

Delete Unused Styles

By running this macro, I eliminate many (not all) of the author-created styles that aren’t used in the document and narrow the number of styles that I need to deal with.

Step 2: Cleanup & Style Language

After that, I run the Cleanup macro (#2). The Cleanup macro has its own Manager (shown below), which lets me set what I want cleaned up (#3). It also lets me link to a Specialty file (#4) for additional cleanup that is specific to the project (or type of project) I am working on. The Manager lets me set the order of the cleanup by moving the items around, although I don’t bother — instead I run the macro twice. The main field shows me what will be done (#5). And, as is true of all EditTools datasets, I can save my cleanup profile (#6). What that means is that I can create custom cleanups based on client or type of project or any other criterion and recall them as needed.

Cleanup macro

Cleanup macro

As part of this step, I also run the Change Style Language macro, which is found under Other on the Other menu, as shown here.

process 2 A

Change Style Language

I run the macro to make sure that the language used is uniformly U.S. English and to make sure Spell Check is on. Authors tend to use multiple languages and sometimes turn off Spell Check. The macro gives me the option to choose any Word-supported language and to turn Spell Check on or off, as shown here:

process 2 B

Choosing the Spell Check Language

After I have made my choices, I click Update and the macro will update the document’s styles.

This is also the step where I run the Superscript Me macro, which is found on the References menu, as shown here:

Superscript Me

Superscript Me

Superscript Me lets me change how reference numbers appear in the text. For example, if the author has the numbers in square brackets (e.g., [122]) when they should be superscript without the brackets, I can quickly make the change throughout the document by running this macro. The macro also lets me choose how the numbers are to appear in relation to punctuation; the choices are between the AMA and the Chicago options, as shown here:

Setting Superscript Me's Options

Setting Superscript Me’s Options

(Tip: If the numbers are correctly superscripted but incorrectly placed in relation to punctuation, select None and the correct style type, then run the macro. The numbers will remain superscript, but the style will be corrected. This will also clear out any spaces in superscripted numbers following a comma [e.g., superscripted 132, 134 will become superscripted 132,134].)

Step 3A: Coding & Styling

After the Cleanup step, I code or style the document. In the “olden” days, I applied the codes or styles as I edited, but with EditTools, it is easier and quicker to apply them before editing begins. I may change some during editing (e.g., change a numbered list to a bulleted list), but nearly all remain as originally coded/styled.

Most of the projects I work on require me to either add coding or apply client template styles to the text. If it is codes, I use the Code Inserter Manager; if it is styles, I use the Style Inserter Manager. Consequently, creating the Inserter dataset for the project is next on my to-do list. Because clients tend to use the same styles and codes, I generally open an existing dataset and just make necessary changes, such as in the way a head is to appear (e.g., title case bold, all capitals, or sentence case italic). Here is a Code Inserter Manager dataset:

Code Inserter Manager dataset

Code Inserter Manager dataset

Note that the sample is the 9th edition of a book (#7). I took the project-specific Code Inserter dataset for the 8th edition of this book and copied it for the 9th edition, and then made whatever changes were required, such as in head casing (#8) or options (#9) or code to be used (#10). Within a few minutes, I was set to begin coding.

The same is true with the Style Inserter, shown below. Often a client uses standard designs rather than creating a new design for each book. The client tells me the standard design to use for the project and I open the style dataset (#7) for that design. Again, I may need to make some adjustments (#8, #9, #10), but once I have created the basic dataset, I can reuse it repeatedly (#7). The Style Inserter Manager is very similar to the Code Inserter Manager.

Style Inserter Manager dataset

Style Inserter Manager dataset

Step 3B: Bookmarks

At the same time that I open the Inserter (Step 3A), I open the Bookmarks macro, shown below. (In cases where I do not have to code/style, this is the only portion of Step 3 that I do.) I always add two bookmarks — refs, which is required by the NSW macro, and editing paused here, which is my generic bookmark for when I pause in editing for some reason (arrows & #11) — to every manuscript. In addition, as I code/style, I insert a bookmark at each table (e.g., Table 01, Table 02, etc.) and figure (e.g., Fig 01, Fig 02, etc.), and at any other item, such as boxed text, that I may need to find again. I use the bookmarks as a way to track what tables and figures have been called out in text and edited. They also provide an easy way to get from my current location to where the table or figure is located, and back again. After I edit a figure, for example, Fig 01, I change its bookmark name to x Fig 01 edited. The x causes the bookmark to move to the end of the list and edited tells me that it has been edited. This makes it easy to catch a missed text callout as well as to get to and from a figure, table, or other bookmarked text.

Bookmarks

Bookmarks

Part II continues the preediting steps (Steps 4 and 5) and introduces the first editing step (Step 6), which is editing the references. Part III discusses the final step (Step 7), editing the text.

Richard Adin, An American Editor

_______________

Looking for a Deal?

You can buy EditTools in a package with PerfectIt and Editor’s Toolkit Plus 2014 at a special savings of $78 off the price if bought individually. To purchase the package at the special deal price, click Editor’s Toolkit Ultimate.

January 27, 2016

The Business of Editing: Creating Multiple Journals Datasets Simultaneously

I have written in past essays (see, e.g., The Business of Editing: Journals, References, & Dollars and The Business of Editing: Cite Work Can Be Profitable) about the Journals macro and how useful it is in my editing work. But the usefulness of the macro has always been tempered by the size of the dataset I am using. For example, the sizes of my current datasets are: American Chemical Society (ACS), 30,922; PubMed/American Medical Association (AMA), 98,669; Chicago/American Psychological Association (APA), 1981; and Harvard, 349. Clearly, my PubMed/AMA dataset is the most useful and reflects the type of projects I usually edit.

The other Journals datasets are increasingly being called on, yet at the moment, with the exception of the ACS dataset, they have too few names to be very useful.

The key to many of the macros in EditTools is the dataset; the larger the dataset, the more powerful the macro that uses the dataset. Consequently, how fast a dataset can be built is important.

Over the different versions of EditTools, changes have been introduced to the Journals Manager that were designed to increase the speed and efficiency with which Journals datasets are built. Originally, each entry variation to the dataset had to be made individually. To speed things up the Multiple Entry process was created. It allowed you to enter multiple variations at one time.

But you were still limited to dealing with a single dataset.

Journals version 7 changes that — now you can add entries to as many as five different datasets simultaneously. In addition, you no longer have to manually create each variation; many variations can be created automatically.

Switching to the Multiple Datasets Entry Screen

The first time you open the Journals Manager in EditTools v7, you will see the same Manager you have seen before (shown below) with one exception — the addition of the checkbox (circled in image):

Original Journals Manager Screen

Original Journals Manager Screen

Version 7 offers the Switch to Enhanced Journals Screen checkbox (#1 above). When you check the box, the dialog changes to the enhanced dialog shown here, which becomes the default:

New Enhanced Journals Manager Screen

New Enhanced Journals Manager Screen

If you do not need the multiple-dataset capability, you can return to the original single-dataset capability by checking the Switch to Original Journals Screen (#2), which will become the default journals entry screen again.

The enhanced screen allows journal entries to be added concurrently to as many as five different datasets. When you first open the enhanced screen, the available files are labeled Custom #1 through Custom #5 (#A and #B in above image). However, you can rename these to whatever you would like by double-clicking on the current name in the Always Correct Journal column to open the renaming dialog. For example, double-clicking PubMed/AMA (#3) opens the renaming dialog shown here:

Renaming Dialog

Renaming Dialog

Enter the new name in the provided field (#4), and click OK. The name will be changed immediately to the new name, both in the Always Correct Journal column (#3) and at the corresponding name in the File Data to Show fields (#5).

The enhanced screen can be used to enter a single title, just as in the original screen. In the example shown below, the journal name being entered is Physiol Meas (#6). That form is fine for PubMed/AMA (#7), but not for the other datasets. So, in the fields for the other datasets, the correct forms are entered (#8 to #10). When Add (#11) is clicked, all four datasets are updated simultaneously — a significant timesaver.

Example Journal Entry

Example Journal Entry

It is not necessary to make use of all of the dataset fields. You can use one, five, or any number between. Only those in which the Correct to field has an entry will be updated. In other words, if only the PubMed/AMA dataset is to be updated with the information in #6 and #7, then #8 through #10 are left empty. Clicking Add (#11) updates only the PubMed/AMA dataset — even though three other datasets are identified.

It is important to note that the journal names that appear in #7 through #10 are what the entry in #6 (and the multiple entries that will appear in #8 in the “Multiple Journal Name Entry Dialog” image below) will be changed to. In this example, when Add (#11) is clicked, the Chicago/APA dataset will have added to it the instruction to change Physiol Meas to Physiological Measurement in a document when the Journals macro is run and the Chicago/APA dataset is chosen. Similarly, the ACS dataset will gain the instruction to change Physiol Meas to Physiol. Meas. when the Journals macro is run and the ACS dataset is chosen.

The New Multiple Journal Name Entry Dialog

When the Multiple Entries button (#12 in the “Example Journal Entry” image above) is clicked, both the original and enhanced screens give access to the new Multiple Journal Name Entry dialog shown here:

Multiple Journal Name Entry Dialog

Multiple Journal Name Entry Dialog

This dialog is different from the dialog that appears in in earlier versions of EditTools. The new Multiple Journal Name Entry dialog offers new options, many of which can be preset as default options, that are designed to make entry of multiple items into a single or multiple datasets quick and easy.

Previously, you had to manually enter trailing punctuation; now you can either individually set the trailing punctuation each time or preselect some (or all) (#1) as the default (#2). (If you copy text and paste it in the Text to Add field [#6], and in doing so include ending punctuation, you can tell the macro to ignore that trailing punctuation by checking the Ignore punctuation at the end of entry string box [#5].) Also in earlier versions, if a journal name began with “The” and/or included either “and” or “&”, you had to manually change them. For example, if the journal name was The Journal of Rise & Shine, to enter The Journal of Rise & Shine plus Journal of Rise & Shine, The Journal of Rise and Shine, and Journal of Rise and Shine, you had to enter each variation manually. Now you just need to add checkmarks to the Variations (#3) options.

The same is true for the different capitalization options (#4), except that the Title Case option also has options that are accessed by clicking the Edit button (circled in the above image), which opens this dialog:

Journals Title Case Manager

Journals Title Case Manager

Here you tell the macro which words, when the Title Case option is checked, should always be lowercase unless they are the first word in the journal name. Consider the example shown below (#10). Note the option choices made (#11, #12, and #13). Clicking Add (#14) automatically adds the title and the variations to the main field (#15).

Journals Manager Multiple Entry Options

Journals Manager Multiple Entry Options

More than 50 variations are being added concurrently. You can see all of them at the Journals page at the wordsnSync website; we would need to add four additional images here to display them all.

Once you have generated the variations on a journal name that you want, you can add them to one or more of your journal datasets. The combination of the changes in the generation of variations and the ability to concurrently update up to five datasets makes creation of journals datasets a quick, efficient, and easy process.

The new enhanced Journals screen and the improved Multiple Journal Name Entry screen will enable you to build Journals datasets quickly. One thing to note: If a journal name (or variation) already exists in a dataset, a duplicate will not be added. Only unique names are added. Consequently, it does not matter if one of the Journals datasets already has, for example, The Rise & Shine Journal in it; that particular entry will be ignored for that dataset and the remaining variations that are not duplicates, such as The Rise and Shine Journal and Rise & Shine Journal, will be added.

Building datasets in EditTools is easy; building multiple journals datasets simultaneously in EditTools is also easy.

Richard Adin, An American Editor

___________________

Looking for a Deal?

You can buy EditTools in a package with PerfectIt and Editor’s Toolkit Plus 2014 at a special savings of $78 off the price if bought individually. To purchase the package at the special deal price, click Editor’s Toolkit Ultimate.

Next Page »

Blog at WordPress.com.

%d bloggers like this: