#+TITLE: git-auto-commit-mode
#+LINK_UP: ../index.html
#+LINK_HOME: ../index.html
#+LINK: src    https://github.com/ryuslash/org-blog
#+LINK: tar_gz https://github.com/ryuslash/org-blog/tarball/master
#+LINK: zip    https://github.com/ryuslash/org-blog/zipball/master

#+INCLUDE: "../header.org" :lines "1-4"
#+INCLUDE: "dlmenu.inc"

* About

  ~org-blog~ is a blog exporter for ~org-mode~ written by David
  O'Toole in 2006. ~org-mode~ has since then changed a bit and it
  seemed that it no longer worked. It also seems to be the only
  viable/acceptable pure-org solution for me, so I'm trying to revive
  it.

** Why

   As stated, it seemed to be out-of-date and packages like [[http://renard.github.com/o-blog/][o-blog]] and
   [[http://www.emacswiki.org/emacs/Blorg][blorg]] didn't work for me, and many others require some external
   tool to work.

* Setup

  Since I've adapted it to work as a normal publishing function for
  org, setting it up is a lot like any other publishing project as
  well:

  #+BEGIN_SRC emacs-lisp
  (setq org-publish-project-alist
      '(("myblog"
         :base-directory "~/location/to/org/files/"
         :publishing-directory "/place/to/export/to/"
         :base-extension "org"
         :publishing-function org-publish-org-to-blog
         :blog-title "some title"
         :blog-description "some description"
         :blog-export-rss t
         :index-title "oni blog"
         :recursive nil
         :table-of-contents nil)))
   #+END_SRC

  Most of these options are very normal project settings and can be
  read about in the documentation for the variable
  ~org-publish-project-alist~. The ~blog-title~, ~blog-description~,
  ~blog-export-rss~ and ~index-title~, however, are used by
  ~org-blog~.

  - ~blog-title~

    This setting is used when exporting RSS. It sets the ~title~ in
    the XML output.

  - ~blog-description~

    This setting is also used when exporting RSS. It sets the
    ~description~ in the XML output.

  - ~blog-export-rss~

    Whether or not you would like an RSS feed to be exported.

  - ~index-title~

    This is used as the title of the blog's index page.

  Apart from these there are also 2 other settings that need your
  attention:

  #+BEGIN_SRC emacs-lisp
  (setq org-blog-directory "~/path/to/blog/org/files/")
  (setq org-blog-unfinished-directory "~/path/to/drafts/")
  #+END_SRC

  These don't have any relevance to the exporting and publishing
  functions, but they're used by the ~org-blog-new-post~ and
  ~org-blog-finish-post~ functions, which help with creating new
  posts.

#+INCLUDE: "../header.org" :lines "5-8"