An American Editor

November 26, 2016

Important: Facebook & LinkedIn Ransomware

Ars Technica reports a security flaw in Facebook and LinkedIn that can cause ransomware to be unleashed on your computer. Please read:

Are you feeling Locky? —
Locky ransomware uses decoy image files to ambush Facebook, LinkedIn accounts

for the details. Of course, the best protection against ransomware is to not download anything and to never open a file or attachment, but that is not real in today’s world. Consequently, I highly recommend two software programs. I use both and have no financial or other interest in either program, other than being a long-time user of each.

The first is BitDefender Internet Security, which includes ransomware protection. There is a special Black Friday deal which is accessible here:

BitDefender Black Friday Deal

The second is Sandboxie, which allows you to open nearly any program automatically in a sandbox. The result is that even if malware is downloaded, it is downloaded to a sandbox, not to your main operating system files. Even if opened, the files are in a sandbox and thus can be checked and deleted without ever exposing your computer to permanent harm. Sandboxie offers an inexpensive lifetime license.

Sandboxie Lifetime Licensing

Be safe, be aware.

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

October 10, 2016

Lyonizing Word: Using Two-Part Buttons

by Jack Lyon

Nearly a year ago, I explained some secrets of Microsoft Word’s Ribbon interface (see Lyonizing Word: Secrets of the Ribbon), including two-part buttons like the one that activates FileCleaner in Editor’s ToolKit Plus 2014.

At first glance, this button looks ordinary, with a graphic icon at the top and a tiny arrow at the bottom:

filecleaner-button

Click the arrow, and you’ll get a dropdown list of FileCleaner’s features:

filecleaner-dropdown

What many people don’t realize, however, is that the FileCleaner button is a two-part button. If you hover your cursor over the button, you’ll see a horizontal line splitting the button in two:

filecleaner-split

The bottom half, with the arrow, works just as before. But the top part is a different matter. If you click it, you’ll get full access to all of FileCleaner’s batch cleanup options:

filecleaner-batch-options

Microsoft Word’s Ribbon interface includes quite a few two-part buttons, but if you don’t know about them, you may not be using Word as efficiently as you could. There’s no sure way to spot them without hovering your mouse pointer over them, although they always include a tiny black arrow (as do many one-part buttons). A good example is the Paste button on the Ribbon’s Home tab:

paste-button

If you hover your mouse pointer over that button, you’ll see that it has two parts:

paste-button-split

Click the part with the arrow, and you’ll have access to various paste options. Pretty neat!

So what other buttons have two parts? Here is the complete list, along with the default options you’ll see if you click each button’s arrow (as opposed to its icon). Please note that what you’ll see may vary depending on what’s going on in Word.

Home tab

Paste

paste-button-split

paste-options

Text Highlight Color

text-highlight-color

text-highlight-color-options

 

Font Color

font-color

font-color-options

Bullets

bullets

bullets-options

Numbering

numbering

numbering-options

Shading

shading

shading-options

Borders

borders

borders-options

Find

find

find-options

Styles

styles

styles-options

Insert

My Add-ins

my-add-ins

my-add-ins-options

Signature Line

signature-line

signature-line-options

Object

object

object-options

Equation

equation

equation-options

Design

Document Formatting

document-formatting

document-formatting-options

References

Next Footnote

next-footnote

next-footnote-options

Citations & Bibliography > Styles

citation-styles

citation-styles-options

Review

Comments > Delete

delete

delete-options

Tracking > Display for Review

display-for-review

display-for-review-options

Tracking > Reviewing Pane

reviewing-pane

reviewing-pane-options

Tracking > Track Changes

track-changes

track-changes-options

Changes > Accept

accept

accept-options

Changes > Reject

reject

reject-options

View

Macros > Macros

macros

macros-options

I believe that’s all of them, although there’s one that’s not on the Ribbon that you should be aware of — the Undo button, which you’ll see at the top left of your Word window:

undo

undo-options

Here, you can select items en masse and undo them. Is that useful? Maybe sometimes.

One thing you can say about Microsoft Word: It’s not lacking in features. If anything, it has more features than most people will ever use (see Lyonizing Word: The Right Tool for the Job). I hope this article will help you find some useful features that you may not currently be aware of.

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.

August 22, 2016

Lyonizing Word: Before Typesetting

