Gozer adalah generator situs statis yang cepat & sederhana yang ditulis dalam Golang.
Contoh situs web yang menggunakan Gozer:
Anda dapat menginstal Gozer dengan terlebih dahulu menginstal kompiler Go dan kemudian menjalankan:
go install git.sr.ht/~dvko/gozer@latest
Jalankan gozer new
untuk membuat struktur direktori kosong dengan cepat.
├── config.toml # Configuration file
├── content # Posts and pages
│ └── index.md
├── public # Static files
└── templates # Template files
└── default.html
Kemudian, jalankan gozer build
untuk membuat situs Anda.
File Markdown apa pun yang ditempatkan di direktori content/
Anda akan menghasilkan halaman HTML di direktori build Anda setelah menjalankan gozer build
.
Misalnya:
content/index.md
membuat file build/index.html
sehingga dapat diakses melalui HTTP di /
content/about.md
membuat file build/about/index.html
sehingga dapat diakses melalui HTTP di /about/
. Jalankan gozer
tanpa argumen apa pun untuk melihat teks bantuan.
Gozer - a fast & simple static site generator
Usage: gozer [OPTIONS] <COMMAND>
Commands:
build Deletes the output directory if there is one and builds the site
serve Builds the site and starts an HTTP server on http://localhost:8080
new Creates a new site structure in the given directory
Options:
-r, --root <ROOT> Directory to use as root of project (default: .)
-c, --config <CONFIG> Path to configuration file (default: config.toml)
Setiap file di direktori content/
Anda harus diakhiri dengan .md
dan memiliki bagian depan TOML yang menentukan judul halaman:
+++
title = " My page title "
+++
Page content here.
Templat default untuk setiap halaman adalah default.html
. Anda dapat menggantinya dengan mengatur variabel template
di front matter Anda.
+++
title = " My page title "
template = " special-page.html "
+++
Page content here.
Templat didukung oleh paket html/template
standar Go, sehingga Anda dapat menggunakan semua tindakan yang dijelaskan di sini.
Setiap templat menerima serangkaian variabel berikut:
Pages # Slice of all pages in the site
Posts # Slice of all posts in the site (any page with a date in the filename)
Site # Global site properties: Url, Title
Page # The current page: Title, Permalink, UrlPath, DatePublished, DateModified
Title # The current page title, shorthand for Page.Title
Content # The current page's HTML content.
Variabel Page
adalah turunan dari objek di bawah ini:
type Page struct {
// Title of this page
Title string
// Template this page uses for rendering. Defaults to "default.html".
Template string
// Time this page was published (parsed from file name).
DatePublished time.Time
// Time this page was last modified on the filesystem.
DateModified time.Time
// The full URL to this page, including the site URL.
Permalink string
// URL path for this page, relative to site URL
UrlPath string
// Path to source file for this page, relative to content root
Filepath string
}
Untuk menampilkan daftar 5 postingan terbaru:
{{ range (slice .Posts 0 5) }}
<a href="{{ .Permalink }}">{{ .Title }}</a> <small>{{ .DatePublished.Format "Jan 02, 2006" }}</small><br />
{{ end }}
Pengembangan Gozer terjadi di Sourcehut. Patch diterima melalui email.
Gozer bersumber terbuka di bawah lisensi MIT.