Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mimiz/blogpost

Automatically exported from code.google.com/p/blogpost
https://github.com/mimiz/blogpost

Last synced: 1 day ago
JSON representation

Automatically exported from code.google.com/p/blogpost

Awesome Lists containing this project

README

        

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/