about summary refs log tree commit diff stats
path: root/README.md
blob: 4bd83ca72de3ec0db2702cc4fd634d8f96768886 (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
48
49
Autocento of the breakfast table: a README
==========================================

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: How to use this repo
-----------------------------

This project uses John McFarlane's wonderful program [pandoc][], and its markdown flavor, to encode the poems and stories and things contained within.
To see the source text files, navigate to the [src/](autocento.me/src/) folder.

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

````yaml
---
title: Title of poem
subtitle: Subtitle                           # optional
genre: verse                                 # verse or prose

epigraph:                                    # optional
- content: 'Quote from outside'              # req'd if epigraph exists
  link: 'Link to online version of epigraph' # optional
  attrib: 'Who said the epigraph'            # optional

dedication: John Doe                         # optional

project:
    title: Original project name
    order: 1                                 # original project order
    prev:
    - title: Title of previous thing in original project
      link: link to that thing
    - title: Title of other previous thing
      link: link to that thing
    next:
    - title: Title of next thing in original project
      link: link to that thing
    - title: Title of other next thing
      link: link to that thing
...
````

To compile all the markdown into glorious, glorious HTML (visible at <autocento.me>), run `compile.sh` (`bash compile.sh` in Windows) in the root directory of this git repository.

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