Writer’s Diary: Structur.py

Today, I worked on coding a section for the introduction to Makeshift. It was about 3,000 words, very disorganized, repetitive, and in need of cutting and more focus.

I followed the process John McPhee described in Draft No. 4:

Structur exploded my notes. It read the codes by which each note was given a destination or destinations (including the dustbin). It created and named as many new Kedit files as there were codes, and, of course, it preserved intact the original set. In my first I.B.M. computer, Structur took about four minutes to sift and separate fifty thousand words. My first computer cost five thousand dollars. I called it a five-thousand-dollar pair of scissors (John McPhee, Draft No. 4, “Chapter Structure”).

I wrote a script six months ago that extracts coded text from a folder of text files.

I’ve been using the script for months now. It splits a text file into small chunks, based on codes I added. It’s almost a manual process—not too much thought. I coded 3,000 words, split them into 10 files, put them in order, and started revising them. Much easier.

When I ran out of steam, I posted structur.py to GitHub. It’s the first script I’ve ever posted publicly. Perhaps someone will find it useful.

Structur.py

Structur is a simple, Python-based command-line tool to help extract and organize coded text from research notes.

I’ve been using it for a year now, from the Finder. It’s useful to find the structure of longer pieces of text.

I was inspired by John McPhee’s writing process, which he describes in Draft No. 4.

Structur exploded my notes. It read the codes by which each note was given a destination or destinations (including the dustbin). It created and named as many new Kedit files as there were codes, and, of course, it preserved intact the original set. In my first I.B.M. computer, Structur took about four minutes to sift and separate fifty thousand words. My first computer cost five thousand dollars. I called it a five-thousand-dollar pair of scissors.

Structur is my take on what McPhee describes.

It is available on GitHub.

Cite as:

Tubb, Daniel. Structur.py. GitHub, 2024. https://github.com/dtubb/structur.

Writer’s Diary #32 – Creating Structure/Finding Structure

Block. It puts some writers down for months. It puts some writers down for life. A not always brief or minor form of it mutes all writers from the outset of every day.

—Draft No. 4, Replacing the words in boxes, John McPhee, April 29, 2013.

John McPhee has an article in The New Yorker about his writing process that became part of his book [Draft No. 4] (https://www.amazon.com/Draft-No-4-Writing-Process/dp/0374142742). McPhee tells a story of lying on a picnic table with all his notes, research, interviews, and everything else in manila envelopes, but he’s distraught because he doesn’t know the structure. He says this is no way to write. I agree with him, and yet structure is the hard part.

Good structure is easy to describe, after the fact. But, how to find it is much harder. I am working on a chapter. I have all the material. The question is how to put it together in a way that makes sense, that is compelling, that draws the reader in. In short, the challenge now is to find a structure.

I can think of two approaches.

One is where the order emerges by fiat. Through a decision I make to structure it in a certain way, in the form of a draft, a sketch, a story arc, or something else.

The second, a second in which the order emerges as a sculptor might find the shape of a piece of stone or wood. There is a vague idea, but the actual structure emerges through the iterative application of the art of sculpture.

My process is a matter of both, with an emphasis on the latter. I find form, by sculpting into that form. However, over the weekend, I did a lot of thinking, trying to work out the structure, which was a mistake.

Instead, I’ve prepared the material, and now the task is iterate, make decisions and let the structure emerge.

This week’s task: do the work, carve the text, find its structure, organically. I wish it were easier, but whenever I try to shortcut it by thinking too hard, I get blocked.