diff options
author | Case Duckworth | 2015-04-14 18:09:55 -0700 |
---|---|---|
committer | Case Duckworth | 2015-04-14 18:09:55 -0700 |
commit | 08fd8e95dccb91d0495a50d1009f85cb80cfad65 (patch) | |
tree | 9accf8a6e9b1f836e3c7c7b5437d11351545a07e /process.html | |
parent | Change file hierarchy and rewrite makefile (diff) | |
download | autocento-1.0.0.tar.gz autocento-1.0.0.zip |
First compile in v1.0.0 v1.0.0
Diffstat (limited to 'process.html')
-rw-r--r-- | process.html | 111 |
1 files changed, 111 insertions, 0 deletions
diff --git a/process.html b/process.html new file mode 100644 index 0000000..79d9613 --- /dev/null +++ b/process.html | |||
@@ -0,0 +1,111 @@ | |||
1 | <!DOCTYPE html> | ||
2 | <!-- AUTOCENTO OF THE BREAKFAST TABLE --> | ||
3 | <!-- vim: fdm=indent | ||
4 | --> | ||
5 | <html lang="en"> | ||
6 | <head> | ||
7 | <meta charset="utf-8"> | ||
8 | <meta name="generator" content="pandoc"> | ||
9 | <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes"> | ||
10 | <meta name="author" content="Case Duckworth"> | ||
11 | |||
12 | <title>Autocento of the breakfast table | Autocento of the breakfast table</title> | ||
13 | <link rel="icon" type="image/png" href="trunk/favico.png" /> | ||
14 | |||
15 | <link rel="stylesheet" type="text/css" href="trunk/style.css"> | ||
16 | <script src="scripts/randomize.js" type="text/javascript"> </script> | ||
17 | <script src="scripts/hylo.js" type="text/javascript"> </script> | ||
18 | |||
19 | <!--[if lt IE 9]> | ||
20 | <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"> </script> | ||
21 | <![endif]--> | ||
22 | </head> | ||
23 | <body id="process" class="front-matter"> | ||
24 | |||
25 | <article class="container"> | ||
26 | <header> | ||
27 | <!-- title --> | ||
28 | <h1 class="title">Autocento of the breakfast table</h1> | ||
29 | <h1 class="subtitle">process narrative</h1> | ||
30 | |||
31 | <div class="header-extra"> | ||
32 | |||
33 | </div> | ||
34 | </header> | ||
35 | |||
36 | |||
37 | <section class="content prose"> | ||
38 | <section id="hi.-my-name-is-case-duckworth.-this-is-my-thesis." class="level2"> | ||
39 | <h2>Hi. My name is Case Duckworth. This is my thesis.</h2> | ||
40 | <p><em>Autocento of the breakfast table</em> 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.</p> | ||
41 | </section> | ||
42 | <section id="process-steps" class="level2"> | ||
43 | <h2>Process steps</h2> | ||
44 | <ol type="1"> | ||
45 | <li>Write poems.</li> | ||
46 | <li>Convert to Markdown. | ||
47 | <ul> | ||
48 | <li>Markdown, originally by <a href="http://daringfireball.net/projects/markdown/">John Gruber</a>, is a lightweight markup language that allows me to focus on the <em>content</em> of my writing, knowing that I can work on the <em>presentation</em> later.</li> | ||
49 | <li>The original <code>markdown.pl</code> program is buggy and inconsistent with how it applies styles to markup. It also only works to convert text to HTML.</li> | ||
50 | <li>Because of these limitations, I’ve used John MacFarlane’s <a href="http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown">extended Markdown syntax</a>, which lets me write richer documents and programmatically compile my work into multiple formats.</li> | ||
51 | </ul></li> | ||
52 | <li>Compile to HTML with Pandoc. | ||
53 | <ul> | ||
54 | <li><p>At first, I used this code in the shell to generate my HTML:</p> | ||
55 | <pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">for</span> <span class="kw">file</span> in *.txt<span class="kw">;</span> <span class="kw">do</span> | ||
56 | <span class="kw">pandoc</span> <span class="st">"</span><span class="ot">$file</span><span class="st">"</span> -f markdown -t html5 \ | ||
57 | --template=template.html -o <span class="st">"</span><span class="ot">${file%</span>txt<span class="ot">}</span><span class="st">html"</span> | ||
58 | <span class="kw">done</span></code></pre> | ||
59 | but this proved tedious with time.</li> | ||
60 | <li>After a lot of experimenting with different scripting languages, I finally realized that <a href="https://www.gnu.org/software/make/manual/make.html"><code>GNU make</code></a> would fit this task perfectly.</li> | ||
61 | <li>You can see my makefile <a href="https://github.com/duckwork/autocento/blob/gh-pages/makefile">here</a>—it’s kind of a mess, but it does the job. See below for a more detailed explanation of the makefile.</li> | ||
62 | </ul></li> | ||
63 | <li>Style the pages with CSS. | ||
64 | <ul> | ||
65 | <li>I use a pretty basic style for <em>Autocento</em>. You can see my stylesheet <a href="https://github.com/duckwork/autocento/blob/gh-pages/style.css">here</a>.</li> | ||
66 | </ul></li> | ||
67 | <li>Use <a href="https://github.com">Github</a> to put them online. | ||
68 | <ul> | ||
69 | <li>Github uses <code>git</code> under the hood—a Version Control System developed for keeping track of large code projects.</li> | ||
70 | <li>My workflow with <code>git</code> looks like this: | ||
71 | <ul> | ||
72 | <li>Change files in the project directory—revise a poem, change the makefile, add a style, etc.</li> | ||
73 | <li>(If necessary, re-compile with <code>make</code>.)</li> | ||
74 | <li><code>git status</code> tells me which files have changed, which have been added, and if any have been deleted.</li> | ||
75 | <li><code>git add -A</code> adds all the changes to the <em>staging area</em>, or I can add individual files, depending on what I want to commit.</li> | ||
76 | <li><code>git commit -m "[message]"</code> commits the changes to git. This means they’re “saved”—if I do something I want to revert, I can <code>git revert</code> back to a commit and start again.</li> | ||
77 | <li><code>git push</code> pushes the changes to the <em>remote repository</em>—in this case, the Github repo that serves <a href="http://autocento.me" class="uri">http://autocento.me</a>.</li> | ||
78 | <li>Lather, rinse, repeat.</li> | ||
79 | </ul></li> | ||
80 | </ul></li> | ||
81 | <li>Write Makefile to extend build capabilities. | ||
82 | <ul> | ||
83 | <li>As of now, I’ve completed a <em><a href="hapax.html">Hapax legomenon</a></em> compiler, a <a href="makefile">back-link</a> compiler, and an updater for the <a href="trunk/lozenge.js">random link functionality</a> that’s on this site.</li> | ||
84 | <li>I’d like to build a compiler for the <a href="first-lines.html">Index of first lines</a> and <a href="common-titles.html">Index of common titles</a> once I have time.</li> | ||
85 | </ul></li> | ||
86 | </ol> | ||
87 | </section> | ||
88 | <section id="the-beauty-of-this-system" class="level2"> | ||
89 | <h2>The beauty of this system</h2> | ||
90 | <ul> | ||
91 | <li>I can compile these poems into (almost) any format: <code>pandoc</code> supports a lot.</li> | ||
92 | <li>Once I complete the above process once, I can focus on revising my poems.</li> | ||
93 | <li>These poems are online for anyone to see and use for their own work.</li> | ||
94 | </ul> | ||
95 | </section> | ||
96 | </section> | ||
97 | </article> | ||
98 | <nav> | ||
99 | <div class="anchors"> | ||
100 | <a href="backlinks/process.html" id="backlinks" title="Links to this page"> | ||
101 | φ | ||
102 | </a> | ||
103 | <a href="index.html" id="coverlink" title="To cover">◊</a> | ||
104 | <a href="#" id="randomizelink" title="ERROR">ξ</a> | ||
105 | </div> | ||
106 | |||
107 | |||
108 | </nav> | ||
109 | |||
110 | </body> | ||
111 | </html> | ||