B1C13

Amateurs talk tactics; professionals talk logistics.

This is how my chapters go from a Google doc to a webpage you can read.

First, I spend some a lot of time revising my chapter in a Google doc. In addition to writing good words and good plot points, I also take the text and insert square brackets everywhere I want any special effects to happen. Double brackets indicate dialogue like so

[[Road]] “Lisa, I was wondering if you had eaten yet.”

Single brackets indicate every other effect like so

It was his [drumbeat] duty.

Second, I download the chapter as a text file (.txt) from Google docs and open it in VS Code. I convert the square brackets to HTML tags using the following steps that I have written down for myself in a README.md file:

  1. Replace \n\n\n with \n</p>\n<p>\n\t, then add a beginning and ending paragraph tag
    1. The code here simply means that I replace all the line breaks with paragraph tags, which are the HTML version of line breaks
  2. Replace _ with <i> or </i>
    1. This italicizes the text that needs italicizing
  3. Replace … with <span className="ellipsis">…</span>
    1. This adds extra space after each ellipsis, in line with the design philosophy I talk about in the previous post where I want to make punctuation clearer wherever possible
  4. Dialogue replacements
    1. Replace \[\[(.*?)\]\] with <Dialogue name="$1">
      1. This replace double square brackets with a HTML Dialogue tag, which is a custom tag I've created for use in this book. It puts things in speech bubbles.
    2. Add </Dialogue>
      1. This closes the Dialogue tags I added in the previous step
    3. Do searches for “ and fix those
      1. This removes any stray quotation marks that might have been left in the text accidentally
  5. Do searches for [ and implement those
    1. This means I should go ahead and implement all the non-dialogue effects now. These effects change a lot from chapter-to-chapter, so I don't have any quick tricks for implementing them.
    2. My general philosophy is "done is better than perfect." I'm fine with writing ugly, brittle code that works.

When I was doing my most intense round of revisions, I aimed to convert one chapter to HTML each week. Each night, I aimed to work for at least an hour. The work was split as follows:

  1. Monday: Convert chapter n-1 to HTML
  2. Tuesday: Finish HTML conversion, write BTS post for chapter n-1
  3. Wednesday: Address editor's comments on chapter n-2
  4. Thursday: Revise chapter n
  5. Friday: Revise chapter n
  6. Saturday: Rest day
  7. Sunday: Revise chapter n, send to editor

Unfortunately, the revisions never end. Since the above phase ended, I've done ~3 more rounds of revisions, and counting.