by Jack Lyon

I need your help, Gentle Reader. I need your ideas. Back in 1996, when I started selling Microsoft Word add-ins at the Editorium, getting a Word document into QuarkXPress was tricky: Quark was prone to crashes and didn’t handle footnotes at all. To solve these problems, I created QuarkConverter, and NoteStripper. A few years later, when people started switching to InDesign, I created InDesignConverter.

In the past several years, however, both QuarkXPress and InDesign have become much better at importing Word documents directly, without the need for a converter. The crashes are mostly gone, and footnotes come right on in. Nevertheless, I’m wondering what else might be done to a Word document to save time and trouble when importing into a layout program — and I’d greatly appreciate your thoughts about that. Here are some examples of the kind of thing I have in mind:

  • Add nonbreaking spaces to dates and initials.

For example, if the text includes a date like “August 17, 2016,” most typesetters want “August” and “17” to stay together; adding a nonbreaking space between the two elements does the trick. Similarly, if a name like “C. S. Lewis” shows up, it’s nice to keep the “C.” and the “S.” together. (To add a nonbreaking space in Word [Windows] 2007 and newer, hold down the CTRL and SHIFT keys as you press the spacebar. For Word [Mac], press the Option key as you press the spacebar.)

  • Remove formatting “overrides.”

Typesetters typically want to handle formatting with styles, so that changing a style attribute in InDesign automatically changes formatting throughout the document. If an author or editor has applied styles in a Word document, those styles can be imported and used in InDesign. But if an author or editor has applied direct formatting using various fonts, that formatting will be imported as “overrides” on the text, which can be a bit of a pain to clean up.

Override Options

Override Options

In its Styles pane, Microsoft Word offers to “Clear All” formatting and styles from selected text.

Clear All Option

Clear All Option

The problem is, “Clear All” really does mean “Clear All,” including not just font overrides but also such local formatting as bold and italic, which needs to remain intact. InDesign’s “Clear Overrides” feature has the same problem. Do you really want to remove italic formatting from the hundreds of journal titles in that giant manuscript you’re editing? If you’re proofreading or setting type, do you really want to put all that formatting back in again by hand? My FileCleaner add-in includes an often-overlooked feature (“standardize font formats”) that removes font overrides but leaves bold, italic, and other local formatting intact, which is exactly what’s needed.

Standardize Font Formats Option

Standardize Font Formats Option

  • Turn straight quotation marks into curly ones.

InDesign can do this—sort of. But it can’t handle things like “’Twas the night before Christmas” or “A miner, ’49er” (dreadful sorry, Clementine). FileCleaner does a much better job of dealing with this; it properly handles ’til, ’tis, ’tisn’t, ’twas, ’twasn’t, ’twould, ’twouldn’t, and ’em, as well as single quotation marks in front of numbers, all of which then come into InDesign correctly. If you have other items that should be included in this list, I’d love to know what they are.

  • Remove multiple spaces between sentences.

In the 1800s many books were set with extra space between sentences.

Sample of 1800s Typeset Page

Sample of 1800s Typeset Page

But, frankly, the 1800s were not exactly the golden age of typesetting.

1800s Poster

1800s Poster

Modern books include just one space between sentences. Still, many authors continue to use two, following the instructions they were given by their high-school typing teacher back in the twentieth century. And that means the double spaces need to be removed at some point. InDesign has built-in find-and-replace routines that will fix this and a few similar items.

InDesign Find & Replace

InDesign Find & Replace

FileCleaner, however, fixes many such things. And the version that’s included with Editor’s ToolKit Plus 2014 fixes many more.

FileCleaner Options

FileCleaner Options

  • Change italic and bold formatting to character styles.

Using character styles in InDesign provides much more stability and flexibility than local bold and italic formatting. It would be nice to have these styles already applied in Word before the document is imported into InDesign. My tools don’t currently do this, but they probably should.

QuarkConverter and InDesignConverter include some other useful fixes.

Quark Converter Options

Quark Converter Options

 

InDesign Converter Options

InDesign Converter Options

