summaryrefslogtreecommitdiffstats
path: root/README.md
blob: 4f9c74f5e53ee2e1e32363ed5106e07c6c856367 (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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
# Ed

Ed is a [Hugo](http://gohugo.io) theme designed for textual editors based on
[minimal computing](http://go-dh.github.io/mincomp/) principles, and focused on legibility,
durability, ease and flexibility.

This theme is adopted from [Jekyll](https://jekyllrb.com/) [Ed](https://github.com/minicomp/ed) theme
by [Alex Gil](https://twitter.com/elotroalex).

## Introduction

One of our most pressing and ever-evolving needs as scholars is to pass on our textual artifacts
from one generation to another. The art of textual editing, among other practices, has helped many
cultures to remember and interpret for centuries. Alas, that art is practiced and encouraged in its
highest form by a dwindling number of scholars. In a digital environment the problem is compounded
by the difficulties of the medium. While vast repositories and "e-publications" appear on the
online scene yearly, very few manifest a textual scholar's disciplined attention to detail. In
contrast, most textual scholars who have made the leap to a rigorous digital practice have focused
on markup, relying on technical teams to deploy and maintain their work. This makes your average
scholarly digital edition a very costly and therefore limited affair.

As we see it, a minimal edition is one that aims to reduce the size and complexity of the back and
front end while flattening the learning curves for the user and the producer. Out of the box, the Ed
theme can help you build a simple reading edition, or a traditional scholarly edition with footnotes
and a bibliography, without breaking the bank. In our estimate, these are the two most immediately
useful type of editions for editors and readers. An edition produced with Ed consists of static
pages whose rate of decay is substantially lower than database-driven systems. As an added bonus,
these static pages require less bandwidth. Our hope is that our approach can help beginners and
veterans deploy beautiful editions with less effort, and that it can help us teach a 'full stack'
[in one academic semester](https://github.com/susannalles/MinimalEditions/blob/master/README.md),
while allowing us to care for our projects at less cost, and perhaps, just perhaps, to generate
high-quality editions on github.io in large quantities based on the
[git-lit](http://jonreeve.com/2015/09/introducing-git-lit/) model by Jonathan Reeve. We're coming
for you, Kindle!

## Configuration

### `config.toml` example

```toml
baseURL = 'http://example.org/'
languageCode = 'en-us'
title = 'Ed.'
theme = 'ed'

# Used in authorbox
[Author]
  name = 'John Doe'

[Params]
    # Site description. Used in meta description
    description = 'Ed is a Hugo theme designed for textual editors based on minimal computing principles, and focused on legibility and flexibility.'
    # Color scheme. Options: red, orange, magenta, cyan, blue, brown
    color_scheme = ''
    # Github project url. Used in sidebar
    github_url = 'https://github.com/user/project'
    # Used in header
    tagline = 'a Hugo theme for minimal editions'

[menu]
  [[menu.nav]]
    name = "Posts"
    url = "/posts/"
    weight = 1
  [[menu.nav]]
    name = "Tags"
    url = "/tags/"
    weight = 2
  [[menu.nav]]
    name = "Documentation"
    url = "/documentation/"
    weight = 3
  [[menu.nav]]
    name = "About"
    url = "/about/"
    weight = 4
```