From 7fd74f85bc402e12547f15924835a4caf141ed0f Mon Sep 17 00:00:00 2001 From: "Tom Breton (Tehom)" Date: Mon, 10 Jan 2011 14:05:38 -0500 Subject: [PATCH] Updated README.org --- README.org | 106 +++++++++++++++++++++++++++++-------------------------------- 1 file changed, 50 insertions(+), 56 deletions(-) diff --git a/README.org b/README.org index 6f5a731..9b34b6e 100644 --- a/README.org +++ b/README.org @@ -1,8 +1,8 @@ -* Readme for org2blog +* Readme for org2blog/atom ** Headers *** Purpose -To contain user docs for org2blog +To contain user docs for org2blog/atom *** State @@ -11,82 +11,77 @@ An elisp package that lets you post from org-mode to Blogger and other blogs that use the Atom API Entry points are: - * org2blog-post - * org2blog-dir-add-new-photos - -** How to use org2blog :userdoc: - * Install it - * Install its dependencies - * Install org-mode - * Install g-client - * This will require - * org-mode - * xsltproc (Or customize for another XSLT processor) - * curl - * Install persist - * Install org2blog itself - * If you use `my-site-start.el', you can just symlink - "subdirs.el" into your ~/.emacs.d/site-start.d/. Give it a - name like 30org2blog.el - * Failing that, have your .emacs load "subdirs.el". Be sure to - tell it the path, because load-path won't be set up yet. - * Apply the diff to g-client - * for-org-html.el should load later than org so that it can - override certain definitions. This tends to happen automatically - since you will be in org mode before you use org2blog. - - This is temporary until I push the changes to org. The - alternative was to have you patch org until I pushed them. - - * Alternatively, you can apply the patch to org-mode + * org2blog/atom-post + * org2blog/atom-dir-add-new-photos + + +** How to install it + + * Install its dependencies + * Install org-mode + * Install g-client + * This will require + * org-mode + * xsltproc (Or customize for another XSLT processor) + * curl + * Install tinydb + + * Install org2blog/atom itself + * If you have elinstall, just load do-elinstall.el (It's a + script) It will install. + * If you use `my-site-start.el', you can just symlink + "loaddefs.el" into your ~/.emacs.d/site-start.d/. Give it a + name like 30org2blog/atom.el + * Failing that, have your .emacs load "subdirs.el". Be sure to + tell it the path, because load-path won't be set up yet. + * If you don't have the patched g-client, apply the diff to g-client * Configure it. This is still fluid; g-client always was a little obscure to - configure and I'm slowly making it more automatic. + configure. I've made it more automatic, but it could still be + easier. - * Configure gblogger - * This is AUTOMATED now. You need merely call gblogger-blog - before posting. * Optionally, customize `g-user-auth-function' - * It works nicely with my library "password.el", just set it to - `org2blog-password-get-uid+pass' in "org2blog/password.el" + * If you have my library "password.el" + * customize `g-user-auth-function' to + : org2blog/atom-password-get-uid+pass + * Call + : M-x tehom-password-create + and point it towards your Blogger account (or any other blog + host that uses Atom API) + * For other password libraries, you may have to write some code to make them work together. - * Configure gphoto if you want to upload images - * This is AUTOMATED now. Just call gphoto-feeds first. - * It will set up a list of albums. - * You can also customize `org2blog-l2r-alist-file' but you don't + * Otherwise, it will + * You can also customize `org2blog/atom-l2r-alist-file' but you don't need to. * The default may require ~/.emacs.d/ to exist, I forget, but it probably already exists. - * Have a Blogger account - - * At any point before posting, - - : M-x gblogger-blog - That will give a parse error - T V tells me it's missing an - external entity - but it will set up the blog posting url for your - blog. +** How to use org2blog/atom :userdoc: + * Have an account on the blog * Write a blog post as an org file - * You can use the file option "#+BLOGLABELS:" to set labels for the - blog post. + * You can use the usual org export file properties, such as #+AUTHOR: + and #+TITLE: + * You can use the file property "#+BLOGLABELS:" to set labels for + the blog post. * In that org buffer, command: - : M-x org2blog-post + : M-x org2blog/atom-post * That will put you in a gclient gblogger buffer with the post all set up. It should be ready to go, but you can inspect it anyways. - * When you're satisfied, C-c C-c. + * When you're satisfied, + : C-c C-c * It will post to blogger without further intervention. * It will capture a mapping from the local filename to the remote URL, so if you make other posts that link to it (the local file), they will point correctly to it (the url of the respective blog post) - * The same works for photos, as long as org2blog is loaded when + * The same works for photos, as long as org2blog/atom is loaded when they are uploaded. ** Changes to g-client @@ -152,6 +147,5 @@ Entry points are: * "Requires a different version of org-mode. See README.org" - * You're using a version of org-mode that doesn't provide link - conversion. Right now the only solution is to apply the org-mode - patch bundled with org2blog. + * You're using an old version of org-mode. It's probably best to + just upgrade. -- 2.11.4.GIT