A static site generator based on Emacs and org mode.
Introduction
Org-page is a static site generator based on org-mode.
Org-page provides the following features:
Org sources and html files managed by git
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/hashover)
Website traffic analytics (implemented using google analytics)
Index/about page support (auto generated if no default is provided)
Site preview
Highly customizable
Here is my personal site generated by org-page. The html files and org source files are located at https://github.com/kelvinh/kelvinh.github.com. If you want to give org-page a try, you could take them as an example.
Workflow
Specify a git repo where the org source files will be on the “source” branch and the generated html files will be on the “master” branch (the branch names can be customized). Repos may be created manually or by org-page’s op/new-repository command.
Specify a “base commit” (the most recent prior 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 then be marked for publication.
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 of these kinds of changes but since deletion does not happen often, org-page has not implemented it yet
Update the index page for each category and tag.
Publication finished.
Usage
Here is a general introduction about how to use org-page, for more detailed introduction and configuration, please see “quick-guide.org” in the “doc” folder.
Installation
Org-page is now available from the famous emacs package repo melpa so the recommended way is to install it through emacs’ package management system. For more info about installation, please see quick-guide.org in the “doc” folder.
Configuration
Add the following lines to your .emacs file:
;;; the following is only needed if you install org-page manually
(add-to-list 'load-path "path/to/org-page")
(require 'org-page)
(setq op/repository-directory "path/to/your/org/repository")
(setq op/site-domain "http://your.personal.site.com/")
;;; for commenting, you can choose either disqus, duoshuo or hashover
(setq op/personal-disqus-shortname "your_disqus_shortname")
(setq op/personal-duoshuo-shortname "your_duoshuo_shortname")
(setq op/hashover-comments t)
;;; the configuration below are optional
(setq op/personal-google-analytics-id "your_google_analytics_id")
Publication
Evaluate the following code to publish your changes:
(op/do-publication nil "HEAD^1" "~/org-pub/" nil)
or just
(op/do-publication)
You can also run it interactively: M-x op/do-publication <Enter>
NOTE: Org-page does NOT commit your org files to git, so you have to commit them manually before you run this command.
Site preview in browser
Just run M-x op/do-publication-and-preview-site <Enter>, the site will be published in ~/.op-tmp, then it will be previewed in browser automatically.
simple-httpd: A simple Emacs web server is required for site preview
git.el: An Elisp API for programmatically using Git
Known issues
Currently the deletion change handler has not been implemented so if you deleted some org sources, you may have to manually delete corresponding generated html files.
URI path change detection is not available. That is, if you make a post with the URI “/blog/2013/03/25/the-old-post-name” and then change this value in your org source, org-page would be unable to detect that this has happened. it will only publish a new html file for you so you need to delete the old html file related to the old URI manually.
