mirror/kiln
1
0
Fork 0
mirror of https://git.sr.ht/~adnano/kiln synced 2024-11-23 13:02:09 +01:00
Code Issues Activity
A simple static site generator
8 Commits 1 Branch 9 Tags 612 KiB
Go 98.2%
Makefile 1.8%
2bbfdc3d07
Go to file
adnano 2bbfdc3d07 Reimplement in Go
2020-09-22 16:42:14 -04:00
go.mod Reimplement in Go 2020-09-22 16:42:14 -04:00
index.go Reimplement in Go 2020-09-22 16:42:14 -04:00
LICENSE Add LICENSE 2020-09-22 00:02:36 -04:00
main.go Reimplement in Go 2020-09-22 16:42:14 -04:00
manipulate.go Reimplement in Go 2020-09-22 16:42:14 -04:00
README.md Reimplement in Go 2020-09-22 16:42:14 -04:00

README.md

kiln

A simple static site generator for Gemini.

Features

  • Zero configuration
  • Simple and fast
  • Gemini support
  • Go templates

Usage

kiln

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