about summary refs log tree commit diff stats
path: root/src
diff options
context:
space:
mode:
authorCase Duckworth2015-03-18 11:41:43 -0700
committerCase Duckworth2015-03-18 11:41:43 -0700
commit544d6f5e304453897f5e28b9b92daf8259eeac84 (patch)
tree0af9a341c38253ec4f23e14f625f7da62a41e61a /src
parentAdd README.txt in src/ (diff)
downloadautocento-544d6f5e304453897f5e28b9b92daf8259eeac84.tar.gz
autocento-544d6f5e304453897f5e28b9b92daf8259eeac84.zip
Add README (for real this time) & update with TODOs
Diffstat (limited to 'src')
-rw-r--r--src/README.txt101
1 files changed, 101 insertions, 0 deletions
diff --git a/src/README.txt b/src/README.txt new file mode 100644 index 0000000..f1da4a7 --- /dev/null +++ b/src/README.txt
@@ -0,0 +1,101 @@
1---
2title: Autocento of the breakfast table
3subtitle: about this site
4genre: prose
5
6epigraph:
7 content: by Case Duckworth
8
9project:
10 title: Autocento of the breakfast table
11 css: autocento
12...
13
14Introduction
15------------
16
17_Autocento [of the breakfast table][]_ is a hypertextual exploration of the workings of revision across time.
18Somebody^[citation needed]^ once said that every relationship we have is part of the same relationship; the same is true of authorship.
19As we write, as we continue writing across our lives, patterns thread themselves through our work: images, certain phrases, preoccupations.
20This project attempts to make those threads more apparent, using the technology of hypertext.
21
22I'm also an MFA candidate at [Northern Arizona University][NAU].
23This is my thesis.
24
25Process
26-------
27
28In compiling the works that make up this text, I've pulled from a few different projects:
29
30* [Elegies for alternate selves](and.html)
31* [The book of Hezekiah](prelude.html)
32* [Stark raving](table_contents.html)
33* [Buildings out of air](art.html)
34
35as well as added new poems, written quite recently.
36As I've compiled them into this project, I've linked them together based on common images or language, moving back and forth through time.
37This should give the reader a fair idea of what my head looks like on the inside.
38
39Technology
40----------
41
42Because this project lives online, I've used a fair amount of technology to get it there.
43First, I converted all the articles[^1] present into plain text files, which are viewable [here][text].
44Then, I used John McFarlane's venerable document preparation system [pandoc][], along with a short [script][compile.lua], to compile the text sources to HTML using [this template][].
45The compiled HTML is what you're reading now.[^2]
46
47To host the project, I'm using [Github][], an online code-collaboration tool with the version control system [git][] under the hood.
48This enables me (and you, dear Reader!) to explore the path of revision even more, from beginning to end, based on my commits to the repository.
49You can view the repository and its changes and files at [my Github profile][].[^3]
50
51Using this site
52---------------
53
54All of the articles on this site are linked together hypertextually, that is, like a webpage.
55This means that all you need to do to explore the creative threads linking these articles together is to start clicking links.
56However, if you find you're looping around to a lot of the same articles, you can head back to the [index][] and click through the titles in order---that poem contains the titles of all the other poems in this project.
57
58Alternatively, you can click the lozenge (◊) at the bottom of each page.
59It'll take you to a random article in the project, thanks to [this javascript][].
60
61If you want to experience the earlier projects in something resembling the original orders, previous and next links are provided at the bottom of each page, next to the lozenge.
62Sometimes, there are more than one of each of these---they represent other work I've done with hypertextuality.
63
64Things still to do
65------------------
66
67_Autocento of the breakfast table_ is a work in progress.
68The first draft is completed, but some revision and aesthetic work remains to be done for me to consider it fully "[published][]"
69(what does this word mean in 2015?).
70You can see the full list of to-dos by visiting the [issues page][issues] of the Github site.
71
72Contact me
73----------
74
75If you'd like to contact me about the state of this work or my writing in general, you can email me at <case@autocento.me>.
76
77<!-- links & footnotes -->
78[of the breakfast table]: http://www.ibiblio.org/eldritch/owh/abt.html
79
80[text]: src/index.html
81
82[pandoc]: http://johnmacfarlane.net/pandoc/
83[compile.lua]: https://github.com/duckwork/autocento/blob/gh-pages/compile.lua
84[this template]: https://github.com/duckwork/autocento/blob/gh-pages/.template.html
85[Github]: https://github.com/
86[git]: http://www.git-scm.com/
87[my Github profile]: https://github.com/duckwork/autocento
88
89[index]: index.html
90[this javascript]: https://github.com/duckwork/autocento/blob/gh-pages/js/lozenge.js
91
92[published]: published.html
93[issues]: https://github.com/duckwork/autocento/issues
94
95[^1]: I've decided to use the word _article_ instead of _poem_, because not all of the texts included are poems; and instead of _piece_, because _piece_ is vague and, to my mind, pretentious.
96 I'm aware that the true [etymology](http://www.etymonline.com/index.php?search=article) of _article_ does not reflect my use of it, namely "a little chunk of art", a la the (personal folk) derivation of _icicle_, _treicle_, etc.
97
98[^2]: The great thing about `pandoc` is that it can compile to, and convert between, about fifty formats or so.
99 This means that if, in the future, I choose to convert this project to a printable form (for example PDF, ODT, or even DOCX), I'll be able to with a fairly small amount of work.
100
101[^3]: For more information on the technological aspect of this project, see the [README.md](https://github.com/duckwork/autocento/blob/gh-pages/README.md) file at the root of the github repo.