SGBlog -- Git-based CGI blogging engine
                =======================================

DESCRIPTION

SGBlog is a simple blogging engine with a Git-based storage and CGI
interface with HTTP-server. It can be used as a cgit replacement for
readonly Git repository viewing and Atom feed generation. But it has
better features:

* URLs are tried to be converted to clickable links
* SHA1 hashes are tried to be converted to blog links itself
* Relative <link rel> links are included for easy navigation
* Each page has ETag and it is checked against the request for client-side
  caching
* Pages can be gzip-compressed, depending on Accept-Encoding header

CONFIGURATION

SGBlog is configured via environment variables:
* SGBLOG_GIT_PATH points to .git directory you want to serve
* SGBLOG_BRANCH points to the branch in it (refs/heads/master for example)
* SGBLOG_BASE_URL points to full URL before the possible SGBLOG_URL_PREFIX
* SGBLOG_TITLE sets the index title
* SGBLOG_ATOM_ID sets Atom feed's id
* SGBLOG_ATOM_AUTHOR sets Atom feed's author name
* If SGBLOG_URL_PREFIX is set, then all link will be prefixed with that URL
* If SGBLOG_CSS is set, then link to that CSS URL will be generated
* If SGBLOG_WEBMASTER is set, then "made" link well be generated
* If SGBLOG_ABOUT is set, then about link is generated at the bottom
* If SGBLOG_GIT_URLS is set, then links to that vcs-git space-separated
  URLs will be generated

Example lighttpd's configuration:

    setenv.add-environment = (
        "SGBLOG_GIT_PATH" => "/home/git/pub/stargrave-blog.git",
        "SGBLOG_BRANCH" => "refs/heads/russian",
        "SGBLOG_BASE_URL" => "http://blog.stargrave.org",
        "SGBLOG_TITLE" => "Russian Stargrave's blog",
        "SGBLOG_ATOM_ID" => "urn:uuid:e803a056-1147-44d4-9332-5190cb78cc3d",
        "SGBLOG_ATOM_AUTHOR" => "Sergey Matveev",
        "SGBLOG_URL_PREFIX" => "/russian",
        "SGBLOG_WEBMASTER" => "webmaster@stargrave.org",
        "SGBLOG_CSS" => "http://blog.stargrave.org/style.css",
        "SGBLOG_GIT_URLS" => "git://git.stargrave.org/stargrave-blog.git https://git.stargrave.org/git/stargrave-blog.git",
        "SGBLOG_ABOUT" => "http://blog.stargrave.org/",
    )

LICENCE

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, version 3 of the License.

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.