Skip to content

Latest commit

 

History

History
95 lines (66 loc) · 2.71 KB

README.rst

File metadata and controls

95 lines (66 loc) · 2.71 KB

Gitblogger

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

What it is, yo?

Gitblogger lets you write blog entries in reStructuredText (RST) and posts (or updates) them automatically to a Blogger blog when you push them to a repository. The work flow looks like this:

[working copy] -[push]-> [remote repository] -[GitBlogger]-> [Blogger]

The code is a little rough around the edges, but it seems to work.

And why would you want to do that?

Maybe you don't? I don't know.

I don't think that anyone should have to write HTML, and RST is my preferred lightweight markup language. I'm also a fan of version control in general and git in particular. I like being able to track my changes over time, I like using a real editor on my posts, and I like having things happen with the smallest amount of manual intervention possible.

Requirements

Requirements that should be installed automatically if you use easy_install

Requirements that you will need to provide manually

Installation

  1. Install gdata library.
  2. Install gitblogger:

    python setup.py install
  3. Add gitblogger-post-receive as the post-receive hook to a git repository that receives pushes from your working tree.

Configuration

You need to provide credentials for authenticating to Google, the name of your blog, and the refs gitblogger should be watching. Add a [gitblogger] section to your .git/config configuration file.

For example:

[gitblogger]

username  = you@gmail.com
password  = secret
blog      = Your Blog Title