Showing vs. Telling Macro

by @CKMacLeod

9631208527_e38342509b_m

Most writers are familiar with the adage, show, don't tell. But sometimes it's tricky to determine when those telling instances have crept into your writing.

Editor Janice Hardy of Fiction University explains how telling happens and offers advice for how to turn telling into showing. She and Valerie Comer of To Write a Story suggest lists of words you should avoid to prevent instances of telling.

I've inserted some of Valerie Comer's and Janice Hardy's telling words into the macro script below so you can identify them in your own writing. I've also included some words of my own.

Loch Ness telling sample
TellingWords in action; writing sample by Carla Douglas, used with permission

Copy the TellingWords* macro, below, from Sub to End Sub and paste it into Word's Visual Basic Application (VBA). When you run the macro, it will hunt down and highlight those telling words so you can tell them, I mean, show them who's boss.


Sub TellingWords()
' Highlights telling words
'
'
' Written by Roger Mortis, revised by Subcortical, adapted by Jami Gold and tweaked by C.K. MacLeod; word list by Valerie Comer and Janice Hardy
'
Dim range As range
Dim i As Long
Dim TargetList
TargetList = Array("was", "were", "when", "as", "the sound of", "could see", "saw", "notice", "noticed", "noticing", "consider", "considered", "considering", "smell", "smelled", "heard", "felt", "tasted", "knew", "realize", "realized", "realizing", "think", "thought", "thinking", "believe", "believed", "believing", "wonder", "wondered", "wondering", "recognize", "recognized", "recognizing", "hope", "hoped", "hoping", "supposed", "pray", "prayed", "praying", "angrily")

For i = 0 To UBound(TargetList)

Set range = ActiveDocument.range
With range.Find
.Text = TargetList(i)
.Format = True
.MatchCase = False
.MatchWholeWord = True
.MatchWildcards = False
.MatchSoundsLike = False
.MatchAllWordForms = False
Do While .Execute(Forward:=True) = True
range.HighlightColorIndex = wdPink
Loop
End With
Next
End Sub


Note: You need to use judgement with the results of any macro. This macro will highlight the telling words, but only you can decide if it's an instance of telling.

To figure out what to do with the words the macro highlights, refer to Janice Hardy's excellent show vs. tell posts. Also, this macro is a work in progress. Are there words I should include? Omit? Let me know in the comments section below.

Not sure what a macro is? See this post for an explanation. See also the videos for adding a macro and running a macro in Microsoft Word 2010.

What do you do with the highlighted words this macro finds? See Carla Douglas' post at the Beyond Paper Editing blog for suggestions.

 Image by Pete

*Karen Woodward calls this macro the AddWords macro because you can add any list of words that you want the macro to find. The first version of this macro was written by Roger Mortis, revised by Subcortical, appropriated for writing by Karen Woodward, tweaked byJami Gold, and further tweaked by me, making it a true community effort.

A Self-Editing Toolkit

Toolkit

by C.K. MacLeod

Editors use a wide variety of tech tools to improve writing and to create a consistent reading experience for the reader. Below is a list of tools in many a professional editor's toolkit. Writers can use these tools, too.

Many of these tools will take of bit of time to learn and use, but the initial investment of time can pay dividends later. Other tools are quick to assimilate into a writing and self-editing workflow. I've marked those with an asterisk (*). Give these tools a try, and bring out your inner editor!

Microsoft Word

The current best tool for editing, mostly because it has a variety of robust built-in tools, and it can run useful editing macros and plug-ins (see below).

Word's Built-in Editing Tools

FileCleaner* (free trial)

Cleans up formatting mishaps such as extra spaces between paragraphs and sentences, changes two hyphens to em dashes, and much more, all with a click. Runs as a Word plug-in. This tool and other editing tools are created by Jack Lyon at the Editorium. Lyon is currently in the process of developing his tools for Mac users. Check his website for details.

Wiley Publishing offers a free clean-up tool* with some similar features to those found in FileCleaner.

PerfectIt*

A consistency checker that checks for typos that spell check won't catch, and helps you determine if you've made consistent style decisions (e.g. spelled a word the same way) throughout your document. For PCs only. The full version is a Word plug-in, and a free lite version, called Consistency Checker* by Intelligent Editing, is available as an Add-on through Google Docs.

EditTools (free trial)

Combines 25 macros into one customizable tool. Created by Rich Adin. Recommended by editor Ruth Thaler-Carter.

Phrase Express (free for personal use)

Corrects typos in all applications, and automatically keys in phrases that you tend to use a lot. It prevents you from keying in phrases and unwieldy terms again and again. I learned about this tool from editor Hilary Cadman.

Bibme (free)

Helps you build your reference list and saves you hours of time by styling your references correctly. This tool works best if you use it while writing your book.

Word 2010 also has a powerful reference-building feature. You can access it in the References tab, Citations & Bibliography area.

ReferenceChecker

Checks that references and citations match up—particularly helpful if you've written a nonfiction book for print. This tool helps you to sort out your references after you've written your book.

Writing Macros* (free)

A list of writing macros that we've been experimenting with at Beyond Paper. Run them in Microsoft Word. Do macros scare you? This free 20-minute macro course will get you using macros in no time.

CrossEyes*

A reveal codes-type tool that helps you see the formatting that lurks in a document’s background. This is particularly helpful for solving mysterious formatting problems that arise while formatting an ebook.

Computer Tools for Editors (free)

An instructional book with a variety of macros designed to handle all sorts of editing challenges. FRedit is one worth trying. Created by Paul Beverley.

Copyscape

A plagiarism checker. Your content is your own, right? Run it through this tool to see if you've wandered too close to the line.

Adobe Reader XI

A PDF mark-up tool for proofreading a print PDF before it's printed. Some editors use Adobe Acrobat Pro, but I've found that Adobe Reader XI and PDF XChangeViewer (both free) do the trick. Adobe XI is available as a tablet app, and iAnnotate is also useful for proofreading on a tablet. See this post for PDF mark-up in action.

Proofreading Stamps (free)

Used with with Adobe Reader XI or PDF XChange Viewer. Proofreader Louise Harnby has designed proofreading stamps for British English and Wiley Publishing offers a free set of American English stamps.

Merriam-Webster Dictionary online* (free and subscription)

To check spelling, definitions, and word breaks. Many editors use the online version, but the tablet app's voice look-up makes it much faster to look up a word. The app is available for Android and iPad.

Link Checker for Microsoft Word (free trial)

Helps you to efficiently check the validity of ebook hyperlinks. You can also export a list of all the links in your book to a spreadsheet.

Editor Ken Endicott has a designed a series of free Microsoft Word utilities, one of which will help you to check the validity of your links.

Editors, do you have a favourite tool that I'm missing? Feel free to add it to the comments below.

Image by zzpza

Hunt Down Adverbs with a Macro

by C.K. MacLeod

...the road to hell is paved with adverbs and I will shout it from the rooftops.

~Steven King

Adverb

Do you use -ly words in your writing? Do you use them with the dialogue tags he said and she said?

Example: "Who do you think you are?" she said arrogantly.

According to author Steven King, using adverbs in your writing, particularly with dialogue tags, can be a problem.

You can hunt down -ly adverbs with a macro. Karen Woodward has good multipurpose -ly macro, or you can insert your own list of -ly words in the macro script below (I've gotten you started). The Reading Teacher's Book of Lists, by Edward Bernard Fry et al. has a fabulous list of adverbs commonly used with dialogue tags.

Copy the macro from Sub to End Sub and paste it into Word's Visual Basic Application (VBA). Word will highlight all of the adverbs in bright green.


Sub lyWords()
'
' Highlights -ly words used in tags
'
' Written by Roger Mortis, revised by Subcortical, adapted by Jami Gold and tweaked by C.K. MacLeod
'
Dim range As range
Dim i As Long
Dim TargetList
TargetList = Array( "angrily", "cautiously", "happily", "sadly",  "unhappily")

For i = 0 To UBound(TargetList)

Set range = ActiveDocument.range
With range.Find
.Text = TargetList(i)
.Format = True
.MatchCase = False
.MatchWholeWord = True
.MatchWildcards = False
.MatchSoundsLike = False
.MatchAllWordForms = False
Do While .Execute(Forward:=True) = True
range.HighlightColorIndex = wdBrightGreen
Loop
End With
Next
End Sub


Remember to use judgement with the results of any macro. This macro will highlight -ly words, but only you can decide if each word is helping or hindering your writing.

Not sure what a macro is? See this post for an explanation. See also the videos for adding a macro and running a macro in Microsoft Word 2010.

What do you do with the highlighted words this macro finds? See Carla Douglas' post at the Beyond Paper Editing blog for suggestions.

Image by Quinn Dombrowski