mspiegle / blogpost Goto Github PK

blogpost README
===============
:Author: Stuart Rackham


*Updated*: 2012-12-31 +
*Updated*: 2010-10-28 +
*Updated*: 2010-02-17 +
*Published*: 2008-05-16

'blogpost' is a Wordpress command-line weblog client.  It creates and
updates weblog entries directly from
http://www.methods.co.nz/asciidoc/[AsciiDoc] (or HTML) source
documents. You can also delete and list weblog entries from the
command-line.

- Manages WordPress Posts and Pages.
- Automatically uploads media files (images, video, audio).
- Only posts new or modified media files.

This 'blogpost' command creates a blogpost containing images from an
AsciiDoc text file:

---------------------------------------------------------------------
$ blogpost.py post blogpost_media_processing.txt

uploading: /home/srackham/doc/blogs/smallnew.png...
url: http://srackham.files.wordpress.com/2008/05/smallnew.png
uploading: /home/srackham/doc/blogs/tiger.png...
url: http://srackham.files.wordpress.com/2008/05/tiger1.png
creating published post 'blogpost media processing'...
id: 93
url: http://srackham.wordpress.com/2008/05/22/blogpost-media-processing/
---------------------------------------------------------------------


Status
------
Latest version in http://code.google.com/p/blogpost/[Mercurial
repository at Google Code].

See also the http://srackham.wordpress.com/blogpost1/[blogpost(1) man
page].

Current version tested under:

- Xubuntu 12.04
- Python 2.7.3

'blogpost' uses Michele Ferretti’s
http://www.blackbirdblog.it/programmazione/progetti/28[Python
Wordpress library] and comes with a patched version of the
`wordpreslib.py` library module (the patch added WordPress 'Page'
XML-RPC methods).


Prerequisites
-------------
- Python 2.5 or better (has not been tried with earlier versions).
- http://www.methods.co.nz/asciidoc/[AsciiDoc] (unless you only plan
  to source raw HTML documents).


Installation
------------
- Clone the http://code.google.com/p/blogpost/[Mercurial repository at
  Google Code] to your local machine.
- Put `blogpost.py` in search path (optional).
- Install the Wordpress backend plugin:

  asciidoc --backend install ./conf/wordpress.zip

- Create `$HOME/.blogpost` configuration file (see example
  `conf/blogpost_example.conf`).
- Disable 'emoticons' from the Wordpress browser interface (optional):
  1. Login.
  2. Navigate to 'Settings->Writing->Writing Settings' page.
  3. Uncheck 'Convert emoticons' in the 'Formatting' section (this
     option stops the automatic conversion of text patterns to
     emoticons).

[NOTE]
=====================================================================
As of AsciiDoc 8.6.9 the 'wordpress' backend conf file
`wordpress.conf` is no longer included in the AsciiDoc distribution --
it's included here in the blogpost distribution as a backend plugin
(`conf/wordpress.zip`).

=====================================================================


Bugs
----
- Under some circumstances WordPress converts three periods to an
  elipsis character and double dashes to the em dashes, there doesn't
  seem to be a way to turn this off.
- WordPress does not appear to recognise list numbering styles and all
  numbered lists are rendered with decimal numbering (WordPress
  default theme).
- WordPress nested unordered lists all have the same bullet style
  (WordPress default theme).
- Large posts can result in blank WordPress pages (I experienced this
  posting the AsciiDoc User Guide which is over five thousand lines
  long). The problem seems to be with WordPress:
  http://www.undermyhat.org/blog/2009/07/sudden-empty-blank-page-for-large-posts-with-wordpress/