Nevertheless, I can’t help thinking that there must be things I’ve overlooked. I’m an editor, not a typesetter, so I don’t really know all of the things that typesetters have to fix that they really shouldn’t have to deal with. (This probably includes the most common errors that proofreaders mark.) So if you do typesetting or proofreading, would you help me out? I’d really like to know what I’m missing — things that could be cleaned up in an automated way in Microsoft Word before a document is ever imported into InDesign. What problems do you routinely encounter that you wish would go away? If you’ll let me know, I’ll try to come up with an add-in designed specifically to fix such things. Your suggestions for this would be most welcome.

Of course, typesetters and proofreaders aren’t the only ones who can benefit from this kind of cleanup. It’s also valuable to editors, allowing them to focus on words, structure, and meaning rather than deal with these tiny but pervasive problems. Little things like double spaces and straight quotation marks may not seem all that bothersome, but like pebbles in your shoe, they create subliminal annoyance that really adds up, making editing much more difficult than it should be. At least that’s my experience. What do you think?

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 18, 2016

Lyonizing Word: Inside Notes

by Jack Lyon

As useful as they are, Microsoft Word’s footnotes and endnotes are amazingly easy to mess up. Let’s look at some ways that can happen — and how to fix the problems.

First, we need to open a document that has footnotes — or make one. Then, to really see what’s going on, we’ll do this:

  1. Click “View” and then “Draft.”
Click "View" then "Draft"

Click “View” then “Draft”

2. Click “References” and then “Show Notes.”

Click “References” and then “Show Notes”

Click “References” and then “Show Notes”

That should take you into Word’s “Notes Pane,” which should look something like this:

Word’s “Notes Pane"

Word’s “Notes Pane”

Deleted Reference Numbers

The superscript numbers in front of each note are called reference numbers. By default, they’re formatted with a character style — either Footnote Reference or Endnote Reference, which you can modify if necessary. What’s interesting about these numbers is that it’s possible to delete them, so the notes look like this:

Deleting Note Numbers

Deleting Note Numbers

Deleting them, however, is an extraordinarily bad idea. Those numbers may look simple, but under the hood they have a lot going on. The number itself is automatically generated based on the reference number in the text itself. (If you create footnote number 9 in your document, the note itself will start with the number 9. If you delete footnote number 9 in your document, the note and its number will be deleted.) The number also signals the start of a new note, and if it’s gone, document corruption is probably not far behind.

You can often tell if a reference number is missing by looking at the other note numbers. If they’re numbered like this, you know something’s wrong:

A Clue That Something Is Wrong

A Clue That Something Is Wrong

That’s actually a fairly easy problem to fix: just copy the reference number from one of the other notes and paste it in front of the note that’s missing its number. For example, if you copy the number for note 3 and paste it in front of the numberless note 2, you’ll actually get a 2 in front of the note. Microsoft Word is smart enough to know what the number should be.

Usually, the reason a number is missing is because the author has directly deleted the entire text of the note, like this:

When Note Is Deleted Directly

When Note Text Is Deleted Directly

Why Microsoft hasn’t prevented this is beyond me. If the author had deleted the note number up in the main document text, there wouldn’t be a problem.

Typed-In Reference Numbers

Sometimes, in an effort to make notes look “pretty” or meet a certain style, authors will format reference numbers as regular text rather than superscript, then type a period after them. There’s really nothing wrong with that, other than introducing extraneous periods when importing the file into a typesetting program. But some authors actually delete the numbers and type in new ones by hand. You can tell when that has been done by putting your cursor in front of a double-digit note number and pressing the right cursor key. If your cursor moves past the entire number, the number has been automatically generated. But if your cursor moves forward only one digit, the number has been hand-typed.

Again, you could fix the problem by copying an automatic number and pasting it over the hand-typed number, but what if all of the numbers have been hand-typed? Where will you get an automatic number to copy? Simple: just insert a new footnote and copy the number from that. After you’ve finished pasting, delete the extra note (up in the text, remember).

If you have lots of these numbers, you probably won’t want to fix them by hand, so here’s an easier way:

  1. Select all of the notes in the notes pane.
  2. Copy the notes.
  3. Paste the notes at the end of the document.
  4. Using Word’s Find and Replace feature, search for ^f (the code for footnotes) or ^e (the code for endnotes) and replace all of the existing note numbers with a superscript 1. (That will also delete all of the automatic notes in the document.)
  5. Use the “Text to Notes” feature of my trusty NoteStripper add-in to turn the text notes into automatically numbering ones.

“Special” Carriage Returns

