starter-kit-g-client.org

Starter Kit G-Client

This is part of the Emacs Starter Kit.

G-Client is part of T.V. Raman’s emacspeak package which provides for interaction with Google services (e.g., google-docs, google-calendar) from within Emacs.

Installation

1. Grab the latest version of G-Client by running the following in this directory.

   cd src/
   svn co http://emacspeak.googlecode.com/svn/trunk/lisp/g-client/
       

2. The in the g-client directory run the following commands to build the package.

   cd src/g-client
   make
       

3. Add the g-client directory to the load path, and load the package

   (add-to-list 'load-path
                (expand-file-name
                 "g-client"
                 (expand-file-name
                  "src"
                  (file-name-directory
                   (or load-file-name (buffer-file-name))))))
   (load-library "g")
       

4. Finally, in the current version of g-client one small change to the code is required. In the definition `gdocs-publish-from-org’ the call to the `org-export-region-as-html’ function should be changed from

   (org-export-region-as-html (point-min) (point-max)
                              nil g-scratch-buffer)
       

   to

   (org-export-region-as-html (point-min) (point-max)
                              'body-only g-scratch-buffer)
       

   so that the exported html only includes the body of the html document. The header information generated by Org-mode seems to confuse google documents.

For more information see

• the usage section immediately below
• the file:src/g-client/g-client.org file included with g-client
• and this blog post blog.vivekhaldar.com/editing-google-docs-in-emacs

Usage

Usage is as simple as

1. add g-client to your load path

   (add-to-list 'load-path (expand-file-name
                            "g-client" (expand-file-name "src" starter-kit-dir)))
       

2. load g-client

   (load-library "g")
       

3. sign into google documents with M-x gdocs-sign-in
4. open an Emacs buffer which you would like to post to google docs
5. publish the buffer with `gdocs-publish-from-text’