wombat/README.md

56 lines
2.0 KiB
Markdown
Raw Normal View History

2019-01-01 19:41:03 +01:00
wombat
======
2019-01-23 19:13:01 +01:00
wombat is a static site generator that combines the concepts of ordinary pages, blogs and image galleries. It compiles
2019-01-01 19:41:03 +01:00
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.
2022-09-01 08:43:17 +02:00
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.
2019-01-01 19:41:03 +01:00
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)
```
2020-09-16 11:20:38 +02:00
... and visit http://127.0.0.1:8000 in your browser.
2022-08-19 20:06:07 +02:00
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.
2020-09-16 11:20:38 +02:00
2022-08-20 07:32:29 +02:00
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.