summaryrefslogtreecommitdiffstats
path: root/README.md
blob: 52382a1afff85cf34081a1c6450cdcba0b7638d4 (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
78
79
80
81
# Ed

Ed is a [Hugo][hugo] theme designed for textual editors based on
[minimal computing][mincomp] principles, and focused on legibility, durability,
ease and flexibility.

![screenshot][]

This theme is adopted and finalized with new functionality from
[Jekyll][jekyll] [Ed][ed-original] theme by [Alex Gil][gil-twitter].

## 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 otherpractices, 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][minimal-editions], 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][git-lit] model by Jonathan Reeve. We're coming for you, Kindle!

## Sample Ed editions

- [Our sample site][sample-site] is the first edition built with Ed.
- [Fugitive Verses][fig-vt]: Popular Reprinted Poetry from Nineteenth Century Newspapers
- [mini lazarillo][lazarillo]: A minimal edition of the *Lazarillo de Tormes*
- [Making and Knowing][GR8975]: The BnF Ms Fr 640 in Translation
- [Daisy Miller][dmiller-play]: A Comedy in Three Acts

## Features

- Templates for narrative, drama and poetry
- Responsive design for mobile phones, tablets and PCs
- Relatively easy to learn and teach
- Works well in high- or low- bandwidth scenarios
- Easier for digital archives and libraries to preserve
- Open source, open access
- Unobtrusive footnotes
- Metadata in OpenGraph to play nice with social media and search engines
- Automatic table of content generation

## License

Ed licensed under the MIT License. See the [LICENSE](./LICENSE) file for more
information.

[hugo]: http://gohugo.io
[mincomp]: http://go-dh.github.io/mincomp/
[screenshot]: https://raw.githubusercontent.com/sergeyklay/gohugo-theme-ed/master/exampleSite/content/documentation/screenshot-home.png
[jekyll]: https://jekyllrb.com
[ed-original]: https://github.com/minicomp/ed
[gil-twitter]: https://twitter.com/elotroalex
[minimal-editions]: https://github.com/susannalles/MinimalEditions/blob/master/README.md
[git-lit]: http://jonreeve.com/2015/09/introducing-git-lit/
[sample-site]: https://gohugo-theme-ed.netlify.app/
[fig-vt]: http://fugitiverses.viraltexts.org/
[lazarillo]: http://minilazarillo.github.io/
[GR8975]: https://cu-mkp.github.io/GR8975-edition/
[dmiller-play]: https://britaneeelizabeth.github.io/ed/texts/DaisyMillerPlay/
[example-site]: https://github.com/sergeyklay/gohugo-theme-ed/tree/master/exampleSite
[config-sample]: https://github.com/sergeyklay/gohugo-theme-ed/blob/master/exampleSite/config.toml