Sorry folks, This project is not under active development any more.
Introduction
Org-page is a static site generator based on [[http://orgmode.org/][org-mode]].
Org-page provides the following features:
1) Org sources and html files managed by git 2) Incremental publication (according to =git diff= command) 3) Category support 4) Tags support (auto generated) 5) RSS support (auto generated) 6) Search engine support (auto generated) 7) A beautiful theme 8) Theme customization support 9) Commenting (implemented using disqus/duoshuo/hashover) 10) Website traffic analytics (implemented using google analytics) 11) Index/about page support (auto generated if no default is provided) 12) Site preview 13) Highly customizable
[[http://kelvinh.github.com][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
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 [[http://melpa.milkbox.net/][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
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
Dependencies
Known issues