See also Clipper
- A macro that lets you select material in the current document (or any
open WP document) and automatically clip (copy or move) it to a
separate temporary document.
Splitter.wcm (v1.01) will save specified portions of the current on-screen document
into several separate and sequentially numbered files on disk, such as -
The Splitter macro might be particularly useful in preparing to create subdocuments
from a single file in preparation for using WordPerfect's
Master/Subdocument feature. [Later, the subdocuments can be
automatically added to the Master with a macro such as the MakeSubs macro in the Library.]
The current document is not affected since the macro simply copies
selections, delimited by your specified separators, and saves the
selections in new, sequentially numbered files in your specified
(Note: If the numbered filename already exists in that storage folder
it will be replaced. An optional message will pop up to alert the user
to this situation, but it is better to move or rename these files
before using the macro again.)
The position of the file's number — before or after the root filename —
can be specified, as well as its padded number size, beginning number,
etc. (see below).
If you just need to clip parts of any open
document into a separate on-screen document, see Clipper.
Download and extract the macro from the ZIP file (◄- left sidebar),
and place it in your default or supplemental macro folder. (See the
"Downloading..." link in the left sidebar if you need help.)
Make a copy of your original
document as a backup. Then -
Then, modify the macro. (A WordPerfect macro can be opened and saved like any other
document.) Normally, the next steps are a one-time procedure and is easy to do. [Tip: You can make multiple copies of this macro, named differently, where each is set up for a different task.]
[1.] Insert temporary "separators" into the current document.
Place a WordPerfect symbol (with
Ctrl+w) or any special character string not otherwise used in the
current document (e.g., @#$%) at the end of every
section you wish to save as a separate new file.
Be sure to include one separator at the very end
of the current document if you wish the last section of the document to
also be included as a file in the storage folder (described in step 2).
Careful placement of the separators is recommended.
You probably do not want to split material that belongs in the same new
file, so be aware of anything that connects one item to another further
down in the current document, such as footnotes, endnotes,
cross-references, headers, footers and watermarks.
Even with close attention to where the current document should be
split, you might still need to edit the split documents to reestablish
the placement and function of these "spanning" items.
are started on a given page and only display on subsequent pages until
stopped or replaced. Splitting a document containing a preexisting
header into another document qualifies as "stopping" the header in that
new document. Solution: Just copy the original header's contents into a
new header in the new, split file.
☐ The macro
will start from the top of the document and select everything up to —
but not including — the first separator. It will then save that
selection to a new, numbered file on disk. It then skips over that
separator and repeats the process, thereby splitting the current file
into the desired sections, each in its own new file on disk.
☐ Here, the default separator expected by the macro is a single
heart symbol (i.e., which is symbol 5,0 using Ctrl+w), but you can use
any other symbol or symbols. (See also step 5 below.)
☐ The current file is not affected by the splitting process. But
note that it will still contain the separators you inserted. These can
be removed with Edit, Undo or by simply closing the original without
saving it — or if it's a copy of the original, the copy can be
[2.] Create a special storage folder on
your computer to contain the new files.
Windows File Explorer (or similar file manager) to create the new folder in any convenient
The folder can be named anything but generally you will want to use
a fairly short path to it and a short folder name.
[3.] Enter the full path to that storage
folder at the top of the macro's redlined
User Modification Area. Be sure to include the drive letter.
example, the default used by the author is -
You can also change the root portion
of the filenames — i.e., the part without the incrementing number — and/or
filename extension (.wpd is the default) to use for the new files to be
stored in that folder. (See the User Modification Area.)
[4.] Specify the File Type for the split files in the User Modification Area. You can choose one of four types to use for the split files:
• WordPerfect (.WPD) (<= the default)
• Rich Text Format (.RTF)
• ANSI Windows Text (.TXT)
• ANSI (Windows) Generic Word Processor (.TXT)
You should always test the output of these choices by opening the resulting split files in their intended program (e.g., WordPerfect, WordPad, etc.).
☐ The WordPerfect file type of split files should be identical
(or nearly so) to the original document's selected segments. Some
manual editing of split files may be required in complex documents
(e.g., if a footnote/endnote/cross-reference calling number is in one
split file and the note/reference is in a subsequent split file).
☐ The Rich Text Format (see Wikipedia for more) file type retains
text attributes (e.g., bold), graphics, hypertext links, tabs, indents,
word wrap, etc. However, it strips out WordPerfect styles (e.g.,
Heading styles) and the text to which the style was applied when the
split file is opened in another program (e.g., WordPad). Hence, some
editing of these split files may be required.
☐ The ANSI Windows Text type is what you might expect in Windows
NotePad and similar plain text editor: It strips out almost all
WordPerfect formatting (replaces tabs and indents with spaces), and
there's no word wrap.
☐ The ANSI (Windows) Generic Word Processor type also strips out
WordPerfect formatting but retains Tab codes, converts Indents to Tab
codes, and retains WordPerfect's end-of-line SRt codes to preserve word
In many instances
this choice produces a preferred "plain text" output since its content
is often closest to the content (minus most formatting) in the original
[5.] Enter the same symbol(s) or
character(s) (discussed in step 1 above) in the User Modification Area — see the vSplitter
The macro uses the value stored in this variable to
search for the same symbols or characters in the document itself.
Try to use a single symbol or character as the
separator — although the macro should compensate for multiple
If you use multiple characters, you need to be sure
that the full string of symbols exists at each separation point in the document
(as separators) and in the macro itself (in vSplitter).
[6.] Set any other macro options in the User Modification Area.
[7.] Save your changes to the macro with Save & Compile on the macro toolbar (image) or with File, Save.
Play the macro on any open file that has the appropriate separators (step 1
above) in it.
Tip: Once the separate files are created they can be used as Subdocuments in a Master document (See MakeSubs in the Library.)
Notes, cautions, and tips
☐ The macro starts from the very top of the
document, and creates newly numbered files in sequence.
Reminder: The new files
should then be edited to make sure they contain the proper text,
formatting are sometimes the result of
placing the separator in the wrong location in the original document,
or because of changes in formatting above the separator location(s)
that carry (or fail to carry) forward into the new, split document. Use Reveal Codes to relocate any such separators.
Methods exist — such as using WordPerfect custom styles at the top of each document — to ensure formatting is consistent across several related documents. [See (e.g.) the tips on the MakeSubs page — particularly Charles Rossiter's tip here, which also applies to documents split (copied) from a source document.]
☐ By design, the macro will replace any
existing files of the same name in the new folder.
If you want to preserve earlier versions of those files,
you should relocate them before playing this macro (or at least rename
the next batch of files using the vName variable in the User
Modification Area). By default, a "Yes/No" warning is given; this
message can be enabled or disabled in the User Modification Area.
☐ There is another Messagebox() command that
can pop up a message at each "splitting" point. It may be useful for
new users that are not used to the operation of this macro. You can
enable or disable this message with a variable in the User Modification