ebg 0.5.4

Eric's Blog Generator, a simple static site generator.
Documentation 
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

---
layout: page
---

# Eric's Blog Generator

This site describes how to use Eric's Blog Generator (EBG).
It also serves as an example site generated using Eric's Blog Generator.

## Getting Started - Configuration

EBG expects each page to have a configuration file called `Site.toml`.
This file provides basic information, like what files to process.

Here is an example:

```toml
title = "My Awesome Web Site"

content = [
    "images",
    "index.md",
    "style.css",
]
```

For more detail about `Site.toml`, see [Site Configuration](site-config.md).

## Anatomy of a Page and Post

Pages may be written as HTML or Markdown.

## Features

- [Categories](categories.md) - Group posts by topic and generate category pages

Additional information is specified in YAML frontmatter.
A simple HTML page would look something like this:

```html
---
title: Sample Page
---

<p>This is a sample page.</p>
```

The lines between the `---` are the frontmatter.
The remainder of the post comes afterwards.

For Markdown files, these are converted to HTML, while HTML content is rendered unchanged into the site template.
After rendering, site macros are expanded.

### Markdown

Markdown files are converted to HTML using [Pulldown][pulldown].
Some extensions are enabled by default, such as footnotes.[^exfootnote]

[pulldown]: https://crates.io/crates/pulldown-cmark

[^exfootnote]: Footnotes are rendered like this.

## Themes

See [Themes](themes.md).