static blog generator for my blog at https://zupzup.org/
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
cli
config
datasource
generator
static
.gitattributes
.gitignore
Gopkg.lock
Gopkg.toml
LICENSE
README.md
bloggen.dist.yml
main.go
run.sh

README.md

Go Report Card

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://github.com/zupzup/blog'
    tmp: 'tmp'
    dest: 'www'
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

Templates

Edit templates in static folder to your needs.

Example Blog Repository

Blog