Blogger Backend for AsciiDoc
The backend consists of a single blogger.conf configuration file.
To install the Blogger plugin download blogger.zip and install it with
asciidoc (you will need AsciiDoc version 8.6.6 or newer):
asciidoc --backend install blogger.zip
HTML generated by the blogger backend can be pasted directly into your Blogger post’s HTML edit box:
Login and create a new post or edit an existing one.
Select the HTML edit option.
Convert your post’s AsciiDoc source to Blogger friendly HTML. For example, this command converts the article.txt source file to
asciidoc -b blogger -a iconsdir=./icons article.txt
Open the generated HTML file in a text editor then select and copy all the text (typically with Ctrl+A then Ctrl+C).
Paste the copied text into the Blogger edit window in the browser:
NOTE: Specifying the location of the admonition icons by setting the iconsdir attribute has been rendered unnecessary by a commit made on 11-September-2012.
Here’s a partial screenshot of the post (you can view the example post here):
- By default linked images and admonition icons will be embedded in the generated HTML using the data URI scheme (AsciiDoc data-uri and icons attributes are set in the plugin’s
- Older browsers (notably IE8) limit the size of data URIs.
- You will need AsciiDoc version 8.6.6 or newer to use the Blogger backend.
- Defining the backend atom attribute will envelope the post in an Atom
<entry>element for the Blogger 2.0 API – this feature is experimental and I never got round to trying it. See also Post on Blogger using curl.