Skip to main content

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

  1. Install Python (version 2.6, Golbarg is not compatible with Python 3 yet)

  2. Install the dependencies

  3. 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

  4. Create a directory where you will put all your files

  5. Create your configuration file and templates; you may want to look at mine for examples

  6. Write your posts in the content/posts directory, using the Markdown syntax, with a YAML header for metadata (again, see my blog for examples)

  7. Run golbarg to generate the full site

  8. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Golbarg-0.2.tar.gz (20.3 kB view details)

Uploaded Source

Built Distribution

Golbarg-0.2-py2.6.egg (22.4 kB view details)

Uploaded Source

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

Hashes for Golbarg-0.2.tar.gz
Algorithm Hash digest
SHA256 34a680acdbf346681bf1279a12d5f20a07ff6876549983a6bcee68382ecbea5f
MD5 c9e518908f3960d9b16738effdacd693
BLAKE2b-256 1c44413e1a4132b6ae74db60d439dd5bcb086bfc44fed1564da2d240114612ff

See more details on using hashes here.

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

Hashes for Golbarg-0.2-py2.6.egg
Algorithm Hash digest
SHA256 cc6f81fb95f2081d669e9f0f15aa26ae1a0fb32654a9ddff56b9fedb34d24d36
MD5 39f3ceaa180752993db3e56e003f91d7
BLAKE2b-256 18c3b293430641713b59ad05ee31d6f149899194bf8dca88b532377cbfafbe6e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page