Org-page

org-page

Description	Static site generator based on org-mode
Author	Kevinh
Maintainer	name of maintainer
Source	https://github.com/kelvinh/org-page
Part of Emacs	no

Org-page is a static site generator based on Emacs and org mode.

Features include:

• org sources and html files managed by git (both in a different branch, so than you can push both on github)
• incremental publication (according to git diff command)
• category support
• tags support (auto generated)
• RSS support (auto generated)
• search engine support (auto generated)
• a beautiful theme
• theme customization support
• commenting (implemented using disqus/duoshuo)
• site visiting tracking (implemented using google analytics)
• index/about page support (auto generated if no default provided)
• highly customizable

Install

org-page is available in MELPA.

Usage

Workflow:

• specify a git repo (may created by yourself manually or by org-page’s op/new-repository command), where org sources on its “source” branch (the branch name can be customized, the same below), and generated html files will be on its “master” branch
• you specify a “base commit” (previous commit will be used if omitted), org-page will read changes between the latest commit and the specified base commit on branch “source”, the changes will be published
• org-page does preparation jobs
• publish the changes read in step 2, a change can be an addition, a modification, or a deletion, org-page is designed to handle all these kinds of changes, but since deletion does not often happen, so org-page has not implemented it yet
• update index page of each category, and tag pages
• publication finished

Configuration

It needs just a bit of configuration, and then you're ready to publish with one command. Please read the official documentation: https://github.com/kelvinh/org-page

Example site

The author's blog: http://kelvinh.github.io/

How is an org-page site constructed ? Check the "source" branch of his blog repo: https://github.com/kelvinh/kelvinh.github.com/tree/source