Set up Blogger-based documentation

blogger-setup.md

Google CL

Install the googlecl tool with

$ sudo pip install googlecl

The command is called google

Blogger

Available tasks for service blogger: post, tag, list, delete

post: Post content. Requires: src AND blog Optional: title, tags, access

tag: Label posts Requires: blog AND title AND tags

list: List posts in a blog Requires: fields AND blog AND delimiter Optional: title, owner

delete: Delete a post. Requires: blog AND title

Markdown

1. Write your posts in a text editing program on your computer and save them on your computer.
2. Copy and paste the text into the online Markdown processor and click Convert to generate HTML. (Set "Filter" to "both" for extra typographic goodness.)
3. Finally, copy and paste the HTML into a new post in Blogspot.

Blogger Settings

1. In Blogspot, go to Settings tab, then the Formatting section. Set Convert Line Breaks to No.
2. In your New Posts,
3. Make sure you are using the Edit HTML tab
4. Under “Post Options” (at the bottom) make sure * Edit HTML Line Breaks is set to Use <br /> tags * Compose Settings is set to Interpret typed HTML

Now you can paste in your Markdown-generated HTML without getting extra linebreaks or other wierdnesses.