A static blog generator
Project description
Golbarg is a static blog generator written in Python. It is heavily inspired by Jekyll, but is is (obviously!) better (at least in my opinion).
You can see it in action on my own blog, (source code on Github too).
Golbarg is free software, available under the terms of the GNU GPLv3 license.
Features
Markdown synax for editing posts
Jinja 2 template engine
YAML standard for configuration and posts metadata (similar to Jekyll’s YAML front matter)
Written in Python
Well-documented and easily hackable
Built-in support for tags and archive generation
Dependencies
Installation
Install Python (version 2.6, Golbarg is not compatible with Python 3 yet)
Install the dependencies
Install Golbarg: you can use Python tools (easy_install Golbarg or pip install Golbarg) or, if you are a Linux user, the tools from your distribution(pacman, aptitude, emerge…) if someone packaged Golbarg for it
Create a directory where you will put all your files
Create your configuration file and templates; you may want to look at mine for examples
Write your posts in the content/posts directory, using the Markdown syntax, with a YAML header for metadata (again, see my blog for examples)
Run golbarg to generate the full site
Upload it somewhere and enjoy your blog!
golbarg-mode for Emacs
If you use Emacs, you may want to use golbarg-mode. Simply add the directory where golbarg.el is located to your load-path, add (require 'golbarg) in your .emacs, and you are done. You can now use M-x golbarg-mode to switch a buffer to the Golbarg major mode, and use other commands such as golbarg-new-draft, golbarg-publish-post, and golbarg-preview (after customizing the golbarg-drafts-dir and golbarg-posts-dir variables).
You can see a full configuration on my emacs-config repository.
golbarg-mode requires markdown-mode and yaml-mode to work, so be sure to install these modes first.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file Golbarg-0.2.tar.gz
.
File metadata
- Download URL: Golbarg-0.2.tar.gz
- Upload date:
- Size: 20.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 34a680acdbf346681bf1279a12d5f20a07ff6876549983a6bcee68382ecbea5f |
|
MD5 | c9e518908f3960d9b16738effdacd693 |
|
BLAKE2b-256 | 1c44413e1a4132b6ae74db60d439dd5bcb086bfc44fed1564da2d240114612ff |
File details
Details for the file Golbarg-0.2-py2.6.egg
.
File metadata
- Download URL: Golbarg-0.2-py2.6.egg
- Upload date:
- Size: 22.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | cc6f81fb95f2081d669e9f0f15aa26ae1a0fb32654a9ddff56b9fedb34d24d36 |
|
MD5 | 39f3ceaa180752993db3e56e003f91d7 |
|
BLAKE2b-256 | 18c3b293430641713b59ad05ee31d6f149899194bf8dca88b532377cbfafbe6e |