Sometimes when editing notes, you’ll try to make a deletion and get the message that “This is not a valid action for footnotes”:

Oops!

Oops!

What that cryptic message should say is “You can’t delete the carriage return that ends a footnote.” The carriage return that marks the end of a note isn’t a regular return; it’s a special return, and you can’t delete it — Word won’t let you. So what often happens is that authors will delete the note text and its reference number, leaving the carriage return behind. But there is a way to get rid of that return: delete its note number up in the main text of the document. If you can’t tell which note number that is, copy the number of a different note and paste it in front of the note’s carriage return. That will give the note a proper number, and you can then delete the note up in the main text. If you have lots of these extraneous carriage returns, you can get rid of them with a macro, as described in “Lyonizing Word: Deleting Extraneous Carriage Returns in Footnotes and Endnotes.”

Microsoft, Are You Listening?

We wouldn’t have such problems with notes if Microsoft would implement just a few changes:

  1. Make it possible to delete a note by selecting the entire note, including the note reference number, the note text, and the “special” carriage return at the end of the note, and then pressing the Delete or Backspace key (which should also remove the note number from the main text). That would keep authors from leaving behind misnumbered notes and extraneous carriage returns.
  2. Provide additional numbering options for the reference numbers in front of the note text, in particular the option to use full-sized numbers followed by a period. That would keep authors from typing in numbers and periods by hand (maybe).
  3. When trying to delete the reference number or carriage return, provide a message that says “Select the entire note before deleting” or “To remove a note, delete the note number in the main text of your document.”

These changes would do a lot to prevent problems caused by authors who don’t know how to properly use Word’s notes. You can help by letting Microsoft know about these needed changes. Give your feedback at Microsoft’s “Welcome to Word’s Suggestion Box!

What about you? Have you seen other odd problems with Word’s notes? If so, how have you solved them?

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 2, 2016

Lyonizing Word: Using the “Find What Expression” Wildcard

by Jack Lyon

Rich Adin recently sent me an interesting challenge. He was using his EditTools Journal feature to mark journal titles in references. The power behind that useful tool comes from lists of incorrectly styled references with corresponding correctly styled references. He creates a separate list for each reference style. The list he sent me was for AMA style, in which the reference uses the PubMed abbreviation followed by a period. It looks like something like this:

A Gesamte Exp Med, | cyan -> Z Gesamte Exp Med.
A Gesamte Exp Med. | cyan -> Z Gesamte Exp Med.
A JR | cyan -> AJR Am J Roentgenol.
A M A Arch Ind Hyg Occup Med. | green
A of LTC | cyan -> Ann Longterm Care.
A of LTC, | cyan -> Ann Longterm Care.
A of LTC. | cyan -> Ann Longterm Care.
A&D | cyan -> Aging Dis.
A&D, | cyan -> Aging Dis.
A&D. | cyan -> Aging Dis.
A. M. A. Arch. Derm | cyan -> AMA Arch Derm.
A. M. A. Arch. Derm, | cyan -> AMA Arch Derm.
A. M. A. Arch. Derm. | cyan -> AMA Arch Derm.

The text to the left of the pipe (|) is how the entry might (incorrectly) appear in the references supplied by the author; the entry to the right is how it should appear. Each entry includes a color, either cyan or green, which tells the program to use that color in highlighting the reference.

Rich knew that some of the entries included duplicates, like this:

Arch Intern Med. | cyan -> Arch Intern Med.

In other words, the item on the left was identical to the item on the right, which meant that it shouldn’t be marked. That also meant the entry didn’t need to be on the list at all. But the real problem was that Rich’s reference list included more than 117,000 entries!

Rich’s challenge? Use wildcard find and replace to remove such entries, thus shortening the list and preventing unnecessary marking.

First, let’s look at that entry again to see what we might need to do:

Arch Intern Med. | cyan -> Arch Intern Med.

There’s a pipe symbol (|) in the middle, which gives us something to differentiate the left side of the entry from the right side of the entry. So we might set up the first part of our wildcard string to look like this:

([!^013]@) |

That tells Word to find any character except a carriage return, an unspecified number of times, until it comes to a space followed by a pipe symbol.

The wildcard for a carriage return is:

^013

The wildcard for “except” is:

!

