diff options
author | Case Duckworth | 2015-03-18 11:41:43 -0700 |
---|---|---|
committer | Case Duckworth | 2015-03-18 11:41:43 -0700 |
commit | 544d6f5e304453897f5e28b9b92daf8259eeac84 (patch) | |
tree | 0af9a341c38253ec4f23e14f625f7da62a41e61a /src | |
parent | Add README.txt in src/ (diff) | |
download | autocento-544d6f5e304453897f5e28b9b92daf8259eeac84.tar.gz autocento-544d6f5e304453897f5e28b9b92daf8259eeac84.zip |
Add README (for real this time) & update with TODOs
Diffstat (limited to 'src')
-rw-r--r-- | src/README.txt | 101 |
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 | --- | ||
2 | title: Autocento of the breakfast table | ||
3 | subtitle: about this site | ||
4 | genre: prose | ||
5 | |||
6 | epigraph: | ||
7 | content: by Case Duckworth | ||
8 | |||
9 | project: | ||
10 | title: Autocento of the breakfast table | ||
11 | css: autocento | ||
12 | ... | ||
13 | |||
14 | Introduction | ||
15 | ------------ | ||
16 | |||
17 | _Autocento [of the breakfast table][]_ is a hypertextual exploration of the workings of revision across time. | ||
18 | Somebody^[citation needed]^ once said that every relationship we have is part of the same relationship; the same is true of authorship. | ||
19 | As we write, as we continue writing across our lives, patterns thread themselves through our work: images, certain phrases, preoccupations. | ||
20 | This project attempts to make those threads more apparent, using the technology of hypertext. | ||
21 | |||
22 | I'm also an MFA candidate at [Northern Arizona University][NAU]. | ||
23 | This is my thesis. | ||
24 | |||
25 | Process | ||
26 | ------- | ||
27 | |||
28 | In 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 | |||
35 | as well as added new poems, written quite recently. | ||
36 | 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. | ||
37 | This should give the reader a fair idea of what my head looks like on the inside. | ||
38 | |||
39 | Technology | ||
40 | ---------- | ||
41 | |||
42 | Because this project lives online, I've used a fair amount of technology to get it there. | ||
43 | First, I converted all the articles[^1] present into plain text files, which are viewable [here][text]. | ||
44 | 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][]. | ||
45 | The compiled HTML is what you're reading now.[^2] | ||
46 | |||
47 | To host the project, I'm using [Github][], an online code-collaboration tool with the version control system [git][] under the hood. | ||
48 | 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. | ||
49 | You can view the repository and its changes and files at [my Github profile][].[^3] | ||
50 | |||
51 | Using this site | ||
52 | --------------- | ||
53 | |||
54 | All of the articles on this site are linked together hypertextually, that is, like a webpage. | ||
55 | This means that all you need to do to explore the creative threads linking these articles together is to start clicking links. | ||
56 | 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. | ||
57 | |||
58 | Alternatively, you can click the lozenge (◊) at the bottom of each page. | ||
59 | It'll take you to a random article in the project, thanks to [this javascript][]. | ||
60 | |||
61 | 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. | ||
62 | Sometimes, there are more than one of each of these---they represent other work I've done with hypertextuality. | ||
63 | |||
64 | Things still to do | ||
65 | ------------------ | ||
66 | |||
67 | _Autocento of the breakfast table_ is a work in progress. | ||
68 | The 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?). | ||
70 | You can see the full list of to-dos by visiting the [issues page][issues] of the Github site. | ||
71 | |||
72 | Contact me | ||
73 | ---------- | ||
74 | |||
75 | If 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. | ||