From 544d6f5e304453897f5e28b9b92daf8259eeac84 Mon Sep 17 00:00:00 2001 From: Case Duckworth Date: Wed, 18 Mar 2015 11:41:43 -0700 Subject: Add README (for real this time) & update with TODOs --- src/README.txt | 101 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 src/README.txt (limited to 'src') 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 @@ +--- +title: Autocento of the breakfast table +subtitle: about this site +genre: prose + +epigraph: + content: by Case Duckworth + +project: + title: Autocento of the breakfast table + css: autocento +... + +Introduction +------------ + +_Autocento [of the breakfast table][]_ is a hypertextual exploration of the workings of revision across time. +Somebody^[citation needed]^ once said that every relationship we have is part of the same relationship; the same is true of authorship. +As we write, as we continue writing across our lives, patterns thread themselves through our work: images, certain phrases, preoccupations. +This project attempts to make those threads more apparent, using the technology of hypertext. + +I'm also an MFA candidate at [Northern Arizona University][NAU]. +This is my thesis. + +Process +------- + +In compiling the works that make up this text, I've pulled from a few different projects: + +* [Elegies for alternate selves](and.html) +* [The book of Hezekiah](prelude.html) +* [Stark raving](table_contents.html) +* [Buildings out of air](art.html) + +as well as added new poems, written quite recently. +As I've compiled them into this project, I've linked them together based on common images or language, moving back and forth through time. +This should give the reader a fair idea of what my head looks like on the inside. + +Technology +---------- + +Because this project lives online, I've used a fair amount of technology to get it there. +First, I converted all the articles[^1] present into plain text files, which are viewable [here][text]. +Then, 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][]. +The compiled HTML is what you're reading now.[^2] + +To host the project, I'm using [Github][], an online code-collaboration tool with the version control system [git][] under the hood. +This 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. +You can view the repository and its changes and files at [my Github profile][].[^3] + +Using this site +--------------- + +All of the articles on this site are linked together hypertextually, that is, like a webpage. +This means that all you need to do to explore the creative threads linking these articles together is to start clicking links. +However, 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. + +Alternatively, you can click the lozenge (◊) at the bottom of each page. +It'll take you to a random article in the project, thanks to [this javascript][]. + +If 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. +Sometimes, there are more than one of each of these---they represent other work I've done with hypertextuality. + +Things still to do +------------------ + +_Autocento of the breakfast table_ is a work in progress. +The first draft is completed, but some revision and aesthetic work remains to be done for me to consider it fully "[published][]" +(what does this word mean in 2015?). +You can see the full list of to-dos by visiting the [issues page][issues] of the Github site. + +Contact me +---------- + +If you'd like to contact me about the state of this work or my writing in general, you can email me at . + + +[of the breakfast table]: http://www.ibiblio.org/eldritch/owh/abt.html + +[text]: src/index.html + +[pandoc]: http://johnmacfarlane.net/pandoc/ +[compile.lua]: https://github.com/duckwork/autocento/blob/gh-pages/compile.lua +[this template]: https://github.com/duckwork/autocento/blob/gh-pages/.template.html +[Github]: https://github.com/ +[git]: http://www.git-scm.com/ +[my Github profile]: https://github.com/duckwork/autocento + +[index]: index.html +[this javascript]: https://github.com/duckwork/autocento/blob/gh-pages/js/lozenge.js + +[published]: published.html +[issues]: https://github.com/duckwork/autocento/issues + +[^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. + 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. + +[^2]: The great thing about `pandoc` is that it can compile to, and convert between, about fifty formats or so. + 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. + +[^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. -- cgit 1.4.1-21-gabe81