Configuration
=============

If you wanna personalize your blog function or looking style, you'd better to read this documentation precisely.

General Configuration
---------------------

In the root of your blog directory, a config.yml is created to configure your blog in a global use.

A example of the config.yml::

    # All of them are required
    title: My blog
    subtitle: A blog powered by hazel
    domain: blog.example.com
    author: Myself
    email: me@example.com
    template: hazel
    #rsync
    host: 12.345.678.999
    user: username
    dest: /path/blog

Template Configuration
----------------------

To personalize your blog style, template configuration is easily handled.

Example::

    # All of them are optional
    index_post: 3
    date_format: '%B %d, %Y'
    analytics:
    twitter:

Rather than the restrict standard of the general config file, template configuration is more flexible and you can define your own configurations for global use.

Nginx Configuration
-------------------

Since hazel is a static blog generator, you don't need a web framework like tornado or flask. With a little configuration of nginx, your blog site will be extremely fastened::

    server {
        listen 80;
        server_name blog.example.com;

        root /path/to/site;
        index index.html;

        access_log /path/to/logs/access.log;
        error_log /path/to/logs/error.log;

        error_page   404   /404.html;

        if ( $request_uri ~ "/index.html" ) {
            rewrite ^ /$1 permanent;
        }

        location / {
            try_files $uri.html $uri $uri/ =404;
        }
    }

BTW, don't forget to create the 'logs' directory!