And we have to put both of those in square brackets so Word knows that’s a set of characters. (After all, [!^013] finds any character, no matter what it is, unless it’s a carriage return.)

The wildcard for “an unspecified number of times” is:

@

Finally, we have to put all of that into a “group” by enclosing it with parentheses. And that’s important. You’ll see why in a minute.

Testing that part of our search string, we see that, yes, indeed, it finds the following:

Arch Intern Med. |

In fact, it finds the beginning of each entry, which is just what we want.

Now let’s look at the right side of our entry:

 cyan -> Arch Intern Med.

You can’t see it here, but there’s a space in front of “cyan” — the space that follows the pipe symbol. So we need to include that space in our search string, along with the word “cyan” (in the following examples, I use [space] to represent a space so you can see it; [space] should not actually be entered; use a real space created by pressing the space bar):

[space]cyan

There’s also a space after cyan, so we’ll need to include that as well.

[space]cyan[space]

That needs to be followed by a hyphen, a right angle bracket, and yet another space, like this:

[space]cyan[space]-\>[space]

But now you may be wondering why I put a backslash in front of the angle bracket. It’s because the angle bracket is itself a wildcard (a subject for another day), so we need to tell Word we’re using it as an actual character, which is what the backslash does.

Finally, the rest of our search string looks like this:

\1^013

This part of the string —

\1

— is the “Find What Expression” wildcard, which is what this article is about, and it certainly took us a long time to get to it!

Remember back when we grouped the very first part of our search string in parentheses?

([!^013]@)

That “group” is the “expression” that the \1 wildcard represents. In algebraic terms:

\1 = ([!^013]@)

And that means \1 will find whatever is found by the ([!^013]@) expression, which, my friend, is extremely cool, because it will allow us to weed out the duplicate entries on our reference list—entries like this:

Arch Intern Med. | cyan -> Arch Intern Med.

Now, for the first time, let’s look at our entire search string:

([!^013]@) | cyan \-\> \1^013

By now, you probably understand this quite well. The string finds any characters except a carriage return until it comes to a space and a pipe symbol; then it finds a space, the word “cyan,” and another space, followed by a hyphen, a right angle bracket, and a space. Finally (and most importantly), it finds whatever was found by the parenthetical group, followed by a carriage return.

Now we simply need to make sure that Word’s “Replace with” box is empty and click “Replace All.” All of those unnecessary entries will be deleted. (We’ll need to repeat with “green” for the entries that don’t include “cyan.”)

Which would you rather do: Find and delete such entries manually (with just 117,000 to look through) or have Word do it automatically?

That’s the power of the “Find What Expression” wildcard. In future articles, I’ll show you more uses for this wonderful tool, along with other Word wildcards.

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.

March 21, 2016

Lyonizing Word: But Which Styles?

by Jack Lyon

In my previous article, Lyonizing Word: Taming Styles in Microsoft Word, I explained how to make Microsoft Word display only the paragraph styles you want to use. But that raises an important question: Which paragraph styles do you want to use?

If you’re writing a simple business letter, the only style you may need is Word’s default of Normal. But if you’re editing a book, things immediately become much more complicated. Consider: What different kinds of text exist in a book? Let’s start with the title page; at a minimum, it includes the following elements:

  • Title
  • Author
  • Publisher

It may also include these:

  • Subtitle
  • Publication date

And that means you’ll probably need a paragraph style for each one of those. Why? Because the designer may want to format each element differently. Even if that ends up not being the case, you’ve at least allowed for the possibility. In addition, using a different style for each element makes it possible to use those elements as metadata, and that can be important in electronic publishing. Back in the late 1990s, I was involved in the production of an enormous electronic library. Most of the books were already styled with—that’s right—Title, Author, and Publisher, making it fairly easy to access those elements through a database and thus allow the user to sort books by title, author, and so on.

What styles will you need as you get into the book’s chapters? You might want to pull a couple of books off your shelves and see. You’ll probably find that you’ll need (at a minimum):

  • Chapter number
  • Chapter title
  • Body text

And as you get deeper into the book, you may need some of the following:

  • Block quotation
  • Poetry
  • Subheading
  • Subsubheading

Most books include a multitude of other elements, such as:

  • Dedication
  • Epigraph
  • Caption
  • Notes
  • Bibliography

And on and on and on.

