wombat is a static site generator
Go to file
2023-04-08 17:10:31 +02:00
blog blogposts: fill categoryListings to link to related posts automatically 2023-04-08 17:10:31 +02:00
converter update to recent goutil split 2020-10-11 13:35:13 +02:00
gallery update to recent goutil split 2020-10-11 13:35:13 +02:00
generate command unification 2021-06-26 17:09:41 +02:00
initer blogposts: fill categoryListings to link to related posts automatically 2023-04-08 17:10:31 +02:00
page command unification 2021-06-26 17:09:41 +02:00
post newpost command: accept --date flag for past or future dates 2022-12-05 21:28:19 +01:00
site add default script for burger menu on retarded devices 2023-03-05 14:04:02 +01:00
splitter update to recent goutil split 2020-10-11 13:35:13 +02:00
templatestructures add default script for burger menu on retarded devices 2023-03-05 14:04:02 +01:00
.gitignore purge history since June 2017 2019-01-01 19:41:03 +01:00
go.mod blogposts: fill categoryListings to link to related posts automatically 2023-04-08 17:10:31 +02:00
LICENSE add license 2019-01-13 20:16:12 +01:00
README.md clarify readme 2022-09-01 08:43:17 +02:00
wombat.go use new finstr module 2021-06-26 17:39:56 +02:00

wombat

wombat is a static site generator that combines the concepts of ordinary pages, blogs and image galleries. It compiles html pages from html fragments and markdown files according to a template.

The fragments are assumed to be in 'stage0', results will appear in 'stage2'. Pages need a description header:

---
title: Foobar
description: This describes foobar
---

Blog posts (located in stage0/blog/) have a similar header with values for title, date and categories.

Normal pages are created via "wombat newpage", new blog posts via "wombat newpost". Check "wombat help" for other commands. If you create a page and a folder with the same name (without the suffix), all sub-pages in the folder are listed on that parent page before its content.

build

You'll need go1.11+ with module support. Check out the repository and run 'go build wombat.go'.

quick start

Put the executable somewhere in your path. Create a folder for your website, then...

> cd YOUR_FOLDER
> wombat init
Initializing YOUR_FOLDER
> wombat gen
Serving stage2 at http://127.0.0.1:8000 ...
Use Ctrl+C to exit
(This is not a production web server, don't get any funny ideas)

... and visit http://127.0.0.1:8000 in your browser.

stages

Image galleries were added as a sort of pre-stage - place your jpg files outside of the stage0 - stage2 folders in the corresponding gallery folder (default but not necessarily only folder: photos). wombat generates web-suitable and thumbnail versions of them and places them inside stage0.

stage0 is where you edit your ordinary pages or formerly created blog pages (default but not necessarily only folder: blog). stage1 is created for internal reasons only, stage2 contains the files you upload to a suitable server, possibly via rsync to keep traffic low.

customization

To customize the look and feel or the top navigation, edit the files 'style.css' and 'template', the latter being a Go template that is executed on every html or markdown fragment to create a web page.

final note

If you want to buy me a beer, just send inconspicuous envelopes.