2019-05-18 20:00:12 +02:00
|
|
|
# kiln
|
|
|
|
|
|
2020-09-22 22:42:14 +02:00
|
|
|
A simple static site generator for Gemini.
|
2019-05-18 20:00:12 +02:00
|
|
|
|
|
|
|
|
## Features
|
|
|
|
|
|
2020-09-22 22:42:14 +02:00
|
|
|
- Zero configuration
|
2019-05-18 20:00:12 +02:00
|
|
|
- Simple and fast
|
2020-09-22 22:42:14 +02:00
|
|
|
- Gemini support
|
|
|
|
|
- Go templates
|
2019-05-18 20:00:12 +02:00
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
kiln
|
|
|
|
|
```
|
|
|
|
|
|
2020-09-22 22:42:14 +02:00
|
|
|
## Directory Structure
|
|
|
|
|
|
|
|
|
|
A kiln site is organized in the following way:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
src/ Site source
|
|
|
|
|
templates/ Templates
|
|
|
|
|
page.gmi Page template
|
|
|
|
|
section.gmi Section template
|
|
|
|
|
dst/ Site destination
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Running `kiln` takes the contents in `src`, runs them through the templates in
|
|
|
|
|
`templates`, and outputs the result to `dst`.
|
|
|
|
|
|
|
|
|
|
## Pages
|
|
|
|
|
|
|
|
|
|
Page templates are provided with the following information:
|
|
|
|
|
|
|
|
|
|
- `Title`: The title parsed from the first heading in the file
|
|
|
|
|
- `Date`: The date parsed from the filename (e.g. `2020-09-22-hello-world.gmi`)
|
|
|
|
|
- `Path`: Relative path to the page
|
|
|
|
|
- `Permalink`: Permalink to the page
|
|
|
|
|
- `Content`: The contents of the file (including the title)
|
|
|
|
|
|
|
|
|
|
## Sections
|
|
|
|
|
|
|
|
|
|
Section templates are provided with the following information:
|
|
|
|
|
|
|
|
|
|
- `Path`: Relative path to the section
|
|
|
|
|
- `Permalink`: Permalink to the section
|
|
|
|
|
- `Pages`: The pages in this section
|
|
|
|
|
|
|
|
|
|
## Templates
|
|
|
|
|
|
|
|
|
|
Templates are located in the `templates` directory.
|
|
|
|
|
|
|
|
|
|
There are currently two supported templates:
|
|
|
|
|
|
|
|
|
|
- `page.gmi`: The template used for pages
|
|
|
|
|
- `section.gmi`: The template used for sections
|
