ryuslash/orgweb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
orgweb/site/projects/org-blog.org
Tom Willemsen c90daec5f4 Initial commit
2012-06-21 21:24:54 +02:00

2.6 KiB
Raw Blame History

git-auto-commit-mode

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 o-blog and 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:

(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)))

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:

(setq org-blog-directory "~/path/to/blog/org/files/")
(setq org-blog-unfinished-directory "~/path/to/drafts/")

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.