about summary refs log tree commit diff stats
path: root/README.md
blob: 91e57b3f6b0032b3926df080e85f2a82ec1648d0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
#  Autocento of the breakfast table
## User guide and manual
## or whatever.  I don't care.

# Part I: in which our hero explains the goal

The goal in this book, *Autocento of the breakfast table*, is to explore the
workings of revision and recursion through words, both in the head and on
paper.  It's a hypertextual imagining of how things could have been, in all
of their possibilities.

# Part II: Enough of that high-faluting bullshit; down to brass tax
## A.K.A. Using Pandoc to compile them pages, neff

This project uses John MacFarlane's amazing, etc. [pandoc][] for the fun,
HTML-writing stuff. Use the `compile.sh` script to compile the stuff down.

*Note: you're on Windows right now, so make sure and type `bash compile.sh` to
run the program.*

At the top of each file, there should be a YAML block that looks something
like this:

````yaml
---
title: 'Title of poem'
subtitle: 'Subtitle' # optional
genre: '[verse|prose]'

project:
- title: 'Original project name'
  order: [number]
  prev:
  - title: 'Title of previous thing in original project'
    link: 'link to that thing'
  next:
  - title: 'Title of next thing in original project'
  - link: 'link to that thing'

epigraph: # optional
- content: 'Quote from outside'
  link: 'Link to online version of epigraph'
  attrib: 'Who said the epigraph' # optional
...
````

[pandoc]: http://johnmacfarlane.net/pandoc/