summary refs log tree commit diff stats
path: root/process.html
diff options
context:
space:
mode:
authorCase Duckworth2015-04-14 18:09:55 -0700
committerCase Duckworth2015-04-14 18:09:55 -0700
commit08fd8e95dccb91d0495a50d1009f85cb80cfad65 (patch)
tree9accf8a6e9b1f836e3c7c7b5437d11351545a07e /process.html
parentChange file hierarchy and rewrite makefile (diff)
downloadautocento-08fd8e95dccb91d0495a50d1009f85cb80cfad65.tar.gz
autocento-08fd8e95dccb91d0495a50d1009f85cb80cfad65.zip
First compile in v1.0.0 v1.0.0
Diffstat (limited to 'process.html')
-rw-r--r--process.html111


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">&quot;</span><span class="ot">$file</span><span class="st">&quot;</span> -f markdown -t html5 \


57--template=template.html -o <span class="st">&quot;</span><span class="ot">${file%</span>txt<span class="ot">}</span><span class="st">html&quot;</span>


58<span class="kw">done</span></code></pre>


59but 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 &quot;[message]&quot;</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&phi;


102</a>


103<a href="index.html" id="coverlink" title="To cover">&loz;</a>


104<a href="#" id="randomizelink" title="ERROR">&xi;</a>


105</div>


106


107


108</nav>


109


110</body>


111</html>
 


© 2022 C. Duckworth.
generated by
cgit.
comments, issues, and patches welcome at
<
git at acdw dot net
>.