Do you really need all of this detail? Yes, you do. Even if epigraphs and captions are going to look the same (e.g., both will use left-justified 10-point New Century Schoolbook), you as an editor, working in an editorial capacity, shouldn’t be thinking about how epigraphs and captions will look; you should be thinking about whether a specific bit of text is an epigraph or a caption and applying the metadata (a style) that marks it as such. Otherwise, the designer and typesetter won’t know for sure which text they need to format in a certain way. In addition, applying the proper metadata (styles) to epigraphs and captions makes them accessible and manipulable in various ways for later electronic publishing.

Can’t you just let the designer or typesetter take care of all this styling? No, you can’t. Deciding what text should be marked with which style is an editorial matter, not a design or typesetting one. Is this bit of text a subheading or a subsubheading? Should that bit of text be run in or pulled out as a block quotation? Is this line really an epigraph or just part of the body text? Is that line a chapter title, or should it be relegated to a subheading? All of these are editorial decisions; they have to do with what the text is and with what the text means.

Design decisions, on the other hand, have to do with how the text looks. The editor has styled this line as an epigraph. Should it be set in Comic Sans? (Horrors!) Should it be set in italics? Should it be a smaller point size than body text? Should it be centered?

So what styles do you really need? It depends on the book. And there’s no way to know without actually going through the book to find out. I tend to do this as I work, creating new styles as the need arises. Hey, that’s a poem! Guess I’ll need a poetry style (which I then create and apply).

And what should my poetry style look like? For editorial purposes, it doesn’t matter, as long as I can tell that the poetry style has been applied. For example, I might set up the style to be indented half an inch on both sides, with the text color set to blue. When the designer and typesetter bring the text into InDesign, they can redefine the style any way they like. But for now, I can tell that I’ve styled that text as poetry, which, for me as an editor, is all that matters.

In this article, I’ve assumed that you’re creating the styles you need to use, as that’s how I usually work. But for the most part, editors who work for publishers don’t need to do that. Publishers often have their own sets of styles that they require editors to use, and these styles are usually stored in a Word template. For example, you can download the Springer template and the Wiley template. Both templates are well worth looking at, just so you can get an idea of what publishers are looking for in the way of styled manuscripts. Wiley provides additional information in an online article “Applying Formatting Styles.”

You may also be interested in my Author Tools Template, which is a collection of styles that make it easy for authors (and editors) to produce properly styled manuscripts, which means that publishers can then use those manuscripts without having to restyle the text.

In addition, if you’re working with styles as I’ve explained in this article, you owe it to yourself to check out the Style Inserter in Rich Adin’s EditTools. This is a slick feature that overcomes the problems with styles that I discussed in my previous article (see Lyonizing Word: Taming Styles in Microsoft Word) and makes it easy to apply publisher styles to a manuscript.

\bodytext\It’s worth noting that some publishers don’t use styles at all. Instead, they require editors to mark up text with publisher-supplied codes like the one at the beginning of this paragraph. In that case, it’s important not to type the codes in by hand, as doing so can easily lead to errors. Instead, editors should use something like Code Inserter, which is included in EditTools.

In the 1980s, I worked on the Penta system, which used such codes extensively. During the 1990s, however, I switched to WordPerfect 6.0 and finally to Microsoft Word, and marking text with styles became a more intuitive way to work.

So what styles do I routinely use today? Here’s the minimal list, which I use in all of the books I publish at Waking Lion Press:

  • Half-Title
  • Title
  • Subtitle
  • Author
  • Publisher
  • Copyright
  • Dedication
  • Epigraph
  • Epigraph Source
  • Part
  • Chapter
  • Section
  • Subsection
  • Block quote
  • Poem
  • Poem Heading
  • Poem Source
  • Bibliography
  • Notes

How about you? What styles do you routinely use? And do you have any tips on how to use them? If so, I’d love to hear from you.

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.

March 18, 2016

Articles Worth Reading: Ransomware Strikes Again

Filed under: Articles Worth Reading,Computers and Software — americaneditor @ 5:33 am
Tags: , ,

The Ars Technica article, “Big-Name Sites Hit By Rash of Malicious Ads Spreading Crypto Ransomware,” is worth a few minutes of reading time. We have discussed ransomware previously (see, e.g., “Articles Worth Reading: More on Ransomware,” “Articles Worth Reading: Inside CryptoWall 2,” and “The Business of Editing: Playing It Safe“) and as I reported in an earlier essay, I was struck by ransomware, although I was able to fix the problem without paying a ransom.

This article addresses a problem I would not have expected — ransomware at big name websites. I encourage you to read the article and to develop a strategy for dealing with the growing problem of ransomware.

Big-Name Sites Hit By Rash of Malicious Ads Spreading Crypto Ransomware

We rely on our computers for our livelihood. Protecting ourselves is a worthwhile investment.

Richard Adin, An American Editor

February 29, 2016

Lyonizing Word: Taming Styles in Microsoft Word

by Jack Lyon

Microsoft Word includes a powerful feature for marking the various levels of a manuscript (such as headings, block quotations, poetry, and so on). That feature is styles, which are valuable for many reasons, including:

  • They make it possible to reformat a whole document simply by redefining styles or applying a different template using those styles.
  • They make it possible to find and replace only text using a certain style. For example, you might want to find source citations by searching for parentheses in text styled as block quotations.
  • They make it possible to generate a table of contents based on specified styles.

So styles are very useful. The problem is that Microsoft Word, in its usual “helpful” way, tries to manage which styles are available, in which document, and how those styles can be accessed. Finally growing tired of this nonsense, I decided to take the matter firmly in hand by writing this article.

My first gripe is that Word decides which styles to show in the Styles area of the Home ribbon, which decision seems to be based on nothing that makes any sense. Right now, it’s showing the following:

Quick Style Gallery

Quick Style Gallery

Of the styles available, I use Normal and Heading 1. But Strong? Subtle Emphasis? Intense Emphasis? Who makes this stuff up? Not an actual writer or editor, that’s for sure. So the first thing to do is get rid of the icons for the styles I never use:

  1. Right-click the icon (such as that for Strong).
  2. Click “Remove from Quick Style Gallery” (which, evidently is what the Styles area is called).
Remove from Quick Style Gallery

Remove from Quick Style Gallery

Now, the question is, when I restart Word or create a new document, does the Strong icon come back? Let’s find out. (Now restarting Word.)

Ha! It’s gone! But what happens if I create a new document? (Now creating a new document.)

Shoot, Strong is back again. So we can conclude that removing a style from the Quick Style Gallery applies only to the document in which we remove the style.

I could get rid of Strong and then save what I’ve done as a Quick Style Set:

Save as Quick Style Set

Save as Quick Style Set

But I’d like to get rid of Strong once and for all. How can I do that?

Well, I’ll start by showing Word’s task pane (by clicking the little arrow at the bottom right of the Styles area):

Word's task pane

Word’s task pane

Now I should be able to click the drop-down arrow next to Strong and delete it, right? Nope. Word won’t let me. How annoying!

Delete Strong

Delete Strong

Well, then, where does the Strong style live? In Word’s Normal.dotm template, of course. Can I get rid of it there? I open the folder where the template lives, which on my computer is here:

C:\Users\Jack\AppData\Roaming\Microsoft\Templates

Then I open the Normal.dotm template. Now can I delete the Strong style?

No, I can’t; same problem as before. Word really, really, really wants to keep its built-in styles — which is why they’re called “built-in,” I guess. So my only recourse is to (1) set how the style will be displayed and then (2) tell Word which styles to display. Here’s how:

  1. Open the Normal.dotm template, which is where your default styles are stored.
  2. Under Style Pane Options (the blue “Options” link at the bottom of the task pane), set “Styles to Show” as “Recommended.” Select “New documents based on this template.”
Show styles as recommended

Show styles as recommended

  1. Under Manage Styles (the third button at the bottom of the task pane), set all styles to “Hide” or “Hide until used” except those you want to show. (Even now, Word won’t let you hide everything.) Select “New documents based on this template.”
Hide Strong

Hide Strong

  1. Make any other adjustments you’d like, such as the order in which the styles will appear in the task pane.
  2. Save and close the Normal.dotm template.

After you’ve done that, every time you start Word or create a new document, you’ll get only the styles you want to see. I think. I hope. Maybe.

How about you? Do you have any helpful hints about how to tame Word’s styles? If so, I’d love to hear from you.

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.

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.

Next Page »

Blog at WordPress.com.

%d bloggers like this: