blog-generator
A static blog generator using a configurable GitHub repository as a data-source. The posts are written in markdown with yml metadata attached to them. This is an example repo for the blog at https://zupzup.org/.
Features
- Listing
- Sitemap Generator
- RSS Feed
- Code Highlighting
- Archive
- Configurable Static Pages
- Tags
- File-Based Configuration
Installation
go get github.com/zupzup/blog-generator
Usage & Customization
Configuration
The tool can be configured using a config file called bloggen.yml. There is a bloggen.dist.yml in the repository you can use as a template.
Example Config File:
generator:
repo: 'https://git.sr.ht/~zupzup/blog'
tmp: 'tmp'
dest: 'www'
userss: true
blog:
url: 'https://www.zupzup.org'
language: 'en-us'
description: 'A blog about Go, JavaScript, Open Source and Programming in General'
dateformat: '02.01.2006'
title: 'zupzup'
author: 'Mario Zupan'
frontpageposts: 10
statics:
files:
- src: 'static/favicon.ico'
dest: 'favicon.ico'
- src: 'static/robots.txt'
dest: 'robots.txt'
- src: 'static/about.png'
dest: 'about.png'
templates:
- src: 'static/about.html'
dest: 'about'
Running
Just execute
blog-generator
Serving
To run a local server serving the blog on http://127.0.0.1:8000, run
blog-generator -s
Templates
Edit templates in static folder to your needs.