When I edit a manuscript, I always edit in Microsoft Word. I do so because I have all sorts of tools available to me that make the editing process go more quickly and accurately, and thus more profitably. I edit in Word even if my client will have the manuscript typeset in Adobe InDesign because Word is better designed for editing than is InDesign.
Consequently, my work requires that I either insert codes in the manuscript that tell the typesetter/compositor how material should be designed (typeset) or I apply styles for the same purpose. Inserting codes can be a time-consuming process. Each element of a manuscript has to be coded and each code has to be typed precisely. For example, the code for a B-level head that immediately follows an A-level head might be <H2_after_H1> and each time it is required, it needs to be typed correctly. In addition, I am often required to properly capitalize the head. All of this information is contained in the design I am provided.
Some editors get lucky and do not have to both code (style) and edit a manuscript, but most editors I speak with do have to do both. The question is how can I make this a quick-and-easy process so that it doesn’t dramatically affect my effective hourly rate (EHR) and my profit.
The answer is EditTools’ Code Inserter and Style Inserter macros. They work similarly, except that Style Inserter applies styles from a template and Code Inserter types the codes into the manuscript. (A description of how Style Inserter works can be found at the EditTools website.)
Code Inserter is found on the EditTools Toolbar. It consists of two parts: the Code Inserter macro (#1) and the Code Inserter Manager (#2). (Click on an image to enlarge it for easier viewing.)
When I receive a project, I receive a design that tells me how to various elements of the manuscript are to be coded. For example:
Each of the numbered items in the above image show an element and the code to be applied to the element as well as the capitalization for the element.
The first thing I do is make use of the Manager for Code Inserter. It is through the Manager that I can create the Code Inserter macro.
The above image shows a sample code inserter file. I can either create a new file or open an existing file (#1). Because many books use either the same or a very similar design, I can create a “template” file that I can open and then just make minor modifications to the codes. Also, because I can save these files, when it comes time to do the next edition, I am ready to go if the design is the same or similar. If I choose to create a new file, the Manager opens but is empty.
In the design above, note that the A-level head is all capitals and is coded H1. I set the code inside angle brackets as <H1> to set the code apart from what might appear in the text. I type a name for the code in the Name (#2) field, which name appears in the main field (#3). I could name code anything I want. A good example is – Text No Indent, which appears at the very top of the main field (#3). How I name a code is important when we run the Code Inserter macro. In the Code field (#4), I enter the code exactly as I want it to appear in the manuscript. In this case, I typed <H1>, which appears in the main field (#5).
I also can tell the macro where I want the code to appear when typed in the manuscript (#6): at the beginning of the line (At Start), at the cursor’s location (At Cursor), or at the end of the line (At End). This instruction is reflected in the main field (#7). But also noteworthy are the other options listed below #6, particularly Include End Code. If I were to check this box, after inserting the beginning code, the macro would ask me to move to the location for the end code, where it would automatically insert the proper end code.
At the same time that the macro inserts the code in the manuscript, it can also do some formatting. The formatting options are listed at #8 and appear in the main field at #9. Note that at the bottom of the main field, the H3 and the H3 after H2 codes are formatted italic (per client’s instructions). The other option is to set the head casing (#10 and 11). This part of the macro applies the information contained in Casing Manager found under the Casing menu on the Ribbon.
The final steps are to Add or Update the entry (#12) and to Save or Save & Close (#14) the Manager file. With the Setup Hotkey (#13), I can assign a hotkey to the Code Inserter macro (not to the Manager). That is handy if you prefer to have the macro open and close as needed rather than remain open while you work.
Once I have finished setting up the Code Inserter macro’s codes, it is time to turn to the manuscript. Once I have setup the coding in the manager, unless I need to make changes, I no longer will access the Manager, just the macro. The manuscript is code free, waiting for me to change it.
Some editors like to precode a manuscript, that is, code it before doing any editing; some like to code as they edit. I am in the code-as-they-edit group. I find it easier to determine what an element is based on what I have edited. For example, in the manuscript above, is the head an A-level head or a B-level head? I know from having edited the preceding material that it is an A-level head.
The Code Inserter macro presents a dialog that reflects all of the names you have assigned the various codes in alphabetical order. Note the location of – Text No Indent (#2) in the dialog below.
Code Inserter gives you the option of keeping the dialog open while you edit (#1). It is the default; however, if you uncheck the option, that will become the default for the next time you open the macro. Unchecking the keep open option means each time you need to enter a code, you need to open the dialog, either by clicking on Code Inserter in the EditTools Ribbon (see #1 in the Ribbon image at the beginning of this essay) or by having assigned the macro a hotkey (see #13 in the Code Inserter Manager above). Because I use multiple monitors, I keep the dialog open but on the monitor that does not have the manuscript displayed.
With the Code Inserter macro, inserting code and applying the formatting options is easy: just click on the checkbox next to the name of the code (#2 and 3). As the below image shows (arrows), the correct codes are inserted and the head has been capitalized, each done with a single click of the mouse.
If you work on long documents and need to apply codes and format according to a design, using Code Inserter both speeds the process significantly and increases accuracy — no more mistyping, retyping, or forgetting to apply a format. Style Inserter is just as easy as Code Inserter to use. Its basic operation is the same as Code Inserter and its Manager nearly a duplicate.
Regardless of whether you code or style, every second you save in the process adds more profitability. As I have emphasized in previous essays, editing is a business. Just as our clients are interested in reducing their editorial costs, we need to be interested in increasing our profitability by being more efficient and accurate. The macros in EditTools are designed to do just that — increase profitability and accuracy.
Richard Adin, An American Editor
Related An American Editor essays are:
- The Business of Editing: Correcting “Errors”
- The Business of Editing: Journals, References, & Dollars
- The Business of Editing: Making Search & Replace Efficient & Profitable
Looking for a Deal?
You can buy EditTools in a package with PerfectIt and Editor’s Toolkit 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.