From 417eddb940ec0b364a11d459e27d5ae05d2c7d11 Mon Sep 17 00:00:00 2001 From: Case Duckworth Date: Sat, 28 Mar 2015 10:50:24 -0700 Subject: Add Abstract and Process Narrative --- process.html | 69 +++++++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 45 insertions(+), 24 deletions(-) (limited to 'process.html') diff --git a/process.html b/process.html index 67f8046..2246863 100644 --- a/process.html +++ b/process.html @@ -21,7 +21,7 @@ - +
@@ -30,38 +30,60 @@

process narrative

- +
- +
-
-

Outline

-
    -
  • Hi. My name is Case Duckworth. This is my thesis.
  • -
+
+

Hi. My name is Case Duckworth. This is my thesis.

+

Autocento of the breakfast table is an inter/hypertextual exploration of the workings of inspiration, revision, and obsession. I’ve compiled this work over multiple years, and recently linked it all together to form a (hopefully) more cohesive whole. To make this easier than collating everything by hand, I’ve relied on a process that leverages open-source technologies to publish my work onto a web platform.

Process steps

  1. Write poems.
  2. -
  3. Convert to Markdown – generally easy.
  4. -
  5. Compile to HTML with Pandoc.
  6. -
  7. Style the pages with CSS.
  8. -
  9. Use Github to put them online. +
  10. Convert to Markdown. +
      +
    • Markdown, originally by John Gruber, is a lightweight markup language that allows me to focus on the content of my writing, knowing that I can work on the presentation later.
    • +
    • The original markdown.pl program is buggy and inconsistent with how it applies styles to markup. It also only works to convert text to HTML.
    • +
    • Because of these limitations, I’ve used John MacFarlane’s extended Markdown syntax, which lets me write richer documents and programmatically compile my work into multiple formats.
    • +
  11. +
  12. Compile to HTML with Pandoc.
      -
    • git has been used throughout to keep track of changes.
    • -
    • It’s a Version Control System – usually used for code but adapted for creative writing.
    • +
    • At first, I used this code in the shell to generate my HTML:

      +
      for file in *.txt; do
      +    pandoc "$file" -f markdown -t html5 \
      +    --template=template.html -o "${file%txt}html"
      +done
      + but this proved tedious with time.
    • +
    • After a lot of experimenting with different scripting languages, I finally realized that GNU make would fit this task perfectly.
    • +
    • You can see my makefile here—it’s kind of a mess, but it does the job. See below for a more detailed explanation of the makefile.
  13. -
  14. Write Makefile for ease-of-compilation. +
  15. Style the pages with CSS.
      -
    • A makefile is a collection of instructions to make that tells it how to compile a set of files.
    • -
    • It’s made the other parts of this much easier.
    • +
    • I use a pretty basic style for Autocento. You can see my stylesheet here.
    • +
  16. +
  17. Use Github to put them online. +
      +
    • Github uses git under the hood—a Version Control System developed for keeping track of large code projects.
    • +
    • My workflow with git looks like this: +
        +
      • Change files in the project directory—revise a poem, change the makefile, add a style, etc.
      • +
      • (If necessary, re-compile with make.)
      • +
      • git status tells me which files have changed, which have been added, and if any have been deleted.
      • +
      • git add -A adds all the changes to the staging area, or I can add individual files, depending on what I want to commit.
      • +
      • git commit -m "[message]" commits the changes to git. This means they’re “saved”—if I do something I want to revert, I can git revert back to a commit and start again.
      • +
      • git push pushes the changes to the remote repository—in this case, the Github repo that serves http://autocento.me.
      • +
      • Lather, rinse, repeat.
      • +
    • +
  18. +
  19. Write Makefile to extend build capabilities. +
  20. -
  21. Write Hapax legomenon compiler.
  22. -
  23. Write compiler for backlinks.
  24. -
  25. (TODO) write compiler for Index of first lines and common titles.
@@ -69,14 +91,13 @@
  • I can compile these poems into (almost) any format: pandoc supports a lot.
  • Once I complete the above process once, I can focus on revising my poems.
  • -
  • These poems are online for anyone to see and work off of.
  • -
  • Something something intertextuality.
  • +
  • These poems are online for anyone to see and use for their own work.
- + -- cgit 1.4.1-21-gabe81