Taoblog is just another lightweight blog system.

1. Flask
2. SQLAlchemy
3. hoedown (super fast markdown parser)
4. rauth (OAuth support)
5. pygments (highlight your code)

Install dependencies:

pip install -r requirements.txt

Run demo locally:

python run.py

Visit localhost:5000 to see what happened.

Most of time, you probably need to do some configuration to meet your requirements. A configuration file can be specified by the environment variable TAOBLOG_CONFIG_PATH, for example:

TAOBLOG_CONFIG_PATH="/absolute/path/to/config_file" python run.py

If you would like to deploy it in the production environment, import application module from the provided taoblog package, and pass it to any WSGI server. See http://flask.pocoo.org/docs/deploying/ for more details.

Keep it complex and secret.

For example:

SECRET_KEY = u'永远是个密秘'.encode('utf-8')

Your server name, a string of pattern address:port. It must be set to your actual server name in the production environment.

For example:

server_name = 'example.com' # default port 80

If True, it will render debug information when you get exceptions.

If True, it will log all statements to your console.

See: http://docs.sqlalchemy.org/en/rel_0_8/core/engines.html#database-urls

For example:

DATABASE_URI = 'sqlite:////path/to/your/taoblog.db'

It can be a single email string or a list of email string, or a single *, which means all registered users can be admin.

For example:

ADMIN_EMAIL = 'your@email.com'
ADMIN_EMAIL = '*'        ## WARN: it means EVERY registered users can manage your blog
ADMIN_EMAIL = ['jerry@email.com', 'tom@gmail.com']

Your Google analytics ID. If provided, the Google Analytics code will be embedded in your pages.

For example:

GOOGLE_ANALYTICS_ID = 'UA-35730532-1'

How many posts you want to show per page.

A tuple stores your consumer info.

For example:

## facebook consumer pairs
FACEBOOK_CONSUMER = ('XXXXX', 'XXXXXX')

Taoblog is under the MIT License. See LICENSE file for full license text.