about summary refs log tree commit diff stats
path: root/process.txt
diff options
context:
space:
mode:
authorCase Duckworth2015-03-28 09:42:01 -0700
committerCase Duckworth2015-03-28 09:42:01 -0700
commitfb8cc7d92a20610776d9f6e0453d09cebed0bc3a (patch)
treed47d5ccc7bf1e9d44e2405b6a2c8a6f9d85bd8f2 /process.txt
parentFix #5: Verse typesetting (diff)
downloadautocento-fb8cc7d92a20610776d9f6e0453d09cebed0bc3a.tar.gz
autocento-fb8cc7d92a20610776d9f6e0453d09cebed0bc3a.zip
Add backlinks pages (fixes #16).
Diffstat (limited to 'process.txt')
-rw-r--r--process.txt62
1 files changed, 62 insertions, 0 deletions
diff --git a/process.txt b/process.txt new file mode 100644 index 0000000..d048558 --- /dev/null +++ b/process.txt
@@ -0,0 +1,62 @@
1---
2title: Autocento of the breakfast table
3subtitle: process narrative
4id: process
5genre: prose
6
7project:
8 title: About Autocento
9 class: meta
10...
11
12Hi. My name is Case Duckworth. This is my thesis.
13---------------------------------------------------
14
15_Autocento of the breakfast table_ is an inter/hypertextual exploration of the workings of inspiration, revision, and obsession.
16I've compiled this work over multiple years, and recently linked it all together to form a (hopefully) more cohesive whole.
17To 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.
18
19Process steps
20-------------
21
221. Write poems.
232. Convert to Markdown -- generally easy.
24 - 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.
25 - 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.
26 - 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.
273. Compile to HTML with Pandoc.
28 - At first, I used this code in the shell to generate my HTML:
29 ```bash
30 for file in *.txt; do
31 pandoc "$file" -f markdown -t html5 --template=template.html -o "${file%txt}html"
32 done
33 ```
34 but this proved tedious with time.
35 - After a lot of experimenting with different scripting languages, I finally realized that [`GNU make`][] would fit this task perfectly.
36 - You can see my makefile [here][]
37
384. Style the pages with CSS.
394. Use Github to put them online.
40 - `git` has been used throughout to keep track of changes.
41 - It's a Version Control System -- usually used for code but adapted
42 for creative writing.
435. Write Makefile for ease-of-compilation.
44 - A `makefile` is a collection of instructions to `make` that tells it how
45 to compile a set of files.
46 - It's made the other parts of this much easier.
476. Write _Hapax legomenon_ compiler.
487. Write compiler for backlinks.
498. (TODO) write compiler for Index of first lines and common titles.
50
51The beauty of this system
52-------------------------
53
54- I can compile these poems into (almost) any format: `pandoc` supports a lot.
55- Once I complete the above process once, I can focus on revising my poems.
56- These poems are online for anyone to see and work off of.
57- Something something intertextuality.
58
59[John Gruber]: http://daringfireball.net/projects/markdown/
60[extended Markdown syntax]: http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown
61[`GNU make`]: https://www.gnu.org/software/make/manual/make.html
62[here]: