We-Blog - We Blog our hearts out

                            general information


   Copyright (c) 2011-2012 Ton Kersten
   Copyright (c) 2009-2011 Jaromir Hradilek

   Permission is granted to copy, distribute and/or modify this document
   under the terms of the GNU Free Documentation License, Version 1.3 or
   any later version published by the Free Software Foundation;  with no
   Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.

   A copy  of the license is included  as a file called FDL  in the main
   directory of the We-Blog source package.


ABSTRACT

This document provides a general information about We-Blog 0.5.  For
installation instructions, refer to a file called INSTALL.


TABLE OF CONTENTS

  1. Overview
     1.1. Notable Features
     1.2. Example Usage
  2. Development
  3. Bugs
  4. Copyright


1. OVERVIEW

We-Blog is a simple to use but capable CMS for the command line. Being
written in Perl as a cross-platform application,  and producing static con-
tent without the need of database  servers or server-side scripting,  it is
literally a CMS without  boundaries suitable for a wide variety of web pre-
sentations, from  a personal weblog to a  project page,  or  even a company
website.

1.1 Notable Features

  * Generates valid HTML 4.01 Strict or XHTML 1.1 pages,  and RSS 2.0 feed.
  * Generates yearly and monthly archives, and supports tags.
  * Allows you to create both blog posts and pages.
  * Enables a quick change of theme, style sheet, or localization.
  * Comes with tools for easy management of your blog.

1.2 Example Usage

  $ we-blog-init   # Creates a new repository in .we-blog/
  $ we-blog-add    # Allows you to write a new post in your favorite editor
  $ we-blog-make   # Generates a blog from the repository


2. DEVELOPMENT

As a version control system for its source code, We-Blog uses Git with
a public repository located at gitorious.org. To get the latest development
version, use the following command:

  git clone git://github.com/tonk/we-blog.git we-blog

Alternatively, if you are behind a restrictive firewall,  use the following
command instead:

  git clone http://github.com/tonk/we-blog.git we-blog

If you are planning to make some interesting changes, please, consider clo-
ning the project on Gitorious, so that I can follow you and eventually pull
your work to the upstream.


3. BUGS

To report a bug or to send a patch, please, send an e-mail.


4. COPYRIGHT

Copyright (c) 2011-2012 Ton Kersten
Copyright (c) 2008-2011 Jaromir Hradilek

This program is free software; see the source for copying conditions. It 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 PAR-
TICULAR PURPOSE.

# $Id: README 3 2011-09-22 08:56:33 tonk $