From c90daec5f4a91cf1041a5a61411d860ea4329ece Mon Sep 17 00:00:00 2001 From: Tom Willemsen Date: Thu, 21 Jun 2012 21:24:54 +0200 Subject: Initial commit --- site/projects/org-blog.org | 83 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 site/projects/org-blog.org (limited to 'site/projects/org-blog.org') diff --git a/site/projects/org-blog.org b/site/projects/org-blog.org new file mode 100644 index 0000000..251e877 --- /dev/null +++ b/site/projects/org-blog.org @@ -0,0 +1,83 @@ +#+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" -- cgit v1.2.3-54-